在启用结算功能并创建 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 添加到新项目或现有项目中,请按照以下步骤操作:
-
打开 Xcode
project或workspace,然后依次前往 File > Add Package Dependencies(文件 > 添加软件包依赖项)。 - 输入 https://github.com/googlemaps/ios-places-sdk 作为网址,按 Enter 键拉取软件包,然后点击“Add Package”(添加软件包)。
-
如需安装特定
version,请将依赖项规则字段设置为基于版本的选项之一。对于新项目,我们建议指定最新版本并使用“Exact Version”(确切版本)选项。完成后,点击“添加软件包”。 - 在 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 的软件包依赖项部分中移除。 - 如需验证安装,请前往目标的 General(常规)窗格。在 Frameworks, Libraries, and Embedded Content(框架、库和嵌入内容)中,您应该会看到已安装的软件包。您还可以查看 Project Navigator 的 Package Dependencies 部分,以验证软件包及其版本。
如需更新现有项目的 package,请按以下步骤操作:
-
在 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 的软件包依赖项部分中移除。 - 如需验证安装,请前往 Project Navigator 的 Package Dependencies 部分,验证软件包及其版本。
如需移除手动安装的现有 Places SDK for iOS,请按照以下步骤操作:
-
在 Xcode 项目配置设置中,找到 Frameworks, Libraries, and Embedded Content(框架、库和嵌入式内容)。使用减号 (-) 移除以下框架:
GooglePlaces.xcframeworkGooglePlacesSwift.xcframework
-
从 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 或同时添加这两者。
- 下载以下 SDK 二进制文件和资源文件:
- 如果您要安装 Places Swift SDK for iOS,请安装以下文件:
- 解压缩文件以访问 XCFramework 和资源。
- 启动 Xcode,并打开现有的项目或创建新项目。如果您刚开始接触 iOS 开发,请创建一个新项目,然后选择 iOS 应用模板。
- 移除项目中之前版本的任何地图捆绑包。
-
打开常规标签页。将以下 XCFramework 拖放到项目中的 Frameworks, Libraries, and Embedded Content(框架、库和嵌入式内容)下。请务必选择不嵌入:
GooglePlaces.xcframework
GooglePlacesSwift.xcframework
-
将
GooglePlaces.bundle从您下载的 GooglePlacesResources 复制到 Xcode 项目的顶层目录中。请务必在系统提示时选择将内容复制到目标群组的文件夹中。
如果您要安装 Places Swift SDK,请将GooglePlacesSwift.bundle从您下载的 GooglePlacesSwiftResources 复制到 Xcode 项目的顶级目录中。请务必在系统提示时选择将内容复制到目标群组的文件夹中。 - 从 Project Navigator 中选择您的项目,然后选择应用的目标。
-
打开 Build Phases 标签页。在 Link Binary with Libraries(将二进制文件与库关联)中,添加以下框架和库:
CoreGraphics.frameworkCoreLocation.frameworklibc++.tbdlibz.tbdQuartzCore.frameworkUIKit.framework
-
选择您的项目(而非特定目标),然后打开 Build Settings 标签页。在链接 - 常规 -> 其他链接器标志部分中,将
-ObjC添加到“调试”和“发布”。如果这些设置不可见,请将构建设置栏中的过滤条件从基本更改为全部。
第 3 步:向应用添加 API 密钥
在下例中,请将 YOUR_API_KEY 替换为您的 API 密钥。
按照以下方法向 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 的资源包中。如需验证是否已添加隐私清单文件并检查其内容,请创建应用的归档,然后从归档中生成隐私报告。
后续步骤
- 开始编写代码。建议您先实现一个可获取用户当前地点的入门级应用。
- 配置项目后,您可以探索示例应用。
- 使用 App Check 保护 API 密钥。