Android Games

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

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

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

工件	当前稳定版	下一候选版本	Beta 版	Alpha 版
games-frame-pacing	-	-	1.7.0-beta01	-
games-performance-tuner	-	-	1.1.0-beta01	-

此库的最后更新时间：2020 年 12 月 16 日

声明依赖项

如需添加游戏的依赖项，您必须将 Google Maven 代码库添加到项目中。如需了解详情，请参阅 Google 的 Maven 代码库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

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:1.7.0-beta01"

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

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

添加 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 添加软件包

要使导入的游戏 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 游戏 SDK 静态库，以将其添加到您的共享库中：

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

反馈

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

创建新问题

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

Games Frame Pacing 1.7.0

版本 1.7.0-beta01

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

Games Performance Tuner 1.1.0

版本 1.1.0-beta01

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

版本 1.1.0-alpha01

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

版本 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。