本页介绍了如何设置 实用程序库 （适用于 Maps SDK for iOS）。
如需试用这些实用程序，您可以执行以下任一操作：
- 将实用程序库安装到现有的 Xcode 项目中。在您自己的项目中添加这些实用程序。
- 安装并运行演示版应用。此演示版应用是一个独立的项目，包含试用实用程序所需的所有代码。
将 Maps SDK for iOS 实用程序库添加到 Xcode 项目
按照下面的步骤操作，将实用程序库添加到您的 Xcode 工作区中：
使用 Swift Package Manager
- 如果您还没有 Xcode 项目，请立即创建一个并将其保存到您的本地计算机。 （如果您刚开始接触 iOS 开发，请创建一个新项目，然后选择 iOS App 模板。在 Xcode 11.7 或更低版本中，创建一个 Single View Application（单视图应用）。
- 以依赖项形式添加 Maps SDK for iOS。请参阅 安装 SDK。
- 在您的 Xcode 项目中，转到 File（文件）->Swift 软件包 ->添加软件包依赖项。
- 在显示的窗口中，输入 Maps SDK for iOS 实用程序库代码库网址
https://github.com/googlemaps/google-maps-ios-utils，然后选择下一步。 - 此时，系统可能会提示您使用 GitHub 账号进行身份验证。按照 关于如何创建 GitHub 个人访问令牌以继续该过程。
- 在下一个窗口中，选择版本单选选项，然后选择到下一个主要版本 (Up to Next Major Version)。 ，然后输入最新版 Maps SDK for iOS 实用程序库 （例如“6.0.0”）。
- 点击 Add to Project 旁边的下拉菜单，选择您的项目，然后选择 Add Package。
使用 CocoaPods
- 如果您还没有 Xcode 项目，请立即创建一个并将其保存到 本地机器（如果您刚开始接触 iOS 开发，请创建一个 查看应用。）
- 如果您的项目还没有 Pod 文件，请创建一个文件
名为
Podfile的文件。此文件定义了 项目的依赖项 - 修改项目的 Pod 文件，
Google-Maps-iOS-Utils个 Pod。这里有一个 其中包含创建项目所需的依赖项 Maps SDK for iOS 和实用程序库：source 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do use_frameworks! pod 'GoogleMaps', '9.0.0' pod 'Google-Maps-iOS-Utils', '6.0.0' # x-release-please-version end
- 运行
pod install。 - 关闭 Xcode，然后打开（双击）项目的
.xcworkspace文件以启动 Xcode。从现在开始， 必须使用.xcworkspace文件打开项目。
注意：标记聚类实用程序依赖于
四叉树，但您可以使用没有标记聚类的四叉树。如果您想
四叉树实用程序，您可以将
pod 'Google-Maps-iOS-Utils'至
'Google-Maps-iOS-Utils/QuadTree'。
向您的应用添加 API 密钥
请参阅设置 Xcode 项目，了解如何生成 API 密钥并将其添加到您的 Xcode 项目中。构建并运行项目
添加 API 密钥后，构建并运行项目。
在应用中使用实用程序
如需详细了解如何在应用中使用它，请参阅关于每个实用程序的文档：
安装并运行演示版应用
实用程序库包含一个演示版应用，您可以安装此应用，然后对每个实用程序进行试用。
使用以下两种方法之一安装演示版应用：使用 GitHub 中的文件
- 下载 请参阅 GitHub 然后解压缩归档文件
- 打开一个终端窗口，导航到您展开示例文件的目录，然后
深入到您要使用的语言对应的示例目录：
<ph type="x-smartling-placeholder">
- </ph>
- 对于 Swift，请运行
cd google-maps-ios-utils-master/samples/SwiftDemoApp - 对于 Objective-C，请运行
cd google-maps-ios-utils-master/samples/ObjCDemoApp
- 对于 Swift，请运行
- 运行以下命令：
pod install
- 关闭 Xcode，然后打开（双击）项目的
.xcworkspace文件以启动 Xcode。从现在开始， 必须使用.xcworkspace文件打开项目。
使用 CocoaPods v1.6.1
- 打开一个终端窗口并安装版本 1.6.1：
sudo gem install cocoapods -v1.6.1
- 使用 Cocoapods 提取 Google 地图文件：
pod try Google-Maps-iOS-Utils
出现提示时，选择 Swift 或 Objective-C。CocoaPods 会更新规范存储库 然后在名为
SwiftDemoApp.xcodeproj的临时 Xcode 项目中打开演示 或ObjCDemoApp.xcodeproj。
向演示版应用添加 API 密钥
在获取 API 密钥中，您需要生成 您的应用的 API 密钥。现在，将该密钥添加到演示版应用的 Xcode 项目中。Swift
按照以下方法向 AppDelegate.swift 添加 API 密钥：
- 添加以下 import 语句：
import GoogleMaps
- 修改下面这行代码，在双引号之间添加您的 API 密钥：
// Change this key to a valid key registered with the demo app bundle id. let mapsAPIKey = ""
Objective-C
按照以下方法向 AppDelegate.m 添加 API 密钥：
- 添加以下 import 语句：
@import GoogleMaps;
- 修改下面这行代码，在双引号之间添加您的 API 密钥：
// Change this key to a valid key registered with the demo app bundle id. static NSString *const kMapsAPIKey = @"";
构建并运行演示版应用
添加 API 密钥后，构建并运行项目：
- 如果您运行的是 Swift 版本的演示，则可以选择要在应用中查看的实用程序。
- 如果您运行的是 Objective-C 版本的演示，则会看到 标记聚类实用程序。然后，您可以编辑 Objective-C 版演示，以试用每个实用程序。 如需了解详情，请参阅下面的向应用添加实用程序部分。