Android Games

Android Games 库是 Android Game SDK（能够以二进制文件的形式下载）的镜像。您可以使用 AndroidX 库，而无需手动下载 Android Game SDK 并将其集成到 build 中。

如需详细了解 Android Game SDK，请参阅 SDK 文档和 SDK 版本说明。

下表列出了 androidx.games 组中的所有工件。

制品 稳定版 候选版 Beta 版 Alpha 版
games-activity 4.4.2 - - -
games-controller 2.0.2 - - 2.3.0-alpha01
games-frame-pacing 2.1.3 - - 2.3.0-alpha01
games-memory-advice 2.0.1 - 2.1.0-beta01 2.3.0-alpha01
games-text-input 4.3.1 - - -
games-performance-tuner 2.0.0 - - 2.3.0-alpha01
此库的最后更新时间：2026 年 5 月 6 日

要求

games-memory-advice

如要使用 MemoryAdvice API，您必须使用 NDK 版本 r23.* 或更高版本构建应用。

声明依赖项

如需添加 Game 的依赖项，您必须将 Google Maven 制品库添加到项目中。如需了解详情，请参阅 Google 的 Maven 制品库。

在应用或模块的 build.gradle 文件中添加所需制品的依赖项；games-activity 库集成了相同版本的 game-text-input 库，因此 GameActivity 应用无法再次包含 game-text-input 依赖项：

Groovy

android {
    ...
    // To use the Android Frame Pacing or Android Performance Tuner libraries, enable
    // native dependencies to be imported. Libraries will be made available to your CMake build
    // as packages named "games-frame-pacing" and "games-performance-tuner".
    buildFeatures {
        prefab true
    }
}

dependencies {
    // To use the Android Frame Pacing library
    implementation "androidx.games:games-frame-pacing:2.1.3"

    // To use the Android Performance Tuner
    implementation "androidx.games:games-performance-tuner:2.0.0"

    // To use the Games Activity library
    implementation "androidx.games:games-activity:4.4.2"

    // To use the Games Controller Library
    implementation "androidx.games:games-controller:2.0.2"

    // To use the Games Text Input Library
    // Do not include this if games-activity has been included
    implementation "androidx.games:games-text-input:4.3.1"
}

Kotlin

android {
    ...
    // To use the Android Frame Pacing or Android Performance Tuner libraries, enable
    // native dependencies to be imported. Libraries will be made available to your CMake build
    // as packages named "games-frame-pacing" and "games-performance-tuner".
    buildFeatures {
        prefab = true
    }
}

dependencies {
    // To use the Android Frame Pacing library
    implementation("androidx.games:games-frame-pacing:2.1.3")

    // To use the Android Performance Tuner
    implementation("androidx.games:games-performance-tuner:2.0.0")

    // To use the Games Activity library
    implementation("androidx.games:games-activity:4.4.2")

    // To use the Games Controller Library
    implementation("androidx.games:games-controller:2.0.2")

    // To use the Games Text Input Library
    // Do not include this if games-activity has been included
    implementation("androidx.games:games-text-input:4.3.1")
}
}

如需详细了解依赖项，请参阅添加 build 依赖项。

添加 Gradle 属性

您可能需要向与应用（或模块）的 build.gradle 文件位于同一目录的 gradle.properties 文件添加属性。如果 gradle.properties 文件不存在，请创建此文件。

如果您使用的是 Android Studio 4.0，请确保 gradle.properties 包含以下几行代码：

# Enables experimental Prefab
android.enablePrefab=true
# Tell Android Studio we are using AndroidX
android.useAndroidX=true

如果您使用的是 Android Studio 4.1 或更高版本，请确保 gradle.properties 包含以下几行代码：

# Tell Android Studio we are using AndroidX
android.useAndroidX=true

使用 CMake 添加软件包

要使导入的 Game SDK 软件包可用，请将以下代码添加到主应用的 CMakeLists.txt 文件中：

# Add the packages from the Android Game SDK
find_package(games-frame-pacing REQUIRED CONFIG)
find_package(games-performance-tuner REQUIRED CONFIG)

这样，您就可以在游戏代码中加入 Android 游戏 SDK 中的头文件：

#include "swappy/swappyGL.h"
#include "tuningfork/tuningfork.h"

在主应用的 CMakeLists.txt 文件中，找到主共享库的 target_link_libraries。将引用代码添加到 Android Game SDK 静态库中，从而将其添加到您的共享库中：

target_link_libraries(...
  games-frame-pacing::swappy_static
  games-performance-tuner::tuningfork_static
  ...)

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库有任何改进建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

Games-Text-Input

4.3 版

版本 4.3.1

2026 年 5 月 6 日

发布了 androidx.games:games-text-input:4.3.1。版本 4.3.1 包含这些提交内容。

版本 4.3.0

2026 年 3 月 11 日

发布了 androidx.games:games-text-input:4.3.0。版本 4.3.0 中包含这些提交内容。

版本 4.3.0-rc01

2026 年 1 月 28 日

发布了 androidx.games:games-text-input:4.3.0-rc01。版本 4.3.0-rc01 包含这些提交内容。

版本 4.3.0-beta01

2025 年 11 月 19 日

发布了 androidx.games:games-text-input:4.3.0-beta01。版本 4.3.0-beta01 包含这些提交内容。

  • 此版本将 androidx.games:games-text-input 从 Alpha 版过渡到 Beta 版。

版本 3.0

版本 3.0.4

2024 年 8 月 7 日

发布了 androidx.games:games-text-input:3.0.4。版本 3.0.4 中包含这些提交内容。

bug 修复

  • 修复了在选择和未选择文本的情况下删除的功能。

2.1 版

版本 2.1.0-alpha01

2023 年 7 月 26 日

发布了 androidx.games:games-text-input:2.1.0-alpha01。版本 2.1.0-alpha01 中包含这些提交内容。

新功能

  • 添加了对多行和单行模式的支持

API 变更

  • 添加 isSoftwareKeyboardVisible 函数
  • 为 GameActivity_setImeEditorInfo 添加了位字段定义
  • 添加 onEditorAction 回调

bug 修复

  • 修复了硬件键盘和软件键盘不同步的问题
  • 在软键盘隐藏时清除焦点

2.0 版

版本 2.0.0

2023 年 3 月 8 日

发布了 androidx.games:games-text-input:2.0.0。版本 2.0.0 中包含这些提交内容。

自 1.1.1 以来的重要变更

  • 由于构建系统发生更改而进行的主要版本更新，库/API 本身没有更新。

版本 1.1

版本 1.1.2-alpha01

2022 年 11 月 9 日

发布了 androidx.games:games-text-input:1.1.2-alpha01。版本 1.1.2-alpha01 中包含这些提交内容。

新功能

  • 没有新更改

版本 1.1.1

2022 年 7 月 13 日

发布了 androidx.games:games-text-input:1.1.1。版本 1.1.1 中包含这些提交内容。

bug 修复

  • 修正了之前的版本缺少 .aar 文件的问题。

版本 1.1.0

2022 年 2 月 9 日

发布了 androidx.games:games-text-input:1.1.0。版本 1.1.0 中包含这些提交内容。

自版本 1.0.0 以来的重要变更 - 为 GameTextInput 添加了 WindowInsets 监听和查询功能 - 添加了缺少的 gamecommon.h 头文件

版本 1.1.0-rc01

2022 年 1 月 26 日

发布了 androidx.games:games-text-input:1.1.0-rc01。版本 1.1.0-rc01 中包含这些提交内容。

版本 1.1.0-beta01

2021 年 12 月 15 日

发布了 androidx.games:games-text-input:1.1.0-beta01。版本 1.1.0-beta01 中包含这些提交内容。

bug 修复

  • 修复了瀑布流和 IME 边衬区
  • 添加了缺少的 gamecommon.h 头文件

版本 1.1.0-alpha01

2021 年 10 月 13 日

发布了 androidx.games:games-text-input:1.1.0-alpha01。版本 1.1.0-alpha01 中包含这些提交内容。

API 变更

  • 向 GameTextInput 添加了 IME 边衬区功能

版本 1.0

版本 1.0.0

2021 年 8 月 4 日

发布了 androidx.games:games-activity:1.0.0、androidx.games:games-controller:1.0.0 和 androidx.games:games-text-input:1.0.0。版本 1.0.0 中包含这些提交内容。

1.0.0 的主要功能

这是 Games-Activity、Games-Controller 和 Games-Text-Input 的稳定版的初始版本。如需了解详情，请参阅 AGDK 首页。

版本 1.0.0-rc01

2021 年 7 月 12 日

发布了 androidx.games:games-text-input:1.0.0-rc01，该版本没有任何变化。版本 1.0.0-rc01 中包含这些提交内容。

版本 1.0.0-beta01

2021 年 6 月 30 日

发布了 androidx.games:games-text-input:1.0.0-beta01。版本 1.0.0-beta01 中包含这些提交内容。

API 变更

  • 改进了 GameTextInputState 对象的所有权模型。
  • 清理了类型，以便与 NDK 保持一致。

版本 1.0.0-alpha01

2021 年 6 月 16 日

发布了 androidx.games:games-text-input:1.0.0-alpha01。

新功能

  • Games-Text-Input 是一个新库，旨在帮助游戏开发者使用 C/C++ 中的 Android 软键盘输入。

Games-Activity

4.4 版

版本 4.4.2

2026 年 5 月 6 日

发布了 androidx.games:games-activity:4.4.2。版本 4.4.2 中包含这些提交内容。

版本 4.4.1

2026 年 4 月 8 日

发布了 androidx.games:games-activity:4.4.1。版本 4.4.1 中包含这些提交内容。

版本 4.4.0

2026 年 3 月 11 日

发布了 androidx.games:games-activity:4.4.0。版本 4.4.0 中包含这些提交内容。

版本 4.4.0-rc01

2026 年 1 月 28 日

发布了 androidx.games:games-activity:4.4.0-rc01。版本 4.4.0-rc01 包含这些提交内容。

版本 4.4.0-beta01

2025 年 11 月 19 日

发布了 androidx.games:games-activity:4.4.0-beta01。版本 4.4.0-beta01 包含这些提交内容。

  • 此版本将 androidx.games:games-activity 从 Alpha 版过渡到 Beta 版。

版本 4.4.0-alpha01

October 22, 2025

发布了 androidx.games:games-activity:4.4.0-alpha01。版本 4.4.0-alpha01 中包含这些提交内容。

bug 修复

  • 改进了 native_app_glue 中的 ANR 保护。
  • 从已废弃的 ALooper_pollAll 迁移到 ALooper_pollOnce。

4.3 版

版本 4.3.0-alpha01

2025 年 8 月 13 日

发布了 androidx.games:games-activity:4.3.0-alpha01 和 androidx.games:games-text-input:4.3.0-alpha01。版本 4.3.0-alpha01 包含这些提交内容。

新功能

  • 默认支持 16kb 页面大小。
  • 为 GameActivity 提供鼠标支持。

bug 修复

  • 修复了 onDestroy 和 onCreate 生命周期事件之间的竞态条件。
  • 修复了应用需要手动保留符号才能初始化原生代码的问题。
  • 改进了 GameActivity 触摸处理。
  • 修复了 GameTextInput 错误地生成为共享库的问题。

4.2 版

版本 4.2.0-alpha01

2025 年 3 月 26 日

发布了 androidx.games:games-activity:4.2.0-alpha01 和 androidx.games:games-text-input:4.2.0-alpha01。版本 4.2.0-alpha01 包含这些提交内容。

新功能

bug 修复

  • 修复了 GameActivity 中的一个 bug，该 bug 会导致 getLocaleScript、getLocaleCountry 和 getLocaleVariant 报告语言区域语言，而不是请求的值 (1198bb0)
  • 修复了 GameActivity 中的一个 bug，该 bug 导致我们错误地报告了软件键盘打开/关闭事件。(a63ecca)
  • 修复了 GameTextInput 中与多字节表情符号处理相关的 bug (9d54c68)

4.0 版

版本 4.0.0

2025 年 2 月 12 日

发布了 androidx.games:games-activity:4.0.0 和 androidx.games:games-text-input:4.0.0。版本 4.0.0 中包含这些提交内容。

4.0.0 的主要功能

  • AAR 文件现在包含预构建的静态库。现在，应用代码应通过预制件使用这些库，并且仅包含头文件（例如 #include "GameActivity.h"），而不是包含实现（例如 #include "GameActivity.cpp"）。
  • 此外，使用 GameActivity 的原生代码现在可以访问 Android 语言区域信息。

bug 修复

  • 修复了 GameTextInput 中的许多 bug。该库现在更加稳定，并且可与许多常用的软件和硬件键盘搭配使用。

版本 4.0.0-rc01

2025 年 1 月 29 日

发布了 androidx.games:games-activity:4.0.0-rc01 和 androidx.games:games-text-input:4.0.0-rc01。版本 4.0.0-rc01 中包含这些提交内容。

版本 4.0.0-beta01

2025 年 1 月 15 日

发布了 androidx.games:games-activity:4.0.0-beta01 和 androidx.games:games-text-input:4.0.0-beta01。版本 4.0.0-beta01 中包含这些提交内容。

bug 修复

  • 更好地记录了新添加的与语言区域相关的功能。
  • 为所有枚举类型添加了支持类型。

版本 4.0.0-alpha01

2024 年 10 月 16 日

发布了 androidx.games:games-activity:4.0.0-alpha01 和 androidx.games:games-text-input:4.0.0-alpha01。版本 4.0.0-alpha01 中包含这些提交内容。

新功能

  • GameTextInput 现在支持向左/向右键。

API 变更

  • 移除了 GameTextInput 的过时 Java 接口。
  • GameActivity 和 GameTextInput 的预制品现在包含所有源文件。不再建议使用 #include <GameActivity.cpp>。请改为链接到适当的静态或动态库，例如 CMake 中的 game-activity::game-activity_static。这些库随 AAR 文件一起提供。

bug 修复

  • GameTextInput 中进行了多项修复。修复了输入和移除功能。
  • 改进了与大多数热门软件键盘的兼容性。
  • 修复了硬件键盘上特殊字符的处理问题。
  • 修复了 GameActivity 中罕见的 null 指针访问问题。

版本 3.0

版本 3.0.5

2024 年 8 月 7 日

发布了 androidx.games:games-activity:3.0.5。版本 3.0.5 中包含这些提交内容。

bug 修复

  • 发布了 GameActivity 的新版本，以匹配 GameTextInput 的 3.0.4 版本（修复了输入中文字删除的功能）。

版本 3.0.4

2024 年 7 月 10 日

发布了 androidx.games:games-activity:3.0.4。版本 3.0.4 中包含这些提交内容。

bug 修复

  • 修复了 null 指针的处理问题。
  • 修复了 onConfiguration() 回调中某些状态缺少状态更新的问题。

版本 3.0.3

2024 年 4 月 17 日

发布了 androidx.games:games-activity:3.0.3 和 androidx.games:games-text-input:3.0.3。版本 3.0.3 中包含这些提交内容。

bug 修复

  • 修复了与某些软件键盘的兼容性问题。

版本 3.0.2

2024 年 4 月 3 日

发布了 androidx.games:games-activity:3.0.2 和 androidx.games:games-text-input:3.0.2。版本 3.0.2 中包含这些提交内容。

bug 修复

  • 我们对 GamesTextInput 进行了多项修复，旨在改进软件和硬件键盘支持。此外，还修复了阻止在没有 GameActivity 的情况下使用 GameTextInput 的 bug。

版本 3.0.1

2024 年 3 月 20 日

发布了 androidx.games:games-activity:3.0.1 和 androidx.games:games-text-input:3.0.1。版本 3.0.1 中包含这些提交内容。

bug 修复

  • 修复了特殊字符的输入和显示问题。

版本 3.0.0

2024 年 3 月 6 日

发布了 androidx.games:games-activity:3.0.0 和 androidx.games:games-text-input:3.0.0。版本 3.0.0 包含这些提交内容。

3.0.0 的主要功能

  • GameTextInput 经过重新设计，可在游戏中直接使用。
  • 与版本 2.0.0 相比，这两个库中的某些接口已发生更改。

bug 修复

  • 修复了与旧 NDK 的兼容性问题
  • 修复了 Windows build 问题

版本 3.0.0-rc01

2024 年 2 月 21 日

发布了 androidx.games:games-activity:3.0.0-rc01 和 androidx.games:games-text-input:3.0.0-rc01。版本 3.0.0-rc01 中包含这些提交内容。

bug 修复

  • 修复了键盘事件未被 Looper 正确处理而导致的冻结问题。

版本 3.0.0-beta01

2023 年 11 月 29 日

发布了 androidx.games:games-activity:3.0.0-beta01 和 androidx.games:games-text-input:3.0.0-beta01。版本 3.0.0-beta01 中包含这些提交内容。

版本 3.0.0-alpha01

2023 年 11 月 15 日

发布了 androidx.games:games-activity:3.0.0-alpha01 和 androidx.games:games-text-input:3.0.0-alpha01。版本 3.0.0-alpha01 中包含这些提交内容。

API 变更

  • GameActivityMotionEvent 和 GameActivityCallbacks 结构更改了大小。
  • onEditorAction 将其返回值类型从布尔值更改为 void。
  • setImeEditorInfo 现在需要的是枚举参数，而不是整数。
  • GameActivityEvents 的内部函数已移至 GameActivityEvents_internal.h。
  • GameTextInput 的输入类型也是枚举，而不是整数。

2.1 版

版本 2.1.0-alpha02

2023 年 9 月 6 日

发布了 androidx.games:games-activity:2.1.0-alpha02 和 androidx.games:games-text-input:2.1.0-alpha02。版本 2.1.0-alpha02 中包含这些提交内容。

bug 修复

  • 改进了 32 位设备的兼容性。

版本 2.1.0-alpha01

2023 年 7 月 26 日

发布了 androidx.games:games-activity:2.1.0-alpha01。版本 2.1.0-alpha01 中包含这些提交内容。

新功能

  • 提供替换 SurfaceView 实例创建的功能
  • 添加了 SDK 版本报告功能

API 变更

  • 将 historicalEventTimes 的 long 替换为 int64_t，以避免在 32 位系统上出现溢出
  • 添加了 GameActivity_restartInput 方法
  • 添加原生回调以处理软件键盘可见性变化

bug 修复

  • 优化触摸事件处理
  • 修正了 GameActivityMotionEven 的销毁
  • 修复了 GameActivityMotionEvent_getHistoricalAxisValue 指数计算
  • 修复了运动过滤器的位掩码

2.0 版

版本 2.0.2

2023 年 5 月 24 日

发布了 androidx.games:games-activity:2.0.2。版本 2.0.2 中包含这些提交内容。

bug 修复

  • 修复了 GameActivityEvents 中的稳定性问题 (b/278017467)

版本 2.0.1

2023 年 4 月 5 日

发布了 androidx.games:games-activity:2.0.1。版本 2.0.1 中包含这些提交内容。

bug 修复

  • 修复了 historicalEventTimes 导致的内存过早释放问题。
  • 修复了 32 位系统上 historicalEventTimesNanos 溢出的问题

版本 2.0.0

2023 年 3 月 8 日

发布了 androidx.games:games-activity:2.0.0。版本 2.0.0 中包含这些提交内容。

2.0.0 的主要功能

  • 更改了历史事件时间的接口，以克服 32 位限制。
  • 提供用户对配置更改（例如屏幕方向）的访问权限。
  • 在 contentRect 结构中提供最新信息。
  • 提供了一种更简便的方式来定制默认的 SurfaceView。
  • 修复了默认操作系统对触控事件的处理，例如处理系统按钮。
  • 优化了触控事件处理中的大多数 JNI 调用；这曾经会影响性能。

版本 2.0.0-rc01

2023 年 2 月 22 日

发布了 androidx.games:games-activity:2.0.0-rc01。版本 2.0.0-rc01 中包含这些提交内容。

版本 2.0.0-beta01

2023 年 2 月 8 日

发布了 androidx.games:games-activity:2.0.0-beta01。版本 2.0.0-beta01 中包含这些提交内容。

bug 修复

  • 修复了系统按钮处理问题。(2a103e)

版本 2.0.0-alpha01

2023 年 1 月 11 日

发布了 androidx.games:games-activity:2.0.0-alpha01，该版本没有任何变化。版本 2.0.0-alpha01 中包含这些提交内容。

版本 1.2

版本 1.2.2

2022 年 12 月 7 日

发布了 androidx.games:games-activity:1.2.2。版本 1.2.2 中包含这些提交内容。

bug 修复

  • 现在，可以在运行时设置动作事件数量上限。

版本 1.2.2-alpha01

2022 年 11 月 9 日

发布了 androidx.games:games-activity:1.2.2-alpha01。版本 1.2.2-alpha01 中包含这些提交内容。

API 变更

  • API 现在还包含 GAMEACTIVITY_PACKED_VERSION 形式的版本信息。(I287e6)
  • 添加了 onContentRectChanged 回调，该回调会在应放置内容的窗口中的矩形发生变化时调用。(I81396)

bug 修复

  • 修复了事件缓冲区溢出问题。inputBuffer->keyEvents 和 motionEvents 现在都是动态分配的缓冲区。(Ic00f6)
  • 如果内存不足，则会正常失败。添加了在调整缓冲区大小期间对 realloc() 错误的处理。

版本 1.2.1

2022 年 7 月 13 日

发布了 androidx.games:games-activity:1.2.1。版本 1.2.1 中包含这些提交内容。

bug 修复

  • 修正了之前的版本缺少 .aar 文件的问题。

版本 1.2.0

2022 年 6 月 15 日

发布了 androidx.games:games-activity:1.2.0。版本 1.2.0 中包含这些提交内容。

自 1.1.0 以来的重要变更

  • 允许派生的 GameActivity 类处理原生库的加载。
  • 始终在 GameActivity.onCreate 中加载原生库。
  • 如果找不到其他库，则回退到加载名为“main”的库。

版本 1.1

版本 1.1.0

2022 年 2 月 23 日

发布了 androidx.games:games-activity:1.1.0 和 androidx.games:games-controller:1.1.0。版本 1.1.0 中包含这些提交内容。

自 1.0.0 以来的重要变更

Games Activity：

  • 添加了监听和查询 notch 和 IME 响应的 WindowInsets
  • 添加了按键和动作事件过滤器
  • bug 修复：
    • 添加了缺少的消息，以与 NativeActivity 兼容
    • 修复了 onNativeWindowResized 签名问题
    • 修复了输入事件丢失问题

版本 1.1.0-rc01

2022 年 2 月 9 日

发布了 androidx.games:games-activity:1.1.0-rc01 和 androidx.games:games-controller:1.1.0-rc01。版本 1.1.0-rc01 中包含这些提交内容。

版本 1.1.0-beta03

2022 年 1 月 26 日

发布了 androidx.games:games-activity:1.1.0-beta03。版本 1.1.0-beta03 中包含这些提交内容。

bug 修复

  • 修复了 onNativeWindowResized 签名存在的问题
  • 在 onSurfaceChanged 中保留了原生 window 的句柄

版本 1.1.0-beta02

2021 年 12 月 15 日

发布了 androidx.games:games-activity:1.1.0-beta02。版本 1.1.0-beta02 中包含这些提交内容。

bug 修复

  • 修复了事件过滤器设置中的竞态条件问题。

版本 1.1.0-beta01

2021 年 11 月 17 日

发布了 androidx.games:games-activity:1.1.0-beta01。版本 1.1.0-beta01 中包含这些提交内容。

新功能

  • 添加了对查询窗口边衬区和监听边衬区更改的支持。这样一来，游戏就可以响应 IME 弹出式窗口，并处理瀑布边衬区和摄像头刘海区域边衬区。

API 变更

  • void GameActivity_getWindowInsets(GameActivity* activity, enum GameCommonInsetsType type, GameCommonInsets* insets);

bug 修复

  • 避免将键事件全部用尽：音量、摄像头等现在会传递到系统。

版本 1.1.0-alpha01

2021 年 9 月 29 日

发布了 androidx.games:games-activity:1.1.0-alpha01。版本 1.1.0-alpha01 中包含这些提交内容。

API 变更

  • 向 GameActivityCallbacks 添加了 onContentRectChanged 回调

bug 修复

  • 向 android_native_app_glue.h 添加了缺失的消息：
    • APP_CMD_CONTENT_RECT_CHANGED
    • APP_CMD_WINDOW_REDRAW_NEEDED

版本 1.0.0

版本 1.0.0

2021 年 8 月 4 日

发布了 androidx.games:games-activity:1.0.0、androidx.games:games-controller:1.0.0 和 androidx.games:games-text-input:1.0.0。版本 1.0.0 中包含这些提交内容。

1.0.0 的主要功能

这是 Games-Activity、Games-Controller 和 Games-Text-Input 的稳定版的初始版本。如需了解详情，请参阅 AGDK 首页。

版本 1.0.0-rc01

2021 年 7 月 12 日

发布了 androidx.games:games-activity:1.0.0-rc01。版本 1.0.0-rc01 中包含这些提交内容。

bug 修复

  • 修复了 GameActivityCallbacks::onSaveInstanceState 的返回值类型

版本 1.0.0-beta01

2021 年 6 月 30 日

发布了 androidx.games:games-activity:1.0.0-beta01。版本 1.0.0-beta01 中包含这些提交内容。

API 变更

  • 已将 GameActivityInputInfo 重命名为 GameActivityPointerAxes。
  • onNativeWindowResized 回调现在提供窗口的宽度和高度。
  • 移除了 onContentRectChanged 回调。
  • 已将 onLowMemory 重命名为 onTrimMemory。
  • 移除了 GameActivity_setWindowFormat。
  • 改进了 GameActivityMotionEvents 和 GameActivityMotionEvent 指针的所有权模型。
  • 改进了 onSaveInstanceState 回调中用户状态的所有权模型。

版本 1.0.0-alpha01

2021 年 6 月 16 日

发布了 androidx.games:games-activity:1.0.0-alpha01。

新功能

  • Games-Activity 是一个新库，替代了 NativeActivity，成为集成 C/C++ 游戏与 Android 的推荐方式。

Games-Memory-Advice

2.1 版

版本 2.1.0-beta01

2023 年 11 月 29 日

发布了 androidx.games:games-memory-advice:2.1.0-beta01。版本 2.1.0-beta01 中包含这些提交内容。

版本 2.1.0-alpha01

2023 年 11 月 15 日

发布了 androidx.games:games-memory-advice:2.1.0-alpha01。版本 2.1.0-alpha01 中包含这些提交内容。

新功能

  • 更新了库的内存模型，以实现更好的预测。

API 变更

  • 添加了新 API getAvailableMemory()，用于返回可安全分配的内存量（以字节为单位）的估计值。

版本 2.1.0-alpha01

2023 年 7 月 26 日

发布了 androidx.games:games-memory-advice:2.1.0-alpha01。版本 2.1.0-alpha01 中包含这些提交内容。

API 变更

  • 添加 GetAvailableMemory 函数

bug 修复

  • 更新内存建议模型
  • 修复了共享 memory_advice build 目标

2.0 版

版本 2.0.1

2023 年 9 月 20 日

发布了 androidx.games:games-memory-advice:2.0.1。版本 2.0.1 中包含这些提交内容。

bug 修复

  • 修复了因线程未附加到 JVM 而导致状态监听器线程发生崩溃的问题。

版本 2.0.0

2023 年 9 月 6 日

发布了 androidx.games:games-memory-advice:2.0.0。版本 2.0.0 中包含这些提交内容。

2.0.0 的主要功能

  • 在此版本中，我们训练并发布了一个新的机器学习模型。
  • 实现了一个用于预测可用内存量的 API。

版本 2.0.0-rc01

2023 年 7 月 26 日

发布了 androidx.games:games-memory-advice:2.0.0-rc01。版本 2.0.0-rc01 中包含这些提交内容。

新功能

  • 纳入了一个新模型，以更好地预测剩余内存。

bug 修复

  • 修复了内存建议功能无法与共享 STL 搭配使用的问题。

版本 2.0.0-beta04

2023 年 5 月 24 日

发布了 androidx.games:games-memory-advice:2.0.0-beta04。版本 2.0.0-beta04 中包含这些提交内容。

新功能

  • 更新了为该库提供支持的机器学习模型，以便为较新的手机提供更出色的结果

版本 2.0.0-beta03

2023 年 4 月 5 日

发布了 androidx.games:games-memory-advice:2.0.0-beta03。版本 2.0.0-beta03 中包含这些提交内容。

bug 修复

  • 修复了库无法正确加载所需的 TensorFlow Lite 资源的问题

版本 2.0.0-beta02

2023 年 3 月 22 日

发布了 androidx.games:games-memory-advice:2.0.0-beta02。版本 2.0.0-beta02 中包含这些提交内容。

bug 修复

  • 修复了导致无法正确关联库的静态版本的 bug

版本 2.0.0-beta01

2023 年 2 月 22 日

发布了 androidx.games:games-memory-advice:2.0.0-beta01。版本 2.0.0-beta01 中包含这些提交内容。

新功能

  • 没有新更改

版本 2.0.0-alpha01

2023 年 2 月 8 日

发布了 androidx.games:games-memory-advice:2.0.0-alpha01。版本 2.0.0-alpha01 中包含这些提交内容。

API 变更

  • 因 build 文件重构而提升了主要版本。

bug 修复

  • 现在，错误的库资源配置会导致错误，而不是崩溃。

版本 1.0.0

版本 1.0.0-beta03

2022 年 11 月 9 日

发布了 androidx.games:games-memory-advice:1.0.0-beta03。版本 1.0.0-beta03 中包含这些提交内容。

新功能

  • 没有新更改

版本 1.0.0-beta01

2022 年 3 月 9 日

发布了 androidx.games:games-memory-advice:1.0.0-beta01。版本 1.0.0-beta01 中包含这些提交内容。

  • 与 1.0.0-alpha01 相比没有变化。

版本 1.0.0-alpha01

2022 年 2 月 23 日

发布了 androidx.games:games-memory-advice:1.0.0-alpha01。版本 1.0.0-alpha01 中包含这些提交内容。

新功能

  • 此 C 库提供了相应功能，可查询运行游戏的设备的内存状态变化和接收回调。

API 变更

  • 这是内存建议库的初始版本。如需查看完整 API，请参阅 include/memory_advice/memory_advice.h 中的标头。

外部贡献

Games-Performance-Tuner

2.0 版

版本 2.0.0

2024 年 8 月 7 日

发布了 androidx.games:games-performance-tuner:2.0.0。版本 2.0.0 中包含这些提交内容。

2.0.0 的主要功能

  • 自 2.0.0-beta01 以来没有重大变更，我们只是将此版本标记为稳定版。

版本 2.0.0-rc01

2024 年 7 月 24 日

发布了 androidx.games:games-performance-tuner:2.0.0-rc01。版本 2.0.0-rc01 中包含这些提交内容。

版本 2.0.0-beta01

2024 年 1 月 10 日

发布了 androidx.games:games-performance-tuner:2.0.0-beta01，该版本与上个 Alpha 版相比没有变化。版本 2.0.0-beta01 中包含这些提交内容。

版本 2.0.0-alpha07

2023 年 11 月 29 日

发布了 androidx.games:games-performance-tuner:2.0.0-alpha07。版本 2.0.0-alpha07 中包含这些提交内容。

bug 修复

  • 修复了内存遥测报告有时会报告错误值的问题

版本 2.0.0-alpha06

2023 年 11 月 1 日

发布了 androidx.games:games-performance-tuner:2.0.0-alpha06。版本 2.0.0-alpha06 中包含这些提交内容。

版本 2.0.0-alpha05

2023 年 8 月 23 日

发布了 androidx.games:games-performance-tuner:2.0.0-alpha05。版本 2.0.0-alpha05 中包含这些提交内容。

新功能

  • 将 Protobuf 库迁移到了 Protobuf 精简版。

bug 修复

  • 修复了悬空指针问题。

版本 2.0.0-alpha04

2023 年 4 月 19 日

发布了 androidx.games:games-performance-tuner:2.0.0-alpha04。版本 2.0.0-alpha04 中包含这些提交内容。

新功能

  • 更新了库中的遥测数据收集功能，从而可以更精细地报告帧渲染时间。

bug 修复

  • 修复了以下 bug：如果最大插桩键数大于直方图计数，库会崩溃。

版本 2.0.0-alpha03

2023 年 2 月 22 日

发布了 androidx.games:games-performance-tuner:2.0.0-alpha03。版本 2.0.0-alpha03 中包含这些提交内容。

bug 修复

  • Games-Performance-Tuner 已移至新的发布流程。不应有任何行为变更。

版本 2.0.0-alpha02

2023 年 2 月 8 日

发布了 androidx.games:games-performance-tuner:2.0.0-alpha02。版本 2.0.0-alpha02 中包含这些提交内容。

API 变更

  • 添加了 TuningFork_predictQualityLevels API；这有助于预测要使用的正确质量级别/保真度参数。

版本 1.6

版本 1.6.1-alpha01

2022 年 11 月 9 日

发布了 androidx.games:games-performance-tuner:1.6.1-alpha01。版本 1.6.1-alpha01 中包含这些提交内容。

新功能

  • 没有新更改

版本 1.6.0

2022 年 6 月 15 日

发布了 androidx.games:games-performance-tuner:1.6.0。版本 1.6.0 中包含这些提交内容。

自 1.5.0 以来的重要变更

  • 修复了尝试获取内存遥测时 getpid 返回 0 的问题。
  • 在无有效加载组时阻止 StopLoadingGroup 执行。

版本 1.5.0

版本 1.5.0

2022 年 2 月 9 日

发布了 androidx.games:games-performance-tuner:1.5.0。版本 1.5.0 中包含这些提交内容。

自版本 1.4.0 以来的重要变更

  • 以编程方式更改了上传之间的时间间隔，而不是在初始设置中对其进行硬编码。
    • 添加了函数：TuningFork_setAggregationStrategyInterval
  • 修复了 API<=23 时 API 密钥存在的内存损坏问题

版本 1.5.0-rc01

2022 年 1 月 26 日

发布了 androidx.games:games-performance-tuner:1.5.0-rc01。版本 1.5.0-rc01 中包含这些提交内容。

bug 修复

  • 修复了 API 级别不高于 23 时 API 密钥存在的内存损坏问题

版本 1.5.0-beta02

2021 年 12 月 15 日

发布了 androidx.games:games-performance-tuner:1.5.0-beta02。版本 1.5.0-beta02 中包含这些提交内容。

API 变更

  • 从 TuningFork_Settings 中移除了 ABI 破坏性更改。

版本 1.5.0-beta01

2021 年 9 月 29 日

发布了 androidx.games:games-performance-tuner:1.5.0-beta01。版本 1.5.0-beta01 中包含这些提交内容。

新功能

  • 与 Alpha 版相比没有任何变化。该版本：
    • 以编程方式更改了上传之间的时间间隔，而不是在初始设置中对其进行硬编码。

API 变更

  • 与 Alpha 版相比没有任何变化。该版本：
    • 新增了函数：TuningFork_setAggregationStrategyInterval
    • 在 TuningFork_Settings: aggregation_strategy_intervalms_or_count 中新增了字段

版本 1.5.0-alpha01

2021 年 8 月 18 日

发布了 androidx.games:games-performance-tuner:1.5.0-alpha01。版本 1.5.0-alpha01 中包含这些提交内容。

新功能

  • 现在，可通过编程方式（而不是使用设置文件）设置 APT 上传之间的时间间隔。

API 变更

  • 添加了函数：TuningFork_setAggregationStrategyInterval
  • 向 TuningFork_Settings 结构体添加了字段：aggregation_strategy_intervalms_or_count

版本 1.4

版本 1.4.3

2021 年 7 月 12 日

发布了 androidx.games:games-performance-tuner:1.4.3。版本 1.4.3 中包含这些提交内容。

自 1.1.0 以来的重要变更

  • 已更新为与内部版本控制方案匹配。

版本 1.1

版本 1.1.0

2021 年 6 月 30 日

发布了 androidx.games:games-performance-tuner:1.1.0。版本 1.1.0 中包含这些提交内容。

版本 1.1.0-rc01

2021 年 6 月 2 日

发布了 androidx.games:games-performance-tuner:1.1.0-rc01。版本 1.1.0-rc01 中包含这些提交内容。

版本 1.1.0-beta03

2021 年 4 月 21 日

发布了 androidx.games:games-performance-tuner:1.1.0-beta03。

版本 1.1.0-beta02

2021 年 2 月 24 日

发布了 androidx.games:games-performance-tuner:1.1.0-beta02。

版本 1.1.0-beta01

2020 年 12 月 16 日

发布了 androidx.games:games-performance-tuner:1.1.0-beta01。

版本 1.1.0-alpha01

发布了 androidx.games:games-performance-tuner:1.1.0-alpha01。

Games-Controller

2.3 版

版本 2.3.0-alpha01

2025 年 8 月 13 日

发布了 androidx.games:games-controller:2.3.0-alpha01、androidx.games:games-memory-advice:2.3.0-alpha01 和 androidx.games:games-performance-tuner:2.3.0-alpha01。版本 2.3.0-alpha01 中包含这些提交内容。

新功能

  • 默认支持 16kb 页面大小。

版本 2.2

版本 2.2.0-alpha01

2025 年 3 月 26 日

发布了 androidx.games:games-controller:2.2.0-alpha01、androidx.games:games-memory-advice:2.2.0-alpha01 和 androidx.games:games-performance-tuner:2.2.0-alpha01。版本 2.2.0-alpha01 中包含这些提交内容。

新功能

2.0 版

版本 2.0.2

2024 年 6 月 12 日

发布了 androidx.games:games-controller:2.0.2。版本 2.0.2 中包含这些提交内容。

bug 修复

  • 修复了以下问题：对于在 Paddleboat_init 之前已连接的控制器，控制器连接回调未触发。
  • 修复了以下问题：在 Paddleboat_processGameActivityMotionInputEvent 中，游戏控制器触控板在未手动启用压力轴的情况下无法注册触控板按压操作。
  • 修复了游戏控制器触控板事件未被 Paddleboat_processGameActivityMotionInputEvent 标记为已消耗的问题。

版本 2.0.1

2023 年 9 月 20 日

发布了 `androidx.games:games-controller:2.0.1 '。版本 2.0.1 中包含这些提交内容。

游戏控制器 bug 修复：

  • 修复了 onInputDeviceChanged 处理程序中罕见的 NullReferenceException 情况。
  • 修复了导致某些 USB 键盘错误注册为游戏控制器的问题。

版本 2.0.0

2023 年 3 月 8 日

发布了 androidx.games:games-controller:2.0.0。版本 2.0.0 中包含这些提交内容。

2.0.0 的主要功能

  • 添加了检测硬件键盘连接状态的功能。
  • 添加了报告来自主设备（即手机）和控制器的运动数据（加速度计/陀螺仪）的功能。
  • 更改了控制器定义数据库的 API 和格式，以减少内存占用量并支持更多功能。

版本 2.0.0-alpha01

2023 年 1 月 11 日

发布了 androidx.games:games-controller:2.0.0-alpha01。版本 2.0.0-alpha01 中包含这些提交内容。

新功能

  • 硬件键盘检测
  • 集成式传感器动作数据报告支持（即接收来自手机本身的陀螺仪和加速度计数据）
  • 全新优化的控制器映射数据格式

API 变更

  • 对硬件键盘的新 API 调用：Paddleboat_getPhysicalKeyboardStatus 和 Paddleboat_setPhysicalKeyboardStatusCallback
  • 对集成式传感器动作数据报告的新 API 调用：Paddleboat_getIntegratedMotionSensorFlags 和 Paddleboat_setMotionDataCallbackWithIntegratedFlags
  • 对修改后控制器映射数据格式的新 API 调用：Paddleboat_addControllerRemapDataFromFd、Paddleboat_addControllerRemapDataFromFileBuffer
  • 废弃了旧的映射 API 调用：Paddleboat_addControllerRemapData 和 Paddleboat_getControllerRemapTableData

bug 修复

  • 修复了与 GameActivity 1.2.2 及更高版本中的动作事件的兼容性问题

版本 1.1

版本 1.1.0

2022 年 2 月 23 日

发布了 androidx.games:games-activity:1.1.0 和 androidx.games:games-controller:1.1.0。版本 1.1.0 中包含这些提交内容。

自 1.0.0 以来的重要变更

Games Activity：

  • 添加了监听和查询 notch 和 IME 响应的 WindowInsets
  • 添加了按键和动作事件过滤器
  • bug 修复：
    • 添加了缺少的消息，以与 NativeActivity 兼容
    • 修复了 onNativeWindowResized 签名问题
    • 修复了输入事件丢失问题

版本 1.1.0-rc01

2022 年 2 月 9 日

发布了 androidx.games:games-controller:1.1.0-rc01。版本 1.1.0-rc01 中包含这些提交内容。

版本 1.1.0-beta01

2022 年 1 月 26 日

发布了 androidx.games:games-controller:1.1.0-beta01，该版本与 1.1.0-alpha01 相比没有变化。版本 1.1.0-beta01 中包含这些提交内容。

版本 1.1.0-alpha01

2021 年 12 月 15 日

发布了 androidx.games:games-controller:1.1.0-alpha01。版本 1.1.0-alpha01 中包含这些提交内容。

新功能

现在，在 Android S 或更高版本上使用受支持的控制器时，可为控制器提供电池状态、双马达振动、灯光控制和运动轴报告功能。

API 变更

  • 添加了 Paddleboat_setMotionDataCallback 函数，用于注册控制器运动数据回调
  • 添加了 Paddleboat_setControllerLight 函数，用于更改控制器灯光设置。
  • 向 Paddleboat_Controller_Data 添加了 Paddleboat_Controller_Battery 结构
  • 新结构：
    • Paddleboat_Controller_Battery
    • Paddleboat_Motion_Data
  • 新枚举：
    • Paddleboat_BatteryStatus
    • Paddleboat_LightType
    • Paddleboat_Motion_Type
  • 新控制器标志：
    • PADDLEBOAT_CONTROLLER_FLAG_ACCELEROMETER
    • PADDLEBOAT_CONTROLLER_FLAG_GYROSCOPE
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_PLAYER
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_RGB
    • PADDLEBOAT_CONTROLLER_FLAG_BATTERY

bug 修复

  • 添加了适用于 PS4 控制器的备用 deviceId 数据库条目
  • 添加了适用于 PS5 控制器的 API >=31 数据库条目

版本 1.0

版本 1.0.0

2021 年 8 月 4 日

发布了 androidx.games:games-activity:1.0.0、androidx.games:games-controller:1.0.0 和 androidx.games:games-text-input:1.0.0。版本 1.0.0 中包含这些提交内容。

1.0.0 的主要功能

这是 Games-Activity、Games-Controller 和 Games-Text-Input 的稳定版的初始版本。如需了解详情，请参阅 AGDK 首页。

版本 1.0.0-rc02

2021 年 7 月 21 日

发布了 androidx.games:games-controller:1.0.0-rc02。版本 1.0.0-rc02 中包含这些提交内容。

bug 修复

  • 修复了导致 Prefab 导入在未使用的空架构/版本组合上失败的打包错误。

版本 1.0.0-rc01

2021 年 7 月 12 日

发布了 androidx.games:games-controller:1.0.0-rc01。版本 1.0.0-rc01 中包含这些提交内容。

bug 修复

  • 修复了最新 GameActivity 的不兼容问题

版本 1.0.0-beta01

2021 年 6 月 30 日

发布了 androidx.games:games-controller:1.0.0-beta01。版本 1.0.0-beta01 中包含这些提交内容。

API 变更

  • 返回成功或失败布尔值的函数现在会返回 Paddleboat_Error_Code 枚举。
  • Paddleboat_onPause 已重命名为 Paddleboat_onStop
  • Paddleboat_onResume 已重命名为 Paddleboat_onStart
  • Paddleship_processGameActivityEvent 拆分为两个函数：Paddleboat_processGameActivityKeyInputEvent 和 Paddleboat_processGameActivityMotionInputEvent
  • 移除了需要针对预览版 Android S SDK 进行构建的扩展控制器功能
  • 添加了 Paddleboat_getBackButtonConsumed 函数
  • 控制器和鼠标状态回调现在包含一个指向用户定义数据的指针的可选参数
  • 将控制器名称字符串移出了设备信息结构，现在通过 Paddleboat_getControllerName 函数访问

bug 修复

  • 修复了以下问题：当控制器一开始不将自己报告为控制器，但后来通过 onInputDeviceChanged 消息报告为控制器时，此控制器无法被正确检测为控制器连接。

版本 1.0.0-alpha01

2021 年 6 月 16 日

发布了 androidx.games:games-controller:1.0.0-alpha01。

新功能

  • Games-Controller 是一个新库，提供一个 C API，可用于检测游戏手柄设备、读取游戏手柄设备中的输入以及与游戏手柄设备互动。

Games-Frame-Pacing

2.3 版

版本 2.3.0-alpha01

2025 年 3 月 26 日

发布了 androidx.games:games-frame-pacing:2.3.0-alpha01。版本 2.3.0-alpha01 中包含这些提交内容。

新功能

bug 修复

2.1 版

版本 2.1.3

2025 年 7 月 2 日

发布了 androidx.games:games-frame-pacing:2.1.3。版本 2.1.3 中包含这些提交内容。

bug 修复

  • 启用对 16KB 页面大小的支持。

版本 2.1.2

2024 年 7 月 24 日

发布了 androidx.games:games-frame-pacing:2.1.2。版本 2.1.2 中包含这些提交内容。

bug 修复

  • Swappy 现在使用 API 33 中的 AChoreographer_postVsyncCallback 来更准确地计算呈现时间。这修复了 120Hz 设备上丢帧的 bug。

版本 2.1.1

2024 年 7 月 10 日

发布了 androidx.games:games-frame-pacing:2.1.1。版本 2.1.1 中包含这些提交内容。

bug 修复

  • 正确地从 Swappy 取消注册显示监听器，以避免挂起。
  • 修复了 ChoreographerFilter::onSettingsChanged 中使用已销毁互斥锁时发生的崩溃。

版本 2.1.0

2023 年 11 月 15 日

发布了 androidx.games:games-frame-pacing:2.1.0。版本 2.1.0 中包含这些提交内容。

版本 2.1.0-rc01

2023 年 9 月 20 日

发布了 androidx.games:games-frame-pacing:2.1.0-rc01。版本 2.1.0-rc01 中包含这些提交内容。

版本 2.1.0-beta01

2023 年 5 月 24 日

发布了 androidx.games:games-frame-pacing:2.1.0-beta01。版本 2.1.0-beta01 中包含这些提交内容。

bug 修复

  • 如果 NDKChoreographer 初始化失败，则超时（ef466d）
  • 使用来自系统的 SwappyGL_getSupportedRefreshPeriodsNS 查询刷新率（c85235）

版本 2.1.0-alpha01

2023 年 4 月 5 日

发布了 androidx.games:games-frame-pacing:2.1.0-alpha01。版本 2.1.0-alpha01 中包含这些提交内容。

新功能

  • 用于重置帧步调状态的新 API。
  • 新 API，用于在仍观察 CPU 和 GPU 时间的同时，停用 Swappy 的帧步调影响。

API 变更

  • 现在可以使用 SwappyGL_resetFramePacing/SwappyVk_resetFramePacing 重置内部帧步调状态。现在，帧步调将仅考虑自调用重置 API 以来产生的数据。
  • 现在可以使用 SwappyGL_enableFramePacing/SwappyVk_enableFramePacing 启用/停用 Swappy 的帧步调。停用此功能后，
  • SwappyGL_enableBlockingWait/SwappyVk_enableBlockingWait 可用于控制在帧步调调整功能停用时，是否会阻塞等待最后一帧的 GPU 工作完成。

bug 修复

  • 在使用 Swappy GL API 时，针对 GPU 绑定情况进行了性能改进。

2.0 版

版本 2.0.0

2023 年 3 月 8 日

发布了 androidx.games:games-frame-pacing:2.0.0。版本 2.0.0 中包含这些提交内容。

自 1.10.1 以来的重要变更

  • 构建系统经历了重大变化，导致每个 SDK/NDK 版本只生成一个库，而不是多个库。
  • 添加了 Vulkan 帧统计信息。
  • 添加了用于清除帧统计信息的新 API。
  • 日志在发布模式下全部处于静默状态，但在调试模式下可以启用。

版本 2.0.0-rc01

2023 年 2 月 22 日

发布了 androidx.games:games-frame-pacing:2.0.0-rc01。版本 2.0.0-rc01 中包含这些提交内容。

新功能

  • 日志记录现在隐藏在编译标志后面。默认情况下，库的发布 build 不会进行日志记录，而库的调试版本会启用所有日志记录。

版本 2.0.0-beta01

2023 年 2 月 8 日

发布了 androidx.games:games-frame-pacing:2.0.0-beta01。版本 2.0.0-beta01 中包含这些提交内容。

新功能

  • 推出了用于清除帧统计信息的新 API。

API 变更

  • 添加了 SwappyGL_clearStats 和 SwappyGL_clearStats API。

版本 2.0.0-alpha01

2023 年 1 月 11 日

发布了 androidx.games:games-frame-pacing:2.0.0-alpha01。版本 2.0.0-alpha01 中包含这些提交内容。

新功能

  • 新增了 Vulkan 帧统计信息

API 变更

  • 因 build 文件重构而提升了主要版本
  • 新增了 3 个 API：SwappyVk_enableStats、SwappyVk_recordFrameStart 和 SwappyVk_getStats

bug 修复

  • 仅在自动交换模式下应用阈值 (Ic0786)

版本 1.10

版本 1.10.2-alpha01

2022 年 11 月 9 日

发布了 androidx.games:games-frame-pacing:1.10.2-alpha01。版本 1.10.2-alpha01 中包含这些提交内容。

新功能

  • 没有新更改

版本 1.10.1

2022 年 6 月 15 日

发布了 androidx.games:games-frame-pacing:1.10.1。版本 1.10.1 中包含这些提交内容。

bug 修复

  • 修复了 swappy 无法使用级别低于 23 且高于 17 的 NDK 进行构建的问题。
  • 公开了 API，用于检索显示屏支持的刷新率。

版本 1.10.0

2022 年 2 月 23 日

发布了 androidx.games:games-frame-pacing:1.10.0。版本 1.10.0 中包含这些提交内容。

自 1.9.0 以来的重要变更

  • 忽略会造成污染的 Choreographer 过滤器输入，提升顺畅度以防止模拟器卡顿
  • 添加了 *_uninjectTracer 函数。

版本 1.10.0-rc01

2022 年 2 月 9 日

发布了 androidx.games:games-frame-pacing:1.10.0-rc01。版本 1.10.0-rc01 中包含这些提交内容。

版本 1.10.0-beta01

2022 年 1 月 26 日

发布了 androidx.games:games-frame-pacing:1.10.0-beta01。版本 1.10.0-beta01 中包含这些提交内容。

版本 1.10.0-alpha01

2021 年 12 月 15 日

发布了 androidx.games:games-frame-pacing:1.10.0-alpha01。版本 1.10.0-alpha01 中包含这些提交内容。

新功能

  • 添加了 SwappyGL_uninjectTracer 函数。

API 变更

  • 通过使用 SwappyGL_uninjectTracer(const SwappyTracer *t) API，移除了之前使用 SwappyGL_injectTracer 添加的回调。

1.9 版

版本 1.9.1

2021 年 10 月 13 日

发布了 androidx.games:games-frame-pacing:1.9.1。版本 1.9.1 中包含这些提交内容。

bug 修复

版本 1.9.0

2021 年 7 月 12 日

发布了 androidx.games:games-frame-pacing:1.9.0。版本 1.9.0 中包含这些提交内容。

自 1.7.0 以来的重要变更

  • 已更新为与内部版本控制方案匹配。

版本 1.7

版本 1.7.0

2021 年 6 月 30 日

发布了 androidx.games:games-frame-pacing:1.7.0。版本 1.7.0 中包含这些提交内容。

版本 1.7.0-rc01

2021 年 6 月 2 日

发布了 androidx.games:games-frame-pacing:1.7.0-rc01。版本 1.7.0-rc01 中包含这些提交内容。

版本 1.7.0-beta02

2021 年 2 月 24 日

发布了 androidx.games:games-frame-pacing:1.7.0-beta02。

版本 1.7.0-beta01

2020 年 12 月 16 日

发布了 androidx.games:games-frame-pacing:1.7.0-beta01。

版本 1.0.0

版本 1.0.0-alpha02

2020 年 8 月 12 日

Android Gaming 库重命名为 Android Games 库。

androidx.gaming -> androidx.games

版本 1.0.0-alpha01

2020 年 6 月 10 日

发布了 androidx.games:1.0.0-alpha01。