获取驱动程序 SDK

gcloud

gcloud auth login

CocoaPods

1. 安装 CocoaPods 工具：打开终端窗口并运行以下命令。

   sudo gem install cocoapods
   

   如需了解详情，请参阅 CocoaPods 入门指南。

2. 为 Driver SDK 创建 Podfile：您可以使用 Podfile 安装 API 及其依赖项。

   1. 在项目目录中创建一个名为 Podfile 的文件。此文件用于定义项目的依赖项。

   2. 修改 Podfile 并添加您的依赖项。以下是一个包含依赖项的示例：

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

      下面的示例将 Driver SDK 的 Alpha 版和 Beta 版 pod 作为依赖项：

      source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git"
      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

   3. 保存 Podfile：打开一个终端，然后前往包含 Podfile 的文件夹：

      cd <path-to-project>
      

3. 运行 pod install 命令：此命令会安装 Podfile 中指定的 API 及其可能具有的任何依赖项。

   pod install
   

4. 在 Xcode 中打开项目：关闭 Xcode，然后打开（双击）项目的 .xcworkspace 文件以启动 Xcode。如需稍后打开该项目，请使用 .xcworkspace 文件。

Swift Package Manager

您可以通过 Swift Package Manager 安装 Driver SDK。如需添加该 SDK，请确保您已移除所有现有的 Driver SDK 依赖项。

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

1. 打开 Xcode project 或 workspace，然后依次点击 File（文件）> Add Package Dependencies（添加软件包依赖项）。
2. 输入 https://github.com/googlemaps/ios-driver-sdk 作为网址，按 Enter 键提取软件包，然后点击“Add Package”（添加软件包）。
3. 如需安装特定的 version，请将依赖项规则字段设置为基于版本的选项之一。对于新项目，我们建议您指定最新版本并使用“确切版本”选项。完成后，点击“添加文件包”。

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

1. 如需验证安装情况，请前往 Project Navigator 的 Package Dependencies 部分，验证软件包及其版本。

如需移除手动安装的现有 Driver SDK，请按以下步骤操作：

1. 在 Xcode 项目配置设置中，找到 Frameworks, Libraries, and Embedded Content（框架、库和嵌入内容）。使用减号(-)移除以下框架：

   • GoogleRidesharingDriver.xcframework

2. 从 Xcode 项目的顶级目录中移除 GoogleRidesharingDriver 软件包。

手动安装

本指南介绍了如何向您的项目手动添加包含 Driver SDK 的 XCFramework，以及如何在 Xcode 中配置您的构建设置。

在按照本指南中的说明操作之前，请先执行以下操作：

• 下载 XCFramework，这是一个二进制软件包，用于安装驱动程序 SDK。您可以在多个平台上使用此软件包，包括使用 Apple Silicon 的机器

• 安装 Navigation SDK。

如需手动安装 Driver SDK，请执行以下步骤：

1. 下载 SDK 二进制文件和资源：

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

2. 解压缩 ZIP 文件以访问 XCFramework 和资源。

3. 启动 Xcode，然后打开现有项目或创建新项目。如果您刚开始接触 iOS，请创建一个新项目，然后选择 iOS 应用模板。

4. 如果您的项目组不包含“框架”组，请创建一个。

5. 如需安装 Driver SDK，请将 GoogleRidesharingDriver.xcframework 文件拖动到项目的 Frameworks、Libraries 和 Embedded Content 下。如果系统提示，请选择复制内容。

6. 将下载的 GoogleRidesharingDriver.bundle 拖动到 Xcode 项目的顶层目录中。如果系统提示，请选择复制内容。

7. 从 Project Navigator 中选择您的项目，然后选择应用的目标。

8. 打开 Build Phases（构建阶段）标签页，然后在 Link Binary with Libraries（将二进制文件链接到库）中添加以下框架和库（如果尚未添加）：

   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libxml2.tbd
   • libz.tbd
   • LocalAuthentication.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • WebKit.framework

9. 选择项目（而不是具体目标），然后打开 Build Settings（构建设置）标签页。在“Other Linker Flags”（其他链接器标志）部分中，为调试和发布版本添加 -ObjC。

   如果看不到这些设置，请将“Build Settings”（构建设置）栏中的过滤条件从“Basic”（基本）更改为“All”（全部）。