事前準備
本開發人員指南說明如何在 Android 上使用 Google Play 編譯及執行 C++ 遊戲 Game Services API。開始之前,請先下載並設定下列需求條件:
- Android NDK,修訂版本 14 或以上。
- Android SDK v10 以上版本和 Eclipse ADT 的最新版本。
- 裝置必須搭載 Android 4.0 (API 級別 14) 以上版本。
- 最新版的 Google Play 服務 SDK。
本開發人員指南使用 Android Native Development Kit (NDK)。如果您不熟悉 NDK, 請參閱 NDK 說明文件和範例 才能繼續。
步驟 1:設定環境
- 下載 Android SDK 和 Android NDK,並解壓縮到電腦。在您的
環境,將
SDK_ROOT
設為 Android SDK 資料夾的位置,並將NDK_ROOT
設為 Android NDK 資料夾的位置。 - 下載 C++ 範例遊戲。這個
開發人員指南將機器上的樣本位置稱為
SAMPLES_DIR
。 - 下載 Google Play 遊戲服務 C++ SDK。擷取
安裝至開發機器在環境中,將變數
NDK_MODULE_PATH
設為 指向gpg-cpp-sdk
目錄「上方」的目錄。備妥下列物品 目錄結構:NDK_MODULE_PATH/ gpg-cpp-sdk/
- 開啟 Eclipse。如果您尚未告知 Eclipse 您安裝 NDK by 按一下 [偏好設定] > Android >NDK。
將 Google Play 服務程式庫專案匯入 Eclipse 工作區。
- 在 Eclipse 中,按一下 檔案 >匯入 >Android >將現有 Android 程式碼插入 Workspace。
- 選取「
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
」 其中SDK_ROOT
是 Android SDK 的位置。 - 按一下 [完成]。
將極簡範例專案匯入 Eclipse 工作區。
- 在 Eclipse 中,按一下 檔案 >匯入 >Android >將現有 Android 程式碼插入 Workspace。
- 選取「
SAMPLES_DIR/samples-android/minimalist
」。 - 按一下 [完成]。
在 MinimalistActivity 專案上按一下滑鼠右鍵,然後點選「Properties」。在「Android」下方,捲動畫面 找到「程式庫」部分,確定 google-play-services_lib 專案已正確設定 參照。如果沒有,請移除參照,然後在工作區中重新新增。
Eclipse 會自動編譯專案的 Java 和 Android 來源。不過,
jni
資料夾中的原生程式碼需要分開編譯。如要手動操作,請前往
然後執行 ndk-build
資料夾。jni
別忘了在
jni
資料夾。
您的專案現在應已編譯,但無法執行。您必須先設定遊戲 。
步驟 2:在 Google Play 管理中心設定遊戲
在 Google Play 管理中心建立遊戲項目。這麼做可啟用遊戲服務 並建立 OAuth 2.0 用戶端 ID (如果還沒有)。
- 按照 請參閱「設定 Google Play 遊戲服務」一文。
- 在
AndroidManifest.xml
中,將<manifest>
標記的package
屬性變更為 您在設定 Google Play 管理中心時選擇的套件名稱。你可能需要修正部分參考檔案 ,尤其是產生的R
類別。 - 開啟
res/values/ids.xml
並在其中放置應用程式 ID。請注意,應用程式 ID 與 用戶端 ID;也就是遊戲在「遊戲詳細資料」頁面中,遊戲名稱旁邊的數字。 Google Play 管理中心。
步驟 3:執行範例
如要執行範例,您需要有實體 Android 裝置或具有 已安裝的 Google Play 服務:
- 執行
ndk-build
編譯原生程式碼。 - 在 Eclipse 中,按一下 執行 >執行身分 >Android 應用程式,然後在裝置上執行範例。
- 試聽內容開啟後,輕觸片段上的任一處。您應該會看到 Google Play 遊戲標誌 顯示。如已正確設定應用程式,系統會提示您登入。
選用:使用 Eclipse 自動建立
下列步驟會說明如何設定 Eclipse 在執行 ndk-build
時
對「jni
」資料夾中的檔案進行變更。
- 在 MinimalistActivity 專案上按一下滑鼠右鍵,然後點選「Properties」。在「屬性」視窗中 選取「Builders」窗格。
- 按一下「New」新增建構工具,然後依序選取「Program」和「OK」。
- 在「Name」(名稱) 欄位中,輸入「NDK Builder」。
- 在「位置」下方,按一下「瀏覽檔案系統」,然後前往
NDK_ROOT
目錄, 選取ndk-build
指令 - 在「工作目錄」下方,按一下「瀏覽工作區」,然後選取「MinmalistActivity」。 專案資料夾
- 按一下「重新整理」分頁標籤。確認已勾選「在完成後重新整理資源」方塊。
- 選取「Specific resources」圓形按鈕,然後按一下「Assign Resources」。在
對話方塊中,請選取 MinimalActivity 下方的
jni
資料夾。 - 依序按一下「Apply」和「OK」完成建構工具建立程序。
現在,每當您編輯 jni
資料夾中的檔案時,Eclipse 都會執行 ndk-build
並將
發布至 Eclipse 控制台