适用于 iOS 版本的驱动程序 SDK

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

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

    在您发布应用的新版本时 ,您都可以开始使用 iOS 版驱动程序 SDK 的较新小点版本。您无需更新应用,因为新的次要版本可向后兼容。

    优势

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

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

    优势

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

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

安装

始终在依赖项中指定版本号,而不是使用 乐观运算符 (~>),因为这可能会导致不可预测和 不可重复的构建适用于 iOS 的驱动程序 SDK 符合 语义版本控制和新的主要版本 包含破坏性更改

CocoaPods

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

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

      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver', '2.0.0'
      end
    

Swift Package Manager

驱动程序 SDK 可通过 进行安装 Swift Package Manager 的相关文档。要添加 SDK,请确保您已 移除了所有现有的驱动程序 SDK 依赖项。

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

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

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

  1. 在 Xcode 中,依次前往“File”(文件)>“Packages”(软件包)>“Update To Latest Package Versions”(更新到最新的软件包版本)。
  2. 如需验证安装,请前往 Project NavigatorPackage Dependencies 部分 以验证软件包及其版本。
。 <ph type="x-smartling-placeholder">

维护和升级

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

Cocoapods

  1. 打开终端并转到包含 Podfile 的目录:

    cd <path-to-project>
  2. 运行 pod outdated 以查看 iOS 版驱动程序 SDK 现已推出。
  3. 如果找到更高版本的 SDK,请使用此新版本更新您的 Podfile。 如需了解如何在 Podfile 中设置特定版本,请参阅指定 pod 版本
  4. 运行 pod update
  5. 请根据升级进行所有必要的更改。请参阅 版本说明,获取每个版本中的更改列表。
  6. 选择 Product >清理 产品 >构建

手动安装

如需获取指向最新源文件的链接,请参阅“安装 SDK”。

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