设置和演示

请选择平台： Android iOS

本页介绍了如何设置 实用程序库 （适用于 Maps SDK for iOS）。

如需试用这些实用程序，您可以执行以下任一操作：

将 Maps SDK for iOS 实用程序库添加到 Xcode 项目

按照下面的步骤操作，将实用程序库添加到您的 Xcode 工作区中：

使用 Swift Package Manager

  1. 如果您还没有 Xcode 项目，请立即创建一个并将其保存到您的本地计算机。 （如果您刚开始接触 iOS 开发，请创建一个新项目，然后选择 iOS App 模板。在 Xcode 11.7 或更低版本中，创建一个 Single View Application（单视图应用）。
  2. 以依赖项形式添加 Maps SDK for iOS。请参阅 安装 SDK。
  3. 在您的 Xcode 项目中，转到 File（文件）->Swift 软件包 ->添加软件包依赖项。
  4. 在显示的窗口中，输入 Maps SDK for iOS 实用程序库代码库网址 https://github.com/googlemaps/google-maps-ios-utils，然后选择下一步。
    • 此时，系统可能会提示您使用 GitHub 账号进行身份验证。按照 关于如何创建 GitHub 个人访问令牌以继续该过程。
  5. 在下一个窗口中，选择版本单选选项，然后选择到下一个主要版本 (Up to Next Major Version)。 ，然后输入最新版 Maps SDK for iOS 实用程序库 （例如“6.0.0”）。
  6. 点击 Add to Project 旁边的下拉菜单，选择您的项目，然后选择 Add Package。

使用 CocoaPods

  1. 如果您还没有 Xcode 项目，请立即创建一个并将其保存到 本地机器（如果您刚开始接触 iOS 开发，请创建一个 查看应用。）
  2. 如果您的项目还没有 Pod 文件，请创建一个文件 （位于项目目录中，名为 Podfile）。此文件定义了 项目的依赖项
  3. 修改项目的 Pod 文件， Google-Maps-iOS-Utils 个 Pod。这里有一个 其中包含创建 YAML 文件所需的依赖项 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
  4. 运行 pod install。
  5. 关闭 Xcode，然后打开（双击）项目的 .xcworkspace 文件以启动 Xcode。从现在开始， 必须使用 .xcworkspace 文件打开项目。

注意：标记聚类实用程序依赖于 四叉树，但您可以使用没有标记聚类的四叉树。如果您想 四叉树实用程序，您可以将 pod 'Google-Maps-iOS-Utils'至 'Google-Maps-iOS-Utils/QuadTree'。

向您的应用添加 API 密钥

请参阅设置 Xcode 项目，了解如何生成 API 密钥并将其添加到您的 Xcode 项目中。

构建并运行项目

添加 API 密钥后，构建并运行项目。

在应用中使用实用程序

如需详细了解如何在应用中使用它，请参阅关于每个实用程序的文档：

安装并运行演示版应用

实用程序库包含一个演示版应用，您可以安装此应用，然后对每个实用程序进行试用。

使用以下两种方法之一安装演示版应用：

使用 GitHub 中的文件

  1. 下载 请参阅 GitHub 然后解压缩归档文件
  2. 打开一个终端窗口，导航到您展开示例文件的目录，然后 深入到您要使用的语言对应的示例目录： <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
  3. 运行以下命令：
    pod install
  4. 关闭 Xcode，然后打开（双击）项目的 .xcworkspace 文件以启动 Xcode。从现在开始， 必须使用 .xcworkspace 文件打开项目。

使用 CocoaPods v1.6.1

  1. 打开一个终端窗口并安装版本 1.6.1： 
    sudo gem install cocoapods -v1.6.1
  2. 使用 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 密钥：

  1. 添加以下 import 语句： 
    import GoogleMaps
  2. 修改下面这行代码，在双引号之间添加您的 API 密钥： 
    // Change this key to a valid key registered with the demo app bundle id.
let mapsAPIKey = ""

Objective-C

按照以下方法向 AppDelegate.m 添加 API 密钥：

  1. 添加以下 import 语句： 
    @import GoogleMaps;
  2. 修改下面这行代码，在双引号之间添加您的 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 版演示，以试用每个实用程序。 如需了解详情，请参阅下面的向应用添加实用程序部分。