设置和演示

选择平台： Android iOS

本页面介绍如何为 Maps SDK for iOS 设置 实用程序库 。

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

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

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

使用 Swift Package Manager

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

向您的应用添加 API 密钥

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

构建并运行项目

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

在应用中使用实用程序

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

安装并运行演示版应用

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

安装演示版应用：

使用 GitHub 中的文件

  1. 从 GitHub 下载代码示例归档文件，然后解压缩该归档文件。或者，将代码库克隆到本地目录： 
    git clone https://github.com/googlemaps/google-maps-ios-utils.git
  2. 打开终端窗口，导航到您展开示例文件的目录，然后 深入到您要使用的语言的相应示例目录：

    Swift

    cd google-maps-ios-utils/samples/SwiftDemoApp
open SwiftDemoApp.xcodeproj

    Objective-C

    cd google-maps-ios-utils/samples/ObjCDemoApp
open 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 版本，以试用每个实用程序。 如需了解详情，请参阅下面的向应用添加实用程序部分。