Android Play 游戏服务 C++ 入门

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

本开发者指南使用 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。如果您尚未这样做，请通过点击**首选项 > Android > NDK**告诉 Eclipse 您安装 NDK 的位置。

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

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

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

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

  7. 右键点击 MinimalistActivity 项目并点击**属性**。在**Android**下，向下滚动到**库**部分，并确保正确引用了 google-play-services_lib 项目。如果不是，请删除引用并从您的工作区中再次添加它。

Eclipse 将自动编译项目的 Java 和 Android 源代码；但是，jni文件夹中的原生代码需要单独编译。要手动执行此操作，请导航到jni文件夹并运行ndk-build。请记住，在对jni文件夹内部进行任何更改后，都要执行此操作。

您的项目现在应该可以编译了，但它还无法运行。您必须首先在 Google Play Console 中配置您的游戏。

步骤 2：在 Google Play Console 中设置游戏

在 Google Play Console 中创建游戏的条目。这将为您的应用启用游戏服务，并创建 OAuth 2.0 客户端 ID（如果您还没有的话）。

  1. 按照设置 Google Play 游戏服务中描述的步骤创建游戏的条目。
  2. 在AndroidManifest.xml中，将<manifest>标记的package属性更改为您在设置 Google Play Console 时选择的包名称。您可能需要在此更改后修复整个项目中的一些引用（特别是对生成的R类）。
  3. 打开res/values/ids.xml并将您的应用 ID 放置在那里。请注意，应用 ID 与客户端 ID 不相同；它是 Google Play Console 的**游戏详情**页面中游戏名称旁边的数字。

步骤 3：运行示例

要运行示例，您需要安装了 Google Play 服务的物理 Android 设备或模拟器

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

可选：使用 Eclipse 自动构建

以下步骤将向您展示如何配置 Eclipse，以便在您更改 jni 文件夹中的文件时自动运行 ndk-build。

  1. 右键单击 MinimalistActivity 项目，然后单击属性。在“属性”窗口中，选择构建器面板。
  2. 单击新建以添加新的构建器，然后选择程序，然后单击确定。
  3. 在名称字段中，输入“NDK 构建器”。
  4. 在位置下，单击浏览文件系统，然后导航到 NDK_ROOT 目录并选择 ndk-build 命令。
  5. 在工作目录下，单击浏览工作区并选择 MinimalistActivity 项目文件夹。
  6. 单击刷新选项卡。确保选中完成时刷新资源复选框。
  7. 选择特定资源单选按钮，然后单击指定资源。在结果对话框中，选择 MinimalActivity 下的 jni 文件夹。
  8. 单击应用，然后单击确定以完成构建器的创建。

现在，每次您编辑 jni 文件夹中的文件时，Eclipse 都会运行 ndk-build 并将输出打印到 Eclipse 控制台。