開始使用

本文件說明如何開始在 iOS 上使用 Nearby Messages API 進行開發。

步驟 1:取得最新版 Xcode

如要使用 Google Nearby Messages API for iOS 建立專案,必須使用 Xcode 6.3 以上版本。

步驟 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 開發新手,請建立單一 View 應用程式,並確認「使用自動參考計數」功能已開啟)。
  • 在專案目錄中建立名為 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 指令。這個動作會安裝 Pod 規格中指定的 API,以及這些 API 可能有的所有依附元件。

    $ Pod 安裝

  • 關閉 Xcode,然後開啟 (按兩下) 專案的 .xcworkspace 檔案來啟動 Xcode。從現在起,您必須使用 .xcworkspace 檔案來開啟專案。

步驟 4:建立橋接標頭 (僅適用於 Swift)

如果您是使用 Swift 建立專案,您必須在專案中新增橋接標頭,才能使用 Pod 檔案安裝的程式庫。請按照下列步驟新增橋接標頭:

  1. 在與專案 .xcworkspace 檔案相同的目錄中新增標頭檔案 (請隨意命名,並使用「.h」的副檔名)。
  2. 將下列程式碼貼入您建立的檔案中: #import <GNSMessages.h>
  3. 儲存檔案。
  4. 在專案編輯器的左側窗格中,選取主要專案。
  5. 按一下建構編輯器頂端的「Build Settings」
  6. 在「Build Settings」中,前往「Swift Compiler - Code Generation」(在搜尋框中輸入「Swift Compiler」),即可快速找到這個工具。
  7. 按一下箭頭展開「Objective-C 橋接標題」部分。
  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. 在「Credentials」(憑證) 頁面上,建立新的「iOS 金鑰」(並設定 API 憑證)。
    注意:如果您已有 iOS 鍵,可以使用該金鑰。
  5. 在結果對話方塊中,輸入應用程式的軟體包 ID。例如:
    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")