开始使用

本文档介绍了如何开始使用 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 文件安装的库。 请按照以下步骤添加桥接标头：

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

第 5 步：获取 Google 帐号

您必须要有 Google 帐号，才能使用 Nearby Messages API。 如果您已拥有一个帐号，则无需进行任何操作。您也可能出于测试目的而需要单独的 Google 帐号。

第 6 步：获取 API 密钥

请按照下面的步骤启用 iOS 版 Google Nearby Messages API 并获取 API 密钥：

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

第 7 步：创建消息管理器对象

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

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")