開始使用

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

步驟 1：取得最新版 Xcode

如要使用適用於 iOS 的 Google Nearby Messages API 建構專案，您需要 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 開發新手，請建立 Single View Application，並確認已開啟「Use Automatic Reference Counting」)。
  • 在專案目錄中建立名為 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，以及這些 API 可能有的任何依附元件。

    $ pod install

  • 關閉 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 Bridging Header」部分。
  8. 在「Debug」和「Release」下方，新增您建立的標頭檔案路徑。
  9. 建構專案，讓變更生效。

步驟 5：取得 Google 帳戶

如要使用 Nearby Messages API，您必須擁有 Google 帳戶。 如果您已經有帳戶，則您已準備好了。您可能也想要另外有個測試用的 Google 帳戶。

步驟 6：取得 API 金鑰

請按照下列步驟，為 iOS 啟用 Google Nearby Messages API 並取得 API 金鑰：

  1. 前往 Google Developers Console。
  2. 建立或選取要註冊應用程式的專案。
  3. 點選「繼續」啟用 API。
  4. 在「憑證」頁面上，建立新的 iOS 金鑰 (並設定 API 憑證)。
    注意：如果您目前有 iOS 金鑰，可以使用該金鑰。
  5. 在隨即顯示的對話方塊中，輸入應用程式的軟體包 ID。例如：
    com.example.nearbyexample
  6. 專案的 API 金鑰清單中會顯示新的 iOS 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")