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 版本时）。

如果 Project Owner 拥有受监管的电子邮件地址，则会在出现对自己的每个项目产生影响的更改时收到系统的主动通知。请及时了解重大更新、弃用和其他更改。

安装

Swift Package Manager

可以通过 安装 Maps SDK for iOS Swift Package Manager 的相关文档。要添加 SDK，请确保您已 移除了所有现有的 Maps SDK for iOS 依赖项。

如需将 SDK 添加到新项目或现有项目，请按以下步骤操作：

  1. 打开 Xcode project 或 workspace，然后转到 File >添加软件包依赖项。
  2. 输入 https://github.com/googlemaps/ios-maps-sdk 作为网址，然后按 Enter 键 以提取软件包，然后点击“Add Package”（添加软件包）。
  3. 如需安装特定的 version，请将 Dependency Rule 字段设置为以下其中一项： 基于版本的选项对于新项目，我们建议您指定最新版本和 使用“确切版本”选项。完成后，点击“添加软件包”。
  4. 在 Choose Package Products（选择软件包产品）窗口中，验证 GoogleMaps（对于 9.0.0 之前的版本，请验证 GoogleMaps、GoogleMapsBase和 GoogleMapsCore）将添加到 您指定的main目标。完成后，点击“添加软件包”。
  5. 如需验证安装，请前往目标的 General 窗格。 在框架、库和嵌入式内容中，您应该会看到已安装的软件包。 您还可以查看“Package Dependencies”“Project Navigator”部分 以验证软件包及其版本。

如需更新现有项目的 package，请按以下步骤操作：

  1. 如果您要从 9.0.0 之前的版本升级，就必须移除 以下依赖项：GoogleMapsBase、GoogleMapsCore 和 GoogleMapsM4B。请勿移除 GoogleMaps。有关详情，请参阅 9.0.0 版版本说明。

    在您的 Xcode 项目配置设置中，找到 Frameworks, Libraries, 和嵌入式内容。使用减号(-) 移除以下框架：

    • GoogleMapsBase（仅适用于从 9.0.0 之前版本进行的升级）
    • GoogleMapsCore（仅适用于从 9.0.0 之前版本进行的升级）
    • GoogleMapsM4B（仅适用于从 9.0.0 之前版本进行的升级）
  2. 在 Xcode 中，转到“File”（文件）>文件包 >更新到最新的软件包版本”。
  3. 如需验证安装，请前往 Project Navigator 的 Package Dependencies 部分 以验证软件包及其版本。
。 <ph type="x-smartling-placeholder">

如需移除使用以下代码添加的现有 Maps SDK for iOS 依赖项 CocoaPods，请按以下步骤操作：

  1. 关闭 Xcode 工作区。打开终端并执行以下命令： 
    sudo gem install cocoapods-deintegrate cocoapods-clean 
pod deintegrate 
pod cache clean --all
  2. 移除 Podfile、Podfile.resolved 和 Xcode workspace（如果您不将其用于 CocoaPods 之外的任何其他用途）。

CocoaPods

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

使用 Podfile 语法：

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

platform :ios, '15.0'

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

维护和升级

如需在构建时使用最新的改进功能，请定期检查更新的版本并更新您的版本 。如果您要更新到新的主要版本，请查看 版本说明，了解向后不兼容性更改以及如何更新代码。

Swift Package Manager

如需更新现有项目的 package，请按以下步骤操作：

  1. 在 Xcode 中，转到“File”（文件）>文件包 >更新到最新的软件包版本”。
  2. 如需验证安装，请前往 Project Navigator 的 Package Dependencies 部分 以验证软件包及其版本。
。 <ph type="x-smartling-placeholder">

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 >清理 产品 >构建

手动安装

获取最新源文件的链接 到这里就结束了

除了可以轮询更新的版本之外，Google Cloud 项目 所有者会收到相关电子邮件，了解可能会影响其项目的向后不兼容性更改。接收者 获得关于向后不兼容性更改的主动通知 分配 所有者角色，并在其中加入您每个项目的受监控电子邮件地址。