事前準備
本開發人員指南將示範如何在採用 Google Play 遊戲服務 API 的 Android 上編譯並執行 C++ 遊戲。開始下載之前,請先下載並設定下列需求條件:
- 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。將 SDK 擷取至您的開發機器上。在您的環境中,將變數
NDK_MODULE_PATH
設定為指向gpg-cpp-sdk
目錄上方的目錄。您應該會看到下列目錄結構:NDK_MODULE_PATH/ gpg-cpp-sdk/
- 開啟 Eclipse。如果您尚未安裝 Eclipse,請先按一下 [偏好設定] > [Android] > [NDK],告知 Eclipse 安裝位置。
將 Google Play 服務程式庫專案匯入 Eclipse 工作區。
- 在 Eclipse 中,依序按一下 [File] (檔案) > [Import] (匯入) > [Android] > [現有 Android 程式碼] (現有 Android 程式碼) 到 Workspace。
- 選取
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
,其中SDK_ROOT
是您的 Android SDK 位置。 - 按一下「Finish」。
將極簡清單專案匯入 Eclipse 工作區。
- 在 Eclipse 中,依序按一下 [File] (檔案) > [Import] (匯入) > [Android] > [現有 Android 程式碼] (現有 Android 程式碼) 到 Workspace。
- 選取 [
SAMPLES_DIR/samples-android/minimalist
]。 - 按一下「Finish」。
在 MinimalistActivity 專案上按一下滑鼠右鍵,然後按一下 [Properties]。在「Android」下,向下捲動至「Library」(資料庫) 區段,並確認 google-play-services_lib 專案已正確參照。如果不是,請移除參照,再重新加入工作區。
Eclipse 會自動編譯專案的 Java 與 Android 來源;不過,jni
資料夾中的原生程式碼必須分別編譯。如要手動操作,請前往 jni
資料夾並執行 ndk-build
。當您在 jni
資料夾中進行任何變更後,請記得執行此操作。
您的專案應該已完成編譯,但目前還不行。您必須先在 Google Play 管理中心設定遊戲
步驟 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 管理中心的「遊戲詳細資料」頁面中,遊戲名稱旁的數字就是遊戲 ID。
步驟 3:執行範例
如要執行範例,您必須使用實體 Android 裝置或已安裝 Google Play 服務的模擬器:
- 執行
ndk-build
以編譯原生程式碼。 - 在 Eclipse 中,依序點選 [Run] > [Run As] > [Android Application],然後在裝置上執行範例。
- 開啟樣本時,輕觸面板上的任何位置。您應該會看到一個 Google Play 遊戲標誌如果您已正確設定應用程式,系統會提示您登入。
選擇性:透過 Eclipse 自動建構
下列步驟說明如何在變更 jni
資料夾中的檔案時,設定 Eclipse 自動執行 ndk-build
。
- 在 MinimalistActivity 專案上按一下滑鼠右鍵,然後按一下「Properties」(屬性)。在「Properties」(屬性) 視窗中,選取「Builders」(建構工具) 窗格。
- 按一下 [New] (新增) 即可新增 Builder 並選取 [Program] (程式),然後按一下 [OK] (確定)。
- 在 [名稱] 欄位中輸入「NDK Builder」。
- 在「Location」下方,按一下「Browse File System」,然後前往
NDK_ROOT
目錄並選取ndk-build
指令。 - 按一下「Working Directory」下方的「Browse Workspace」,然後選取 MinimalistActivity 專案資料夾。
- 按一下 [重新整理] 分頁標籤。確認已勾選 [完成後重新整理資源] 方塊。
- 選取 [特定資源] 圓形按鈕,然後按一下 [指定資源]。在結果對話方塊中,選取 MinimalActivity 下的
jni
資料夾。 - 依序點選 [Apply] (套用) 和 [OK] (確定),即可完成建立工具。
現在,每當您在 jni
資料夾中編輯檔案時,Eclipse 都會執行 ndk-build
,並將輸出結果列印至 Eclipse 主控台。