获取 iOS Consumer SDK

Swift Package Manager

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

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

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

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

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

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

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

   • GoogleRidesharingConsumer.xcframework

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

使用 CocoaPods

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

   sudo gem install cocoapods
   

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

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

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

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

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

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

      cd <path-to-project>
      

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

   pod install
   

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

手动安装

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

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

• 下载 XCFramework，这是一个二进制软件包，用于安装 Consumer SDK。您可以在多个平台上使用此软件包，包括使用 M1 芯片组的机器。

• 安装 Maps SDK。

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

   • GoogleRidesharingConsumer.xcframework
   • GoogleRidesharingConsumer.bundle
   • gRPCCertificates.bundle

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

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

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

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

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

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

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

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

   • Accelerate.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

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

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