在 Android 裝置上開始使用 C++ 適用的 Play 遊戲服務

事前準備

本開發人員指南將示範如何在採用 Google Play 遊戲服務 API 的 Android 上編譯並執行 C++ 遊戲。開始下載之前,請先下載並設定下列需求條件:

本開發人員指南採用 Android Native Development Kit (NDK)。如果您不熟悉 NDK,請先參閱 NDK 說明文件和範例再繼續。

步驟 1:設定環境

  1. 下載 Android SDK 和 Android NDK,然後解壓縮到您的電腦。在您的環境中,將 SDK_ROOT 設為 Android SDK 資料夾的位置,並將 NDK_ROOT 設為 Android NDK 資料夾的位置。
  2. 下載 C++ 範例遊戲。本開發人員指南將範例中機器上的位置視為 SAMPLES_DIR
  3. 下載 Google Play 遊戲服務 C++ SDK。將 SDK 擷取至您的開發機器上。在您的環境中,將變數 NDK_MODULE_PATH 設定為指向 gpg-cpp-sdk 目錄上方的目錄。您應該會看到下列目錄結構:
    NDK_MODULE_PATH/
    gpg-cpp-sdk/
  4. 開啟 Eclipse。如果您尚未安裝 Eclipse,請先按一下 [偏好設定] > [Android] > [NDK],告知 Eclipse 安裝位置。
  5. 將 Google Play 服務程式庫專案匯入 Eclipse 工作區。

    1. 在 Eclipse 中,依序按一下 [File] (檔案) > [Import] (匯入) > [Android] > [現有 Android 程式碼] (現有 Android 程式碼) 到 Workspace
    2. 選取 SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib,其中 SDK_ROOT 是您的 Android SDK 位置。
    3. 按一下「Finish」
  6. 將極簡清單專案匯入 Eclipse 工作區。

    1. 在 Eclipse 中,依序按一下 [File] (檔案) > [Import] (匯入) > [Android] > [現有 Android 程式碼] (現有 Android 程式碼) 到 Workspace
    2. 選取 [SAMPLES_DIR/samples-android/minimalist]。
    3. 按一下「Finish」
  7. 在 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 (如果尚未建立的話)。

  1. 按照設定 Google Play 遊戲服務所述步驟,為您的遊戲建立項目。
  2. AndroidManifest.xml 中,將 <manifest> 標記的 package 屬性變更為您在設定 Google Play 管理中心時選擇的套件名稱。完成這項變更後,您可能需要在整個專案中修正一些參照 (尤其是產生的 R 類別)。
  3. 開啟 res/values/ids.xml,然後將應用程式 ID 放到該處。請注意,應用程式 ID 與用戶端 ID 不同;在 Google Play 管理中心的「遊戲詳細資料」頁面中,遊戲名稱旁的數字就是遊戲 ID。

步驟 3:執行範例

如要執行範例,您必須使用實體 Android 裝置或已安裝 Google Play 服務的模擬器:

  1. 執行 ndk-build 以編譯原生程式碼。
  2. 在 Eclipse 中,依序點選 [Run] > [Run As] > [Android Application],然後在裝置上執行範例。
  3. 開啟樣本時,輕觸面板上的任何位置。您應該會看到一個 Google Play 遊戲標誌如果您已正確設定應用程式,系統會提示您登入。

選擇性:透過 Eclipse 自動建構

下列步驟說明如何在變更 jni 資料夾中的檔案時,設定 Eclipse 自動執行 ndk-build

  1. 在 MinimalistActivity 專案上按一下滑鼠右鍵,然後按一下「Properties」(屬性)。在「Properties」(屬性) 視窗中,選取「Builders」(建構工具) 窗格。
  2. 按一下 [New] (新增) 即可新增 Builder 並選取 [Program] (程式),然後按一下 [OK] (確定)
  3. 在 [名稱] 欄位中輸入「NDK Builder」。
  4. 在「Location」下方,按一下「Browse File System」,然後前往 NDK_ROOT 目錄並選取 ndk-build 指令。
  5. 按一下「Working Directory」下方的「Browse Workspace」,然後選取 MinimalistActivity 專案資料夾。
  6. 按一下 [重新整理] 分頁標籤。確認已勾選 [完成後重新整理資源] 方塊。
  7. 選取 [特定資源] 圓形按鈕,然後按一下 [指定資源]。在結果對話方塊中,選取 MinimalActivity 下的 jni 資料夾。
  8. 依序點選 [Apply] (套用) 和 [OK] (確定),即可完成建立工具。

現在,每當您在 jni 資料夾中編輯檔案時,Eclipse 都會執行 ndk-build,並將輸出結果列印至 Eclipse 主控台。