Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

创建基准配置文件

基准配置文件对于最大限度地提高 Jetpack Compose 性能至关重要。预编译关键用户历程有助于确保 Compose 界面顺利呈现。

使用 Jetpack Macrobenchmark 库和 BaselineProfileRule 可为每个应用版本自动生成配置文件。建议使用 com.android.tools.build:gradle:8.0.0 或更高版本，以便在使用基准配置文件时利用 build 改进。

创建新基准配置文件的大致步骤如下：

设置基准配置文件模块。
定义有助于生成基准配置文件的 JUnit 测试。
添加想要优化的关键用户历程 (CUJ)。
生成基准配置文件。

生成基准配置文件后，请使用实体设备对其进行基准测试，以衡量速度方面的改进。

使用 AGP 8.2 或更高版本创建新的基准配置文件

要创建新的基准配置文件，最简单的方式就是使用基准配置文件模块模板，该模板从 Android Studio Iguana 和 Android Gradle 插件 (AGP) 8.2 开始提供。

Android Studio 基准配置文件生成器模块模板会自动创建一个新模块，以便生成基准配置文件并对其进行基准测试。运行该模板会生成大部分典型的 build 配置代码、基准配置文件生成代码，以及验证代码。该模板会创建用于生成基准配置文件并对其进行基准测试的代码，以便衡量应用启动情况。

设置基准配置文件模块

如需运行基准配置文件模块模板，请按以下步骤操作：

依次选择 File > New > New Module 。
在 Templates 面板中选择 Baseline Profile Generator 模板，并对其进行配置：

图 1.基准配置文件生成器模块模板。

模板中的字段如下：
- 目标应用：要为其生成基准配置文件的应用。如果项目中只有一个应用模块，此列表中将只有一项。
- Module name：指定要创建的基准配置文件模块将使用的名称。
- 软件包名称：指定基准配置文件模块将使用的软件包名称。
- 语言：选择生成的代码是 Kotlin 还是 Java。
- Build configuration language：选择 build 配置脚本是使用 Kotlin Script (KTS) 还是 Groovy。
- 使用 Gradle 管理的设备：选择是否使用 Gradle 管理的设备来测试应用。
点击 Finish ，系统即会创建一个新模块。如果您使用了源代码控制工具，系统可能会提示您将新创建的模块文件添加到源代码控制工具中。

定义基准配置文件生成器

新创建的模块中包含用于生成基准配置文件并对其进行基准测试的测试，以及仅用于测试基本的应用启动情况的测试。建议将这些代码扩充为包含 CUJ 和高级启动工作流。确保与应用启动相关的所有测试都在 rule 块中，并将 includeInStartupProfile 设置为 true；相反，为了获得最佳性能，请确保与应用启动无关的任何测试都不会包含在启动配置文件中。应用启动优化用于定义基准配置文件的特殊部分，称为启动配置文件。

如果您将这些 CUJ 提取到生成的基准配置文件和基准测试代码之外，以便它们可以用于这两者，将有助于提高可维护性。这意味着系统会以一致的方式使用您对 CUJ 所做的更改。

生成并安装基准配置文件

基准配置文件模块模板中添加了一项新的运行配置，用于生成基准配置文件。如果您使用产品变种，Android Studio 会创建多项运行配置，以便您可以为每个变种生成单独的基准配置文件。

图 2. 运行此配置会生成基准配置文件。

Generate Baseline Profile 运行配置在完成运行后，会将生成的基准配置文件复制到要分析的模块中的 src/variant/generated/baselineProfiles/baseline-prof.txt 文件。变体选项要么是发布 build 类型，要么是涉及发布 build 类型的 build 变体。

生成的基准配置文件最初是在 build/outputs 中创建的。完整路径取决于要分析的应用变体或变种，以及您是使用 Gradle 管理的设备还是使用已连接的设备进行分析。如果您使用代码所用的名称和由模板生成的 build 配置，系统会在 build/outputs/managed_device_android_test_additional_output/nonminifiedrelease/pixel6Api31/BaselineProfileGenerator_generate-baseline-prof.txt 文件中创建基准配置文件。您可能不必直接与生成的此版本基准配置文件产生任何交互，除非您手动将其复制到目标模块（不推荐）。

使用 AGP 8.1 创建新的基准配置文件

如果您无法使用基准配置文件模块模板，请使用 Macrobenchmark 模块模板和基准配置文件 Gradle 插件来创建新的基准配置文件。建议针对 Android Studio Giraffe 和 AGP 8.1 以上版本使用这些工具。

