准备工作
本开发者指南将向您展示如何在使用 Google Play 的 Android 上编译和运行 C++ 游戏 Game Services API。在开始之前,请下载并配置以下要求:
- Android NDK,修订版 14 或更高版本。
- Android SDK v10 或更高版本以及最新版本的 Eclipse ADT。
- 设备必须搭载 Android 4.0(API 级别 14)或更高版本。
- 最新版本的 Google Play 服务 SDK。
本开发者指南使用 Android 原生开发套件 (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 您在何处安装 NDK 点击偏好设置 >Android >NDK。
将 Google Play 服务库项目导入 Eclipse 工作区。
- 在 Eclipse 中,点击 File >导入 >Android >将现有 Android 代码导入工作区。
- 选择“
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
” 其中SDK_ROOT
是您的 Android SDK 的位置。 - 点击完成。
将极简的示例项目导入 Eclipse 工作区。
- 在 Eclipse 中,点击 File >导入 >Android >将现有 Android 代码导入工作区。
- 选择
SAMPLES_DIR/samples-android/minimalist
。 - 点击完成。
右键点击 MinimalistActivity 项目,然后点击属性。在 Android 下方,滚动 Library 部分,确保 google-play-services_lib 项目正确无误 引用。如果没有,请移除相应引用,然后从工作区中重新添加。
Eclipse 会自动编译项目的 Java 和 Android 源代码;不过,
jni
文件夹中的原生代码需要单独编译。要手动执行此操作,请转到
进入 jni
文件夹并运行 ndk-build
。在该菜单中进行更改之后,请务必
jni
文件夹中。
您的项目现在应该可以编译了,尽管它尚无法正常工作。您必须先配置游戏 。
第 2 步:在 Google Play 管理中心内设置游戏
在 Google Play 管理中心内为您的游戏创建一个条目。这会为您的游戏启用游戏服务 应用,创建一个 OAuth 2.0 客户端 ID(如果您还没有)。
- 按照相关说明步骤为您的游戏创建条目 设置 Google Play 游戏服务。
- 在
AndroidManifest.xml
中,将<manifest>
标记的package
属性设置为 软件包名称。您可能需要修正某些引用 更改之后在整个项目中(尤其是生成的R
类)。 - 打开
res/values/ids.xml
并将您的应用 ID 放置到该处。请注意,应用 ID 与 客户端 ID;该 ID 就是您游戏的游戏详情页面中游戏名称旁的数字 Google Play 管理中心。
第 3 步:运行示例代码
为了运行该示例,您需要一台 Android 实体设备或一个安装了 已安装的 Google Play 服务:
- 运行
ndk-build
以编译原生代码。 - 在 Eclipse 中,点击运行 >运行方式 >Android 应用,并在设备上运行示例。
- 样本打开后,点按屏幕上的任意位置。您应该会看到 Google Play 游戏徽标 。如果您已正确配置应用,系统会提示您登录。
可选:使用 Eclipse 自动构建
以下步骤展示了如何将 Eclipse 配置为在您执行下列操作时自动运行 ndk-build
:
更改 jni
文件夹中的文件。
- 右键点击 MinimalistActivity 项目,然后点击 Properties。在“属性”窗口中 选择构建器窗格。
- 点击新建以添加新的构建器,选择程序,然后点击确定。
- 在 Name 字段中,输入“NDK Builder”。
- 在 Location 下点击 Browse File System,转到
NDK_ROOT
目录, 选择ndk-build
命令。 - 在工作目录下,点击浏览工作区,然后选择 MinimalistActivity 项目文件夹中。
- 点击刷新标签页。确保已选中 Refresh resources when complete 复选框。
- 选择特定资源单选按钮,然后点击指定资源。在
在弹出的对话框中,选择 MinimalActivity 下的
jni
文件夹。 - 依次点击 Apply 和 OK 以完成构建器的创建。
现在,每当您修改 jni
文件夹中的文件时,Eclipse 都会运行 ndk-build
并输出
输出到 Eclipse 控制台。