本文件說明如何開始在 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 檔案安裝的程式庫。請按照下列步驟新增橋接標頭:
- 在與專案
.xcworkspace
檔案相同的目錄中新增標頭檔案 (請隨意命名,並使用「.h」的副檔名)。 - 將下列程式碼貼入您建立的檔案中:
#import <GNSMessages.h>
。 - 儲存檔案。
- 在專案編輯器的左側窗格中,選取主要專案。
- 按一下建構編輯器頂端的「Build Settings」。
- 在「Build Settings」中,前往「Swift Compiler - Code Generation」(在搜尋框中輸入「Swift Compiler」),即可快速找到這個工具。
- 按一下箭頭展開「Objective-C 橋接標題」部分。
- 在「Debug」和「Release」下方,新增您建立的標頭檔案路徑。
- 建立專案,變更才會生效。
步驟 5:取得 Google 帳戶
您必須擁有 Google 帳戶,才能使用 Nearby Messages API。如果您已有帳戶,則已準備就緒。您也可以另外使用一個 Google 帳戶進行測試。
步驟 6:取得 API 金鑰
請按照下列步驟啟用 iOS 版 Google Nearby Messages API 並取得 API 金鑰:
- 前往 Google Developers Console。
- 建立或選取要註冊應用程式的專案。
- 按一下「繼續」即可啟用 API。
- 在「Credentials」(憑證) 頁面上,建立新的「iOS 金鑰」(並設定 API 憑證)。
注意:如果您已有 iOS 鍵,可以使用該金鑰。 - 在結果對話方塊中,輸入應用程式的軟體包 ID。例如:
com.example.nearbyexample
- 新的 iOS API 金鑰會顯示在專案的 API 金鑰清單中。API 金鑰是字元字串,如下所示:
AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
- 為避免配額遭竊,請按照這些最佳做法保護 API 金鑰。
步驟 7:建立訊息管理員物件
訊息管理員物件可讓您發布及訂閱。訊息交換未經過驗證,因此您必須提供在先前步驟中建立的 API 金鑰。
Objective-C
#import <GNSMessages.h>
GNSMessageManager *messageManager =
[[GNSMessageManager alloc] initWithAPIKey:@"API_KEY"];
Swift
let messageManager = GNSMessageManager(APIKey: "API_KEY")