Maps SDK for iOS 版本

选择平台Android iOS JavaScript

Google Maps Platform 团队会定期更新 SDK,以加入新功能、修复 bug 并提升性能。本页面介绍如何管理移动 SDK 的依赖项。

  • 对于任务关键型应用,请链接到您所使用的主要版本的最新次要版本 (X.*),并每年升级到新的主要版本。

    如果您全年发布应用的新版本,则可以使用 Maps SDK for iOS 的较新次要版本。您无需更新应用,因为新的次要版本可向后兼容。

    优势

    • 如果您在 Maps SDK for iOS 中发现了问题,我们会根据移动支持政策在主要版本首次发布后 12 个月内以向后兼容的方式进行修复。您无需紧急升级到不兼容的 SDK 版本即可从修复中受益。
    • 如果您已基于最新版本构建应用,可轻松采用最新的改进和功能。
    • 与处理主要版本的多次发布引入的向后不兼容性更改相比,如果每年对 SDK 的最新主要版本进行增量更新,调整、重写和测试应用所需的工作量会更少。

  • 对于非关键型应用,请链接到任何修复版本。收到该修复版本的弃用通知后,您需要在 12 个月内向用户提供更新后的应用代码。

    优势

    • 降低维护频率。
    • 应用的新版本对搭载旧版移动操作系统的用户设备的支持时间更长(直到您需要升级到新的 SDK 版本时)。

如果项目所有者的电子邮件地址受到监管,他们会在相关更改对自己的每个项目产生影响时收到系统的主动通知。请及时了解重大更新、弃用和其他更改。

安装

请务必在依赖项中指定版本号,而不是使用乐观运算符 (~>),因为这可能会导致不可预测且不可重复的 build。Maps SDK for iOS 遵循语义化版本控制,并且新的主要版本包含破坏性更改。

使用 CocoaPods

使用 Podfile 语法的 Podfile 依赖项示例:

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '13.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '7.3.0'
end

使用 Carthage

使用 Cartfile 语法的 Cartfile 依赖项示例:

binary "https://dl.google.com/geosdk/GoogleMaps.json" == 6.2.1

维护和升级

如需使用最新改进进行构建,请定期检查新版本并更新版本规范。如果您要更新到新的主要版本,请查看版本说明,了解向后不兼容性更改以及代码更新方法。

使用 CocoaPods

  1. 打开终端,然后转到包含 Podfile 的目录:

    cd <path-to-project>
  2. 运行 pod outdated 以查看是否有较新版本的 Maps SDK for iOS。
  3. 如果找到了较新版本的 SDK,请使用此新版本更新您的 Podfile。 如需了解如何在 Podfile 中设置特定版本,请参阅指定 Pod 版本
  4. 运行 pod update
  5. 请根据升级结果进行任何必要的更改。如需查看每个版本中的更改的列表,请参阅版本说明
  6. 依次选择 Product > Clean,然后依次选择 Product > Build,清理并重新构建您的项目

使用 Carthage

  1. 打开终端,然后转到包含 Podfile 的目录:

    cd <path-to-project>
  2. 运行 carthage outdated 以查看是否有较新版本的 Maps SDK for iOS。
  3. 如果找到了较新版本的 SDK,请使用此新版本更新您的 Cartfile。 请参阅版本要求,了解如何在 Cartfile 中设置特定版本。
  4. 运行 carthage update
  5. 请根据升级结果进行任何必要的更改。如需查看每个版本中的更改的列表,请参阅版本说明
  6. 依次选择 Product > Clean,然后依次选择 Product > Build,清理并重新构建您的项目

人工

在安装 SDK 时获取指向最新源文件的链接

除了可以轮询更新的版本之外,Google Cloud 项目所有者还会收到电子邮件,得知可能会影响其项目的向后不兼容性更改。如需获取有关向后不兼容性更改的主动通知,请为您的每个项目分配所有者角色,并提供受监控的电子邮件地址。