获取 iOS Consumer SDK

请选择平台: Android iOS JavaScript

要在您的 iOS 个人用户应用中跟踪按需行程,请使用 使用方 SDK。如需详细了解 行程分享功能,请参阅 在 iOS 应用中跟踪行程

如需为您的 iOS 个人用户应用设置消费者 SDK,请按以下步骤操作:

  1. 查看最低系统要求
  2. 获取消费者 SDK
  3. 检查 Apple 隐私清单文件
  4. 配置 Google Cloud 控制台项目
  5. 获取身份验证令牌
  6. 初始化使用方 SDK

查看最低系统要求

请参阅版本说明,了解您所用消费者 SDK 版本的最低要求。请参阅版本说明

  • 移动设备必须搭载 iOS 14 或更高版本。
  • Apple Xcode 版本 15 或更高版本。

获取使用方 SDK

您可以使用 CocoaPods 安装和配置 Consumer SDK。

Swift Package Manager

消费者 SDK 可通过 Swift Package Manager 的相关文档。如需添加该 SDK,请确保您已移除所有现有的 Consumer SDK 依赖项。

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

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

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

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

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

  1. 在您的 Xcode 项目配置设置中,找到 Frameworks, 库和嵌入式内容。使用减号(-)移除 以下框架:

    • 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 文件。

手动安装

本指南介绍如何手动添加包含 使用方 SDK 添加到您的项目,并在 Xcode 中配置您的构建设置。

在按照本指南进行操作之前,请执行以下操作:

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

  • 安装 Maps SDK

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

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

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

  4. 如果您的项目组不包含 Frameworks 组,请创建一个。

  5. 将下载的 gRPCCertificates.bundle 文件拖动到顶层 目录中。如果出现提示,请选择复制项目

  6. 如需安装消费者 SDK,请拖动 GoogleRidesharingConsumer.xcframework 文件复制到位于以下位置的项目中: 框架、库和嵌入式内容。如果系统提示,请选择 复制内容

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

  8. 从项目导航器中选择您的项目,然后选择 应用的目标

  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”(全部)。

检查 Apple 隐私权清单文件

Apple 要求为 App Store 中的应用提供应用隐私权详细信息。如需了解最新动态和更多信息,请访问 Apple App Store 隐私权详情页面

Apple 隐私清单文件包含在 SDK 的资源包中。如需验证隐私清单文件是否包含在内,并检查其内容,请创建应用的归档,并从归档中生成隐私报告

后续步骤

配置 Google Cloud 控制台项目