适用于 C++ 的 Play 游戏服务使用入门 (Android)

准备工作

本开发者指南将向您展示如何在使用 Google Play 的 Android 上编译和运行 C++ 游戏 Game Services API。在开始之前，请下载并配置以下要求：

本开发者指南使用 Android 原生开发套件 (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 您在何处安装 NDK 点击偏好设置 >Android >NDK。

  5. 将 Google Play 服务库项目导入 Eclipse 工作区。

    1. 在 Eclipse 中，点击 File >导入 >Android >将现有 Android 代码导入工作区。
    2. 选择“SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib” 其中 SDK_ROOT 是您的 Android SDK 的位置。
    3. 点击完成。

  6. 将极简的示例项目导入 Eclipse 工作区。

    1. 在 Eclipse 中，点击 File >导入 >Android >将现有 Android 代码导入工作区。
    2. 选择 SAMPLES_DIR/samples-android/minimalist。
    3. 点击完成。

  7. 右键点击 MinimalistActivity 项目，然后点击属性。在 Android 下方，滚动 Library 部分，确保 google-play-services_lib 项目正确无误 引用。如果没有，请移除相应引用，然后从工作区中重新添加。

Eclipse 会自动编译项目的 Java 和 Android 源代码；不过， jni 文件夹中的原生代码需要单独编译。要手动执行此操作，请转到 进入 jni 文件夹并运行 ndk-build。在该菜单中进行更改之后，请务必 jni 文件夹中。

您的项目现在应该可以编译了，尽管它尚无法正常工作。您必须先配置游戏 。

第 2 步：在 Google Play 管理中心内设置游戏

在 Google Play 管理中心内为您的游戏创建一个条目。这会为您的游戏启用游戏服务 应用，创建一个 OAuth 2.0 客户端 ID（如果您还没有）。

  1. 按照相关说明步骤为您的游戏创建条目 设置 Google Play 游戏服务。
  2. 在 AndroidManifest.xml 中，将 <manifest> 标记的 package 属性设置为 软件包名称。您可能需要修正某些引用 更改之后在整个项目中（尤其是生成的 R 类）。
  3. 打开 res/values/ids.xml 并将您的应用 ID 放置到该处。请注意，应用 ID 与 客户端 ID；该 ID 就是您游戏的游戏详情页面中游戏名称旁的数字 Google Play 管理中心。

第 3 步：运行示例代码

为了运行该示例，您需要一台 Android 实体设备或一个安装了 已安装的 Google Play 服务：

  1. 运行 ndk-build 以编译原生代码。
  2. 在 Eclipse 中，点击运行 >运行方式 >Android 应用，并在设备上运行示例。
  3. 样本打开后，点按屏幕上的任意位置。您应该会看到 Google Play 游戏徽标 。如果您已正确配置应用，系统会提示您登录。
。

可选：使用 Eclipse 自动构建

以下步骤展示了如何将 Eclipse 配置为在您执行下列操作时自动运行 ndk-build： 更改 jni 文件夹中的文件。

  1. 右键点击 MinimalistActivity 项目，然后点击 Properties。在“属性”窗口中 选择构建器窗格。
  2. 点击新建以添加新的构建器，选择程序，然后点击确定。
  3. 在 Name 字段中，输入“NDK Builder”。
  4. 在 Location 下点击 Browse File System，转到 NDK_ROOT 目录， 选择 ndk-build 命令。
  5. 在工作目录下，点击浏览工作区，然后选择 MinimalistActivity 项目文件夹中。
  6. 点击刷新标签页。确保已选中 Refresh resources when complete 复选框。
  7. 选择特定资源单选按钮，然后点击指定资源。在 在弹出的对话框中，选择 MinimalActivity 下的 jni 文件夹。
  8. 依次点击 Apply 和 OK 以完成构建器的创建。

现在，每当您修改 jni 文件夹中的文件时，Eclipse 都会运行 ndk-build 并输出 输出到 Eclipse 控制台。