GameActivity   Android 游戏开发套件 的一部分。

GameActivity 是一个 Jetpack 库，旨在帮助 Android 游戏在其应用的 C/C++ 代码中处理应用生命周期命令、输入事件和文本输入。GameActivity 是 NativeActivity 的直接后代，并具有相似的架构

如上图所示，GameActivity 执行以下功能

• 通过 Java 端组件与 Android 框架交互。
• 将应用生命周期命令、输入事件和输入文本传递到原生端。
• 将 C/C++ 源代码建模为三个逻辑组件
  • GameActivity 的 JNI 函数，直接支持 GameActivity 的 Java 功能并将事件排队到 native_app_glue。
  • native_app_glue，主要在其自己的原生线程中运行（与应用的主线程不同），并通过其 looper 执行任务。
  • 应用的游戏代码，它轮询和处理 native_app_glue 中排队的事件，并在 native_app_glue 线程中执行游戏代码。

使用 GameActivity，您可以专注于核心游戏开发，避免花费过多时间处理 JNI 代码。

如果您已经熟悉 NativeActivity，那么 GameActivity 和 NativeActivity 之间的主要区别如下

• GameActivity 渲染到 SurfaceView 中，这使得游戏更容易与其他 UI 组件交互。
• 对于触摸和按键输入事件，GameActivity 使用 android_input_buffer 接口实现了全新的实现，这与 NativeActivity 使用的 InputQueue 不同。
• GameActivity 是 AppCompatActivity 的派生类，它允许您无缝使用其他 Jetpack 组件。ActionBar、Fragment 等都可用。
• GameActivity 通过集成 GameTextInput 库添加了文本输入功能。
• 从 GameActivity 派生的应用应将 C/C++ 代码的所有三个部分构建到一个库中。另一方面，NativeActivity 的 JNI 函数是框架的一部分（始终由操作系统加载）。因此，只需将 native_app_glue 和应用的 C/C++ 代码构建到一个库中即可。
• NativeActivity 是 Android 框架的一部分，并遵循其发布周期（通常每年一次）。GameActivity 是 Jetpack 库的一部分，其发布周期更频繁（通常每两周一次）；新功能和错误修复可以更快地推出。

发布位置

GameActivity 库可通过以下渠道获取

• 作为 Android Jetpack 库的一部分（推荐）
• 作为 zip 软件包，可从 AGDK 下载页面下载
• 作为 AOSP 源代码

C/C++ 代码以源代码形式在所有发布渠道中提供，使用 Prefab 格式。GameActivity 1.2.2 版向发行版添加了一个静态库。从该版本及更高版本开始，我们建议您使用静态库而不是源代码。

Jetpack 库和 AGDK zip 软件包的内容

通过 Jetpack 库和 AGDK zip 软件包渠道，GameActivity 与 AAR 一起发布。此 AAR 包含以下主要组件

• 用于 Java 代码的 JAR 文件
• GameActivity 1.2.2 及更高版本中包含 C/C++ 静态库 game-activity_static。
• C/C++ 源代码（在 /prefab 文件夹下）

本页面链接的集成说明假设您可以在构建系统中使用 Prefab；否则，您可以将 prefab/modules/game-activity/include 文件夹下打包的源代码复制到您的构建系统并执行必要的集成步骤。Android Jetpack 库的 androidx 下的发布版本也存在类似的文件结构；默认情况下，gradle 会在其缓存目录 (~/.gradle/caches/...) 中解压 AAR。您可以通过搜索 prefab/modules/game-activity/include 并选择您预期发布版本下的位置来找到 C/C++ 源代码。

有关使用 Jetpack 库进行集成的说明，请参阅GameActivity 入门。

对于AGDK 库 zip 软件包，请按照以下步骤获取 C/C++ 代码

1. 解压下载的软件包。
2. 在解压后的软件包中，解压 GameActivity-release.aar。
3. 查找并复制 prefab/modules/game-activity/include 下的所有 C/C++ 源代码，包括以下内容
   • 用于 GameActivity 相关 C/C++ 代码的 game-activity
   • 用于 GameTextInput 相关 C/C++ 代码的 game-text-input

AOSP 源代码内容

AOSP 始终包含最新的源代码。请按照构建说明创建您自己的发布版本或直接将源代码集成到您的构建环境中。C/C++ 源代码的保存文件结构与 Jetpack 库和 AGDK zip 软件包的类似。

集成指南

遵循这些指南将 GameActivity 集成到您的应用中

• 开始使用
• 使用游戏文本输入
• NativeActivity 迁移指南

其他资源

要了解有关 GameActivity 的更多信息，请参阅以下内容

• GameActivity 和 AGDK 版本说明.
• 在 GameActivity 中使用 GameTextInput.
• NativeActivity 迁移指南.
• GameActivity 参考文档.
• GameActivity 实现.

反馈

要报告错误或请求 GameActivity 的新功能，请使用GameActivity 问题跟踪器。