设置 Xcode 项目

在启用结算功能并创建 API 密钥后,您便可以设置用于开发应用的 Xcode 项目。

每个版本都有版本说明。

第 1 步:安装所需的软件

若要使用 Places SDK for iOS 构建项目,您需要:

  • Xcode 26.0 版或更高版本

第 2 步:创建 Xcode 项目并安装 Places SDK for iOS

Swift Package Manager

Places SDK for iOS 可通过 Swift Package Manager 安装。如需添加该 SDK,请确保您已移除所有现有的 Places SDK for iOS 依赖项。

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

  1. 打开 Xcode project 或 workspace,然后依次前往 File > Add Package Dependencies(文件 > 添加软件包依赖项)。
  2. 输入 https://github.com/googlemaps/ios-places-sdk 作为网址,按 Enter 键拉取软件包,然后点击“Add Package”(添加软件包)。
  3. 如需安装特定 version,请将依赖项规则字段设置为基于版本的选项之一。对于新项目,我们建议指定最新版本并使用“Exact Version”(确切版本)选项。完成后,点击“添加软件包”。
  4. 在 Choose Package Products(选择软件包产品)窗口中,验证 GooglePlaces、GooglePlacesSwift 或两者都将添加到您指定的主要目标。完成后,点击添加软件包。

    如果您要从已弃用的 GitHub 网址更新 Google Places Swift

    重要提示:从 0.3.0 版开始,用于访问 Google Places Swift 的 GitHub 网址已发生变化。如果您要更新通过旧网址 https://github.com/googlemaps/ios-places-swift-sdk 访问的 GooglePlacesSwift 版本,请将其从 Xcode 的软件包依赖项部分中移除。

  5. 如需验证安装,请前往目标的 General(常规)窗格。在 Frameworks, Libraries, and Embedded Content(框架、库和嵌入内容)中,您应该会看到已安装的软件包。您还可以查看 Project Navigator 的 Package Dependencies 部分,以验证软件包及其版本。

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

  1. 在 Xcode 中,依次前往 File > Packages > Update To Latest Package Versions。

    如果您要从已弃用的 GitHub 网址更新 Google Places Swift

    重要提示:从 0.3.0 版开始,用于访问 Google Places Swift 的 GitHub 网址已发生变化。如果您要更新通过旧网址 https://github.com/googlemaps/ios-places-swift-sdk 访问的 GooglePlacesSwift 版本,请将其从 Xcode 的软件包依赖项部分中移除。

  2. 如需验证安装,请前往 Project Navigator 的 Package Dependencies 部分,验证软件包及其版本。

如需移除手动安装的现有 Places SDK for iOS,请按照以下步骤操作:

  1. 在 Xcode 项目配置设置中,找到 Frameworks, Libraries, and Embedded Content(框架、库和嵌入式内容)。使用减号 (-) 移除以下框架:
    • GooglePlaces.xcframework
    • GooglePlacesSwift.xcframework
  2. 从 Xcode 项目的顶层目录中,移除 GooglePlaces 软件包。

手动安装

本指南介绍了如何手动将包含 Places SDK for iOS 和 Places Swift SDK for iOS 的 XCFramework 添加到项目中,以及如何在 Xcode 中配置 build 设置。XCFramework 是一种二进制软件包,可在多个平台上使用,包括使用 Apple 芯片的机器。您可以选择添加 Places SDK for iOS、Places Swift SDK for iOS 或同时添加这两者。

  1. 下载以下 SDK 二进制文件和资源文件:
  2. 如果您要安装 Places Swift SDK for iOS,请安装以下文件:
  3. 解压缩文件以访问 XCFramework 和资源。
  4. 启动 Xcode,并打开现有的项目或创建新项目。如果您刚开始接触 iOS 开发,请创建一个新项目,然后选择 iOS 应用模板。
  5. 移除项目中之前版本的任何地图捆绑包。
  6. 打开常规标签页。将以下 XCFramework 拖放到项目中的 Frameworks, Libraries, and Embedded Content(框架、库和嵌入式内容)下。请务必选择不嵌入:
    • GooglePlaces.xcframework
    如果您要安装 Places Swift SDK,请将以下 XCFramework 拖动到项目中的 Frameworks, Libraries, and Embedded Content(框架、库和嵌入式内容)下。请务必选择不嵌入:
    • GooglePlacesSwift.xcframework
  7. 将 GooglePlaces.bundle 从您下载的 GooglePlacesResources 复制到 Xcode 项目的顶层目录中。请务必在系统提示时选择将内容复制到目标群组的文件夹中。

    如果您要安装 Places Swift SDK,请将 GooglePlacesSwift.bundle 从您下载的 GooglePlacesSwiftResources 复制到 Xcode 项目的顶级目录中。请务必在系统提示时选择将内容复制到目标群组的文件夹中。
  8. 从 Project Navigator 中选择您的项目,然后选择应用的目标。
  9. 打开 Build Phases 标签页。在 Link Binary with Libraries(将二进制文件与库关联)中,添加以下框架和库:
    • CoreGraphics.framework
    • CoreLocation.framework
    • libc++.tbd
    • libz.tbd
    • QuartzCore.framework
    • UIKit.framework
  10. 选择您的项目(而非特定目标),然后打开 Build Settings 标签页。在链接 - 常规 -> 其他链接器标志部分中,将 -ObjC 添加到“调试”和“发布”。如果这些设置不可见,请将构建设置栏中的过滤条件从基本更改为全部。

第 3 步:向应用添加 API 密钥

在下例中,请将 YOUR_API_KEY 替换为您的 API 密钥。

<h3" data-text="12974050100921915444" id="googleplacesswift" tabindex="-1">GooglePlacesSwift</h3">

按照以下方法向 AppDelegate.swift 添加 API 密钥:

  • 添加以下 import 语句:
    import GooglePlacesSwift
  • 将以下内容添加到 application(_:didFinishLaunchingWithOptions:) 方法中,并将 YOUR_API_KEY 替换为您的 API 密钥:
    PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

按照以下方法向 AppDelegate.swift 添加 API 密钥:

  • 添加以下 import 语句:
    import GooglePlaces
  • 将以下内容添加到 application(_:didFinishLaunchingWithOptions:) 方法中,并将 YOUR_API_KEY 替换为您的 API 密钥:
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

  • 添加以下 import 语句:
    @import GooglePlaces;
  • 将以下内容添加到 application:didFinishLaunchingWithOptions: 方法中,并将 YOUR_API_KEY 替换为您的 API 密钥:
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

第 4 步(可选):检查 Apple 隐私清单文件

Apple 要求在应用商店上发布的应用提供应用隐私详细信息。如需了解最新动态和更多信息,请访问 Apple App Store 隐私权详细信息页面。

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

后续步骤