Android 上 C++ 版 Play 游戏服务入门

在弃用 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 Native Development Kit (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。如果您尚未这样做,请通过点击 Preferences > Android > NDK 告诉 Eclipse 您安装 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 下,向下滚动到 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。

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

第 3 步:运行示例

为了运行示例,您需要一个实体 Android 设备或安装了 Google Play 服务的模拟器。

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

可选:使用 Eclipse 自动构建

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

  1. 右键点击 MinimalistActivity 项目,然后点击 Properties。在 Properties 窗口中,选择 Builders 面板。
  2. 点击 New 添加一个新的 Builder,选择 Program,然后点击 OK
  3. Name 字段中,输入 'NDK Builder'。
  4. Location 下,点击 Browse File System 并导航到 NDK_ROOT 目录并选择 ndk-build 命令。
  5. Working Directory 下,点击 Browse Workspace 并选择 MinimalistActivity 项目文件夹。
  6. 点击 Refresh 选项卡。确保选中 Refresh resources upon completion 复选框。
  7. 选择 Specific resources 单选按钮,然后点击 Specify Resources。在弹出的对话框中,选择 MinimalActivity 下的 jni 文件夹。
  8. 点击 Apply,然后点击 OK 完成 Builder 的创建。

现在,每当您编辑 jni 文件夹中的文件时,Eclipse 都会运行 ndk-build 并将输出打印到 Eclipse Console。