開始使用

本文說明如何開始在以下平台使用 Nearby Messages API 進行開發 iOS 裝置。

步驟 1：取得最新版本的 Xcode

如要使用 Google Nearby Messages API for iOS 建立專案，您需要 6.3 版或更新版本的 Xcode。

步驟 2：取得 CocoaPods

iOS 版 Google Nearby Messages API CocoaPods Pod。CocoaPods 是開放原始碼的依附元件 Swift 和 Objective-C Cocoa 專案的主管。

如果您還沒有 CocoaPods 工具，請執行 從終端機執行以下指令詳情請參閱 CocoaPods 取得 入門指南。

$ sudo gem install cocoapods

步驟 3：使用 CocoaPods 安裝 API

為 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 檔案： 開啟專案

步驟 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 金鑰

請按照下列步驟啟用 Google Nearby Messages API iOS 版，並 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")