此页面由 Cloud Translation API 翻译。

开始使用

本文档介绍了如何在 Android 设备上开始使用 Nearby Messages API iOS 版。

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

若要使用 iOS 版 Google Nearby Messages API 构建项目，您需要 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 所需的 Pod 名称 iOS：
```
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '7.0'
pod 'NearbyMessages'
```
保存 Podfile。
打开终端并转到包含 Podfile 的目录：

$ cd
运行 pod install 命令。这会安装 Podspec 及其可能具有的任何依赖项。

Pod 安装费用
关闭 Xcode，然后打开（双击）您项目的 .xcworkspace 文件启动 Xcode。从现在开始，您必须使用 .xcworkspace 文件打开项目。

如果您使用 Swift 创建项目，则必须将桥接标头添加到以便它可以使用通过 pod 文件安装的库。请按照以下步骤添加桥接标头：

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

若要使用 Nearby Messages API，您需要拥有一个 Google 账号。如果您已有账号，那么就大功告成了。您可能还希望单独的 Google 账号进行测试。

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

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

。

通过消息管理器对象，您可以发布和订阅。消息交换状态为因此您必须提供上操作。

#import <GNSMessages.h>

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

let messageManager = GNSMessageManager(APIKey: "API_KEY")