本文档介绍了如何开始使用 iOS 中的 Nearby Messages API 进行开发。
第 1 步:获取最新版本的 Xcode
如需使用 Google Nearby Messages API 构建项目(iOS),您需要 6.3 版或更高版本的 Xcode。
第 2 步:获取 CocoaPods
适用于 iOS 的 Google Nearby Messages API 以 CocoaPods pod 的形式提供。CocoaPods 是一种适用于 Swift 和 Objective-C Cocoa 项目的开源依赖项管理器。
如果您还没有 CocoaPods 工具,请在 OS X 上从终端运行以下命令进行安装。如需了解详情,请参阅 CocoaPods 入门指南。
$ sudo gem install cocoapods
第 3 步:使用 CocoaPods 安装 API
为 iOS 版 Google Nearby Messages API 创建 Podfile
,并使用它来安装 API 及其依赖项。
- 如果您还没有 Xcode 项目,请立即创建一个并将其保存到您的本地机器。(如果您是 iOS 开发新手,请创建一个单视图应用,并确保已启用“使用自动引用计数”。)
- 在您的项目目录中创建一个名为
Podfile
的文件。此文件定义项目的依赖项。 修改
Podfile
并添加您的依赖项。下面是一个简单的 Podspec,包括适用于 iOS 的 Google Nearby Messages API 所需的 pod 名称:source 'https://github.com/CocoaPods/Specs.git' platform :ios, '7.0' pod 'NearbyMessages'
保存
Podfile
。打开终端并转到包含
Podfile
的目录:$ cd
运行
pod install
命令。这将安装 Podspec 中指定的 API 及其可能具有的任何依赖项。Pod 安装
关闭 Xcode,然后打开(双击)您项目的
.xcworkspace
文件以启动 Xcode。从现在起,您必须使用.xcworkspace
文件打开项目。
第 4 步:创建桥接标头(仅限 Swift)
如果您使用 Swift 创建项目,则必须向项目添加桥接标头,以便其可以使用 Pod 文件安装的库。 请按照以下步骤添加桥接标头:
- 在项目的
.xcworkspace
文件所在的同一目录中,添加一个新头文件(您可以随意为其命名,并使用文件扩展名“.h”)。 - 将以下代码粘贴到您创建的文件中:
#import <GNSMessages.h>
。 - 保存文件。
- 在项目编辑器左侧的窗格中,选择主项目。
- 点击 build 编辑器顶部的 Build Settings(构建设置)。
- 在“构建设置”中,导航到“Swift Compiler - Code Generation”(在搜索框中输入“Swift Compiler”以快速找到它)。
- 点击箭头展开 Objective-C Bridging Header 部分。
- 在 Debug 和 Release 下,添加指向您创建的头文件的路径。
- 构建项目以使更改生效。
第 5 步:获取 Google 帐号
您必须要有 Google 帐号,才能使用 Nearby Messages API。 如果您已拥有一个帐号,则无需进行任何操作。您也可能出于测试目的而需要单独的 Google 帐号。
第 6 步:获取 API 密钥
请按照下面的步骤启用 iOS 版 Google Nearby Messages API 并获取 API 密钥:
- 前往 Google Developers Console。
- 创建或选择用于注册应用的项目。
- 点击继续以启用 API。
- 在凭据页面上,创建一个新的 iOS 密钥(并设置 API 凭据)。
注意:如果您已有 iOS 密钥,则可以使用该密钥。 - 在出现的对话框中,输入应用的软件包标识符。例如:
com.example.nearbyexample
。 - 您的新 iOS API 密钥会显示在项目的 API 密钥列表中。API 密钥是一串字符,如下所示:
AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
- 为防止配额盗用,请按照这些最佳实践保护您的 API 密钥。
第 7 步:创建消息管理器对象
通过消息管理器对象,您可以发布和订阅消息。消息交换未经身份验证,因此您必须提供上一步中创建的 API 密钥。
Objective-C
#import <GNSMessages.h>
GNSMessageManager *messageManager =
[[GNSMessageManager alloc] initWithAPIKey:@"API_KEY"];
Swift
let messageManager = GNSMessageManager(APIKey: "API_KEY")