如需在您的 iOS 消费者应用中跟踪按需行程,请使用消费者 SDK。如需详细了解关注行程及相关说明,请参阅在 iOS 应用中跟踪行程。
如需为 iOS 消费者应用设置 Consumer SDK,请按以下步骤操作:
查看最低系统要求
请参阅版本说明,了解您所用版本的 Consumer SDK 的最低要求。请参阅版本说明。
- 移动设备必须搭载 iOS 14 或更高版本。
- Apple Xcode 版本 15 或更高版本。
获取使用方 SDK
您可以使用 CocoaPods 安装和配置 Consumer SDK。
Swift Package Manager
您可以通过 Swift Package Manager 安装 Consumer SDK。如需添加该 SDK,请确保您已移除所有现有的 Consumer SDK 依赖项。
如需将 SDK 添加到新项目或现有项目,请按以下步骤操作:
-
打开 Xcode
project
或workspace
,然后依次点击 File(文件)> Add Package Dependencies(添加软件包依赖项)。 - 输入 https://github.com/googlemaps/ios-consumer-sdk 作为网址,按 Enter 键提取软件包,然后点击“添加软件包”。
-
如需安装特定的
version
,请将依赖项规则字段设置为基于版本的选项之一。对于新项目,我们建议您指定最新版本并使用“确切版本”选项。完成后,点击“添加文件包”。
如需更新现有项目的 package
,请按以下步骤操作:
- 如需验证安装情况,请前往 Project Navigator 的 Package Dependencies 部分,验证软件包及其版本。
如需移除手动安装的现有消费者 SDK,请按以下步骤操作:
在您的 Xcode 项目配置设置中,找到框架、库和嵌入式内容。使用减号
(-)
移除以下框架:GoogleRidesharingConsumer.xcframework
从 Xcode 项目的顶级目录中移除
GoogleRidesharingConsumer
软件包。
使用 CocoaPods
安装 CocoaPods 工具:打开终端窗口并运行以下命令:
sudo gem install cocoapods
如需了解详情,请参阅 CocoaPods 入门指南。
为 Consumer SDK 创建 Podfile:您可以使用 Podfile 安装 API 及其依赖项。
在您的项目目录中创建一个名为
Podfile
的文件。此文件定义您项目的依赖项。修改 Podfile 并添加您的依赖项。以下示例包含依赖项:
source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingConsumer' end
保存 Podfile:打开终端并转到包含 Podfile 的文件夹:
cd <path-to-project>
运行 pod install 命令:此命令会安装 Podfile 中指定的 API 及其可能具有的任何依赖项。
pod install
在 Xcode 中打开项目:关闭 Xcode,然后打开(双击)项目的 .xcworkspace 文件以启动 Xcode。如需稍后打开项目,请使用 .xcworkspace 文件。
手动安装
本指南介绍了如何向您的项目手动添加包含 Consumer SDK 的 XCFramework,以及如何在 Xcode 中配置您的构建设置。
在按照本指南中的说明操作之前,请先执行以下操作:
下载 XCFramework,这是一个用于安装使用方 SDK 的二进制软件包。您可以在多个平台上使用此软件包,包括使用 M1 芯片组的机器。
安装 Maps SDK。
下载 SDK 二进制文件和资源:
解压缩压缩文件以访问 XCFramework 和资源。
启动 Xcode,然后打开或创建一个项目。如果您刚开始接触 iOS,请创建一个新项目,然后选择 iOS 应用模板。
如果您的项目组不包含 Frameworks 组,请创建一个。
将下载的
gRPCCertificates.bundle
文件拖动到 Xcode 项目的顶级目录中。如果系统提示,请选择复制内容。如需安装 Consumer SDK,请将
GoogleRidesharingConsumer.xcframework
文件拖动到项目的 Frameworks、Libraries 和 Embedded Content 下。如果系统提示,请选择复制内容。将下载的
GoogleRidesharingConsumer.bundle
拖动到 Xcode 项目的顶级目录中。如果出现提示,请选择复制项目。从 Project Navigator 中选择您的项目,然后选择应用的目标。
打开 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
选择项目(而不是具体目标),然后打开 Build Settings(构建设置)标签页。在“Other Linker Flags”(其他链接器标志)部分中,为调试和发布版本添加
-ObjC
。如果看不到这些设置,请将 Build Settings 栏中的过滤条件从 Basic 更改为 All。
检查 Apple 隐私权清单文件
Apple 要求在 App Store 上架的应用提供应用隐私权详细信息。如需了解最新动态和更多信息,请访问 Apple App Store 隐私权详细信息页面。
Apple 隐私权清单文件包含在 SDK 的资源 bundle 中。如需验证是否已添加隐私权清单文件并检查其内容,请创建应用的归档文件,然后从归档文件生成隐私权报告。