如需使用 Macrobenchmark 模块模板和基准配置文件 Gradle 插件创建新的基准配置文件，请执行以下步骤：

在 Gradle 项目中设置一个 Macrobenchmark 模块。

定义一个名为 BaselineProfileGenerator 的新类：

class BaselineProfileGenerator {
    @get:Rule
    val baselineProfileRule = BaselineProfileRule()

    @Test
    fun startup() = baselineProfileRule.collect(
        packageName = "com.example.app",
        profileBlock = {
            startActivityAndWait()
        }
    )
}

该生成器可以包含应用启动之外的应用互动。这样，您就可以优化应用的运行时性能，例如滚动列表、运行动画、在 Activity 内导航等等。查看其他的测试示例，了解如何使用 @BaselineProfileRule 改善关键用户历程。

添加基准配置文件 Gradle 插件 (libs.plugins.androidx.baselineprofile)。使用该插件，您可以更轻松地生成基准配置文件并在将来维护它们。
如需生成基准配置文件，请在终端运行 :app:generateBaselineProfile 或 :app:generateVariantBaselineProfile Gradle 任务。

在已启用 root 权限的实体设备、模拟器或 Gradle 管理的设备上，将生成器作为插桩测试运行。如果使用的是 Gradle 管理的设备，请将 aosp 设置为 systemImageSource，因为需要对基准配置文件生成器的 root 访问权限。

注意：使用 Jetpack Macrobenchmark 1.2.0-alpha06 及更高版本时，您无需拥有 root 访问权限，即可在搭载 Android 13 (API 33) 及更高版本的设备上生成基准配置文件。

生成任务结束时，基准配置文件将复制到 app/src//generated/baselineProfiles。

不使用模板创建新的基准配置文件

虽然建议使用 Android Studio 基准配置文件模块模板（首选）或 Macrobenchmark 模板来创建基准配置文件，但您也可以仅使用基准配置文件 Gradle 插件。如需详细了解基准配置文件 Gradle 插件，请参阅配置基准配置文件的生成方式。

直接使用基准配置文件 Gradle 插件创建基准配置文件的方法如下：

创建一个新的 com.android.test 模块，例如 :baseline-profile。

为 :baseline-profile 配置 build.gradle.kts 文件：

应用 androidx.baselineprofile 插件。
确保 targetProjectPath 指向 :app 模块。
（可选）添加 Gradle 管理的设备 (GMD)。在以下示例中，它是 pixel6Api31。如果未指定，该插件将使用一部已连接的设备，无论是模拟设备还是实体设备。
应用所需的配置，如以下示例所示。

Kotlin

plugins {
    id("com.android.test")
    id("androidx.baselineprofile")
}

android {
    defaultConfig {
        ...
    }

    // Point to the app module, the module that you're generating the Baseline Profile for.
    targetProjectPath = ":app"
    // Configure a GMD (optional).
    testOptions.managedDevices.devices {
        pixel6Api31(com.android.build.api.dsl.ManagedVirtualDevice) {
            device = "Pixel 6"
            apiLevel = 31
            systemImageSource = "aosp"
        }
    }
}

dependencies { ... }

// Baseline Profile Gradle plugin configuration. Everything is optional. This
// example uses the GMD added earlier and disables connected devices.
baselineProfile {
    // Specifies the GMDs to run the tests on. The default is none.
    managedDevices += "pixel6Api31"
    // Enables using connected devices to generate profiles. The default is
    // `true`. When using connected devices, they must be rooted or API 33 and
    // higher.
    useConnectedDevices = false
}

Groovy

plugins {
    id 'com.android.test'
    id 'androidx.baselineprofile'
}

android {
    defaultConfig {
        ...
    }

    // Point to the app module, the module that you're generating the Baseline Profile for.
    targetProjectPath ':app'
    // Configure a GMD (optional).
    testOptions.managedDevices.devices {
        pixel6Api31(com.android.build.api.dsl.ManagedVirtualDevice) {
            device 'Pixel 6'
            apiLevel 31
            systemImageSource 'aosp'
        }
    }
}

dependencies { ... }

// Baseline Profile Gradle plugin configuration. Everything is optional. This
// example uses the GMD added earlier and disables connected devices.
baselineProfile {
    // Specifies the GMDs to run the tests on. The default is none.
    managedDevices ['pixel6Api31']
    // Enables using connected devices to generate profiles. The default is
    // `true`. When using connected devices, they must be rooted or API 33 and
    // higher.
    useConnectedDevices false
}

在 :baseline-profile 测试模块中创建基准配置文件测试。以下示例是一个测试，用于为应用启动生成基准配置文件。

    class BaselineProfileGenerator {
    @get:Rule
    val baselineProfileRule = BaselineProfileRule()

    @Test
    fun startup() = baselineProfileRule.collect(
        packageName = "com.example.app",
        profileBlock = {
            uiAutomator { startApp(PACKAGE_NAME) }
        }
    )
}

更新应用模块中的 build.gradle.kts 文件，例如 :app。

应用插件 androidx.baselineprofile。
将 baselineProfile 依赖项添加到 :baseline-profile 模块。

Kotlin

plugins {
    id("com.android.application")
    id("androidx.baselineprofile")
}

android {
    // There are no changes to the `android` block.
    ...
}

dependencies {
    ...
    // Add a `baselineProfile` dependency on the `:baseline-profile` module.
    baselineProfile(project(":baseline-profile"))
}

Groovy

plugins {
    id 'com.android.application'
    id 'androidx.baselineprofile'
}

android {
    // No changes to the `android` block.
    ...
}

dependencies {
    ...
    // Add a `baselineProfile` dependency on the `:baseline-profile` module.
    baselineProfile ':baseline-profile'
}

运行 :app:generateBaselineProfile 或 :app:generateVariantBaselineProfile Gradle 任务，生成配置文件。
生成任务结束时，基准配置文件将复制到 app/src/variant/generated/baselineProfiles。

对基准配置文件进行基准测试

如需对基准配置文件进行基准测试，请通过负责执行 StartupBenchmarks.kt 文件中定义的基准测试的边线操作，创建新的 Android 插桩测试运行配置。如需详细了解基准测试，请参阅创建 Macrobenchmark 类和使用 Macrobenchmark 库对基准配置文件进行基准测试。

当您在 Android Studio 中运行测试时，build 输出中会包含基准配置文件带来的速度提升的详细信息：

StartupBenchmarks_startupCompilationBaselineProfiles
timeToInitialDisplayMs   min 161.8,   median 178.9,   max 194.6
StartupBenchmarks_startupCompilationNone
timeToInitialDisplayMs   min 184.7,   median 196.9,   max 202.9

捕获所有必需的代码路径

衡量应用启动时间的两个关键指标如下：

初始显示时间 (TTID)：显示应用界面的第一帧所需的时间。
完全显示时间 (TTFD)：TTID 加上显示第一帧后显示异步加载的内容所用的时间。

系统会在调用 reportFullyDrawn 的 ComponentActivity 方法后报告 TTFD。如果从未调用 reportFullyDrawn，则会改为报告 TTID。如果系统调用 reportFullyDrawn，可能需要延迟到异步加载完成之后再报告相应时间。例如，如果界面包含一个动态延迟列表，那么可能就要在首次绘制列表之后、因此也就是在界面被标记为完全绘制之后，才通过后台任务来填充该列表。在这种情况下，基准配置文件中将不包含在界面达到完全绘制状态后运行的代码。

如需将列表填充也纳入基准配置文件中，请使用 getFullyDrawnReporter 获取 FullyDrawnReporter，并在应用代码中为其添加报告程序。一旦后台任务完成列表填充，便释放报告程序。FullyDrawnReporter 在所有报告程序释放之前不会调用 reportFullyDrawn 方法。这样一来，基准配置文件会包含填充列表所需的代码路径。这不会改变面向用户的应用行为，但可让基准配置文件包含所有必要的代码路径。

如需指示完全绘制状态，请使用以下 Compose API：

ReportDrawn 表示可组合项已准备好立即进行互动。
ReportDrawnWhen 接受一个谓词（例如 list.count > 0），以指明可组合项何时准备好进行互动。
ReportDrawnAfter 接受一个暂停方法，该方法完成即表示可组合项已准备好进行互动。

为你推荐

注意：当 JavaScript 处于关闭状态时，系统会显示链接文字
捕获 Macrobenchmark 指标
编写 Macrobenchmark
JankStats 库

概览

为库创建基准配置文件

创建基准配置文件 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

使用 AGP 8.2 或更高版本创建新的基准配置文件

设置基准配置文件模块

定义基准配置文件生成器

生成并安装基准配置文件

使用 AGP 8.1 创建新的基准配置文件

不使用模板创建新的基准配置文件

Kotlin

Groovy

Kotlin

Groovy

对基准配置文件进行基准测试

捕获所有必需的代码路径

为你推荐

创建基准配置文件