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

准备工作

本开发者指南将向您介绍如何在 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。告诉 Eclipse 您安装 NDK 的位置(如果尚未执行此操作),请依次点击 Preferences > Android > NDK
  5. 将 Google Play 服务库项目导入 Eclipse 工作区。

    1. 在 Eclipse 中,依次点击 File > Import > Android > Existing Android Code into 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 > Existing Android Code into Workspace
    2. 选择 SAMPLES_DIR/samples-android/minimalist
    3. 点击 Finish
  7. 右键点击 MinimalistActivity 项目,然后点击 Properties。在 Android 下,向下滚动到部分,并确保正确引用了 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 管理中心的游戏详情页面中游戏名称旁边的数字。

第 3 步:运行示例代码

为了运行该示例,您需要一台安装了 Google Play 服务的真机 Android 设备或模拟器:

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

可选:使用 Eclipse 自动构建

以下步骤介绍了如何配置 Eclipse,以便在您更改 jni 文件夹中的文件时自动运行 ndk-build

  1. 右键点击 MinimalistActivity 项目,然后点击 Properties。在“属性”窗口中,选择构建器窗格。
  2. 点击 New 以添加新的 Builder,然后选择 Program,然后点击 OK
  3. 名称字段中,输入“NDK Builder”。
  4. 位置下,点击浏览文件系统,然后导航到 NDK_ROOT 目录并选择 ndk-build 命令。
  5. 工作目录下,点击浏览工作区,然后选择 MinimalistActivity 项目文件夹。
  6. 点击刷新标签页。确保已选中完成时刷新资源复选框。
  7. 选择特定资源单选按钮,然后点击指定资源。在由此显示的对话框中,选择 MinimalActivity 下的 jni 文件夹。
  8. 点击 Apply,然后点击 OK 完成构建器的创建。

现在,每次您修改 jni 文件夹中的文件时,Eclipse 将运行 ndk-build 并将输出输出到 Eclipse 控制台。