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 添加到新项目或现有项目,请按以下步骤操作:
-
打开 Xcode
project
或workspace
,然后转到 File >添加软件包依赖项。 - 输入 https://github.com/googlemaps/ios-maps-sdk 作为网址,然后按 Enter 键 以提取软件包,然后点击“Add Package”(添加软件包)。
-
如需安装特定的
version
,请将 Dependency Rule 字段设置为以下其中一项: 基于版本的选项对于新项目,我们建议您指定最新版本和 使用“确切版本”选项。完成后,点击“添加软件包”。 -
在 Choose Package Products(选择软件包产品)窗口中,验证
GoogleMaps
(对于 9.0.0 之前的版本,请验证GoogleMaps
、GoogleMapsBase
和GoogleMapsCore
)将添加到 您指定的main
目标。完成后,点击“添加软件包”。 -
如需验证您的安装,请前往目标的
General
窗格。 在框架、库和嵌入式内容中,您应该会看到已安装的软件包。 您还可以查看“Package Dependencies”“Project Navigator”部分 以验证软件包及其版本。
如需更新现有项目的 package
,请按以下步骤操作:
如果您要从 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 之前的版本进行的升级)
- 在 Xcode 中,转到“File”(文件)>文件包 >更新到最新的软件包版本”。
- 如需验证安装,请前往 Project Navigator 的 Package Dependencies 部分 以验证软件包及其版本。
如需移除使用以下代码添加的现有 Maps SDK for iOS 依赖项
CocoaPods
,请按以下步骤操作:
- 关闭 Xcode 工作区。打开终端并执行以下命令:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
移除
Podfile
、Podfile.resolved
和 Xcodeworkspace
(如果您不将其用于除 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
,请按以下步骤操作:
如果您要从 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 之前的版本进行的升级)
- 在 Xcode 中,转到“File”(文件)>文件包 >更新到最新的软件包版本”。
- 如需验证安装,请前往 Project Navigator 的 Package Dependencies 部分 以验证软件包及其版本。
Cocoapods
手动安装
获取最新源文件的链接 到这里就结束了
除了可以轮询更新的版本之外,Google Cloud 项目 所有者会收到相关电子邮件,了解可能会影响其项目的向后不兼容性更改。接收者 获得关于向后不兼容性更改的主动通知 分配 所有者角色,并在其中加入您每个项目的受监控电子邮件地址。