此页面由 Cloud Translation API 翻译。

开始使用

本文档介绍了如何开始在 iOS 上使用 Nearby Messages API 进行开发。

第 1 步：获取最新版本的 Xcode

如需使用 Google Nearby Messages API（iOS 版）构建项目，您需要 6.3 版或更高版本的 Xcode。

iOS 版 Google Nearby Messages API 以 CocoaPods pod 的形式提供。CocoaPods 是一种用于 Swift 和 Objective-C Cocoa 项目的开源依赖项管理器。

如果您尚未安装 CocoaPods 工具，请在 OS X 上从终端运行以下命令进行安装。如需了解详情，请参阅 CocoaPods 入门指南。

$ sudo gem install cocoapods

为 iOS 的 Google Nearby Messages API 创建 Podfile，并使用它来安装 API 及其依赖项。

如果您还没有 Xcode 项目，请立即创建一个并将其保存到您的本地机器。（如果您刚开始接触 iOS 开发，请创建单视图应用，并确保已开启“使用自动引用计数”。）
在您的项目目录中创建一个名为 Podfile 的文件。此文件定义项目的依赖项。
修改 Podfile 并添加您的依赖项。以下是一个简单的 Podspec，其中包括 Google Nearby Messages API（iOS 版）所需的 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 文件打开项目。

如果您使用 Swift 创建项目，则必须向项目添加桥接标头，以便它可以使用 Pod 文件安装的库。若要添加桥接标头，请按以下步骤操作：

在项目的 .xcworkspace 文件所在的目录中，添加新的头文件（您可以随意为其命名，并使用文件扩展名“.h”）。
将以下代码粘贴到您创建的文件中：#import <GNSMessages.h>。
保存文件。
在项目编辑器的左侧窗格中，选择主项目。
点击 build 编辑器顶部的 Build Settings（构建设置）。
在“构建设置”中，转到“Swift Compiler - Code Generation”（在搜索框中输入“Swift Compiler”以快速找到该代码库）。
点击箭头以展开 Objective-C Bridging Header 部分。
在 Debug 和 Release 下，添加指向您创建的头文件的路径。
构建项目以使更改生效。

如需使用 Nearby Messages API，您需要拥有一个 Google 帐号。如果您已有帐号，则一切就绪。您可能还需要一个单独的 Google 帐号，用于测试目的。

请按以下步骤启用 Google Nearby Messages API（iOS 版），并获取 API 密钥：

转到 Google Developers Console。
创建或选择用于注册应用的项目。
点击继续以启用 API。
在凭据页面上，创建一个新的 iOS 密钥（并设置 API 凭据）。
注意：如果您已有 iOS 密钥，则可以使用该密钥。
在出现的对话框中，输入应用的软件包标识符。例如：
```
com.example.nearbyexample
```
。
您的新 iOS API 密钥会显示在项目的 API 密钥列表中。API 密钥是一串字符，如下所示：
```
AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
```
为了防止配额盗用，请按照这些最佳做法保护您的 API 密钥。

通过消息管理器对象，您可以发布和订阅。消息交换未通过身份验证，因此您必须提供上一步中创建的 API 密钥。

#import <GNSMessages.h>

GNSMessageManager *messageManager =
    [[GNSMessageManager alloc] initWithAPIKey:@"API_KEY"];

let messageManager = GNSMessageManager(APIKey: "API_KEY")