在弃用 Google 登录 API 后,我们将在 2026 年移除 games v1 SDK。从 2025 年 2 月起,您将无法在 Google Play 上发布新集成了 games v1 SDK 的游戏。我们建议您改用 games v2 SDK。
虽然现有集成了旧版 games v1 的游戏在未来几年内仍能正常运行,但我们鼓励您从 2025 年 6 月开始迁移到 v2。
本指南适用于使用 Play 游戏服务 v1 SDK。Play 游戏服务 v2 的 C++ SDK 尚未发布。
本开发者指南将向您展示如何在 Android 上编译并运行使用 Google Play 游戏服务 API 的 C++ 游戏。开始之前,请下载并配置以下必备条件
- Android NDK,修订版本 14 或更高。
- Android SDK v10 或更高版本以及最新版本的 Eclipse ADT。.
- 设备必须运行 Android 4.0 (API level 14) 或更高版本。
- 最新版本的 Google Play 服务 SDK。
本开发者指南使用 Android Native Development Kit (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。如果您尚未这样做,请通过点击 Preferences > Android > NDK 告诉 Eclipse 您安装 NDK 的位置。
将 Google Play 服务库项目导入您的 Eclipse 工作区。
- 在 Eclipse 中,点击 File > Import > Android > Existing Android Code into Workspace。
- 选择
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
,其中SDK_ROOT
是您的 Android SDK 的位置。 - 点击 Finish。
将极简示例项目导入您的 Eclipse 工作区。
- 在 Eclipse 中,点击 File > Import > Android > Existing Android Code into Workspace。
- 选择
SAMPLES_DIR/samples-android/minimalist
。 - 点击 Finish。
右键点击 MinimalistActivity 项目,然后点击 Properties。在 Android 下,向下滚动到 Library 部分,并确保 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。
- 按照设置 Google Play 游戏服务中描述的步骤为您的游戏创建条目。
- 在
AndroidManifest.xml
中,将<manifest>
标签的package
属性更改为您在设置 Google Play Console 时选择的软件包名称。进行此更改后,您可能需要在整个项目中修复一些引用(特别是对生成的R
类)。 - 打开
res/values/ids.xml
并在其中放入您的应用 ID。请注意,应用 ID 与客户端 ID 不同;它是 Google Play Console 的游戏详情页面中游戏名称旁边的数字。
第 3 步:运行示例
为了运行示例,您需要一个实体 Android 设备或安装了 Google Play 服务的模拟器。
- 运行
ndk-build
编译原生代码。 - 在 Eclipse 中,点击 Run > Run As > Android Application 并在您的设备上运行示例。
- 当示例打开时,点击屏幕上的任意位置。您应该会看到 Google Play 游戏徽标出现。如果您已正确配置您的应用,系统将提示您登录。
可选:使用 Eclipse 自动构建
以下步骤展示了如何配置 Eclipse,使其在您更改 jni
文件夹中的文件时自动运行 ndk-build
。
- 右键点击 MinimalistActivity 项目,然后点击 Properties。在 Properties 窗口中,选择 Builders 面板。
- 点击 New 添加一个新的 Builder,选择 Program,然后点击 OK。
- 在 Name 字段中,输入 'NDK Builder'。
- 在 Location 下,点击 Browse File System 并导航到
NDK_ROOT
目录并选择ndk-build
命令。 - 在 Working Directory 下,点击 Browse Workspace 并选择 MinimalistActivity 项目文件夹。
- 点击 Refresh 选项卡。确保选中 Refresh resources upon completion 复选框。
- 选择 Specific resources 单选按钮,然后点击 Specify Resources。在弹出的对话框中,选择 MinimalActivity 下的
jni
文件夹。 - 点击 Apply,然后点击 OK 完成 Builder 的创建。
现在,每当您编辑 jni
文件夹中的文件时,Eclipse 都会运行 ndk-build
并将输出打印到 Eclipse Console。