创建启动配置文件

启动配置文件是基线配置文件的一个子集。构建系统使用启动配置文件通过改进 APK 的 DEX 文件中代码的布局来进一步优化它们包含的类和方法。使用启动配置文件,您的应用启动速度比仅使用基线配置文件快 15%。

图 1. DEX 布局优化带来的代码局部性改进。

要求

我们建议您将启动配置文件与以下工具一起使用

  • Jetpack Macrobenchmark 1.2.0 或更高版本
  • Android Gradle 插件 8.2 或更高版本
  • Android Studio Iguana 或更高版本

此外,您的应用中需要以下设置

  • R8 已启用。对于您的发布版本,请设置 isMinifyEnabled = true
  • DEX 布局优化已启用。在应用模块的构建文件的 baselineProfile {} 块中,设置 dexLayoutOptimization = true

创建启动配置文件

当您使用默认的基线配置文件生成器模板时,Android Studio 会在基线配置文件旁边创建一个启动配置文件。

创建和生成启动配置文件的常规步骤与创建基线配置文件的步骤相同。

创建启动配置文件的默认方法是使用 Android Studio 中的基线配置文件生成器模块模板。这包括构成基本启动配置文件的启动交互。要使用更多关键用户旅程 (CUJ) 增强此启动配置文件,请将应用启动 CUJ 添加到 rule 块中,并将 includeInStartupProfile 设置为 true。对于简单的应用,启动应用的 MainActivity 可能就足够了。对于更复杂的应用,请考虑将最常见的入口点添加到您的应用中,例如从主屏幕启动应用或启动到深层链接

以下代码片段显示了一个基线配置文件生成器(默认情况下为 BaselineProfileGenerator.kt 文件),其中包括从主屏幕启动应用和启动到深层链接。深层链接直接进入应用的新闻提要,而不是应用的主屏幕。

@RunWith(AndroidJUnit4::class)
@LargeTest
class BaselineProfileGenerator {

    @get:Rule
    val rule = BaselineProfileRule()

    @Test
    fun generate() {
        rule.collect(
            packageName = "com.example.app",
            includeInStartupProfile = true
        ) {
            // Launch directly into the NEWS_FEED.
            startActivityAndWait(Intent().apply {
                setPackage(packageName)
                setAction("com.example.app.NEWS_FEED")
            })
        }
    }
}

运行为应用生成基线配置文件配置,并在 src/<variant>/generated/baselineProfiles/startup-prof.txt 中找到启动配置文件规则。

确认启动配置文件优化

要确认 DEX 布局优化,请使用 Android Studio 打开 APK 并验证 DEX 文件中的类。确保主 classes.dex 未完全填满。如果您的应用包含单个 DEX 文件,则可以在启用启动配置文件后检查应用是否包含两个 DEX 文件。

如果启动类不适合单个 DEX 文件,Android Studio 会发出警告。要获取包含启动类中非启动方法数量的诊断信息,请确保 R8 编译器已更新至至少 8.3.36-dev 版本,方法是在应用启动配置文件时对 settings.gradle 文件进行以下更改

Kotlin

pluginManagement {
    buildscript {
        repositories {
            mavenCentral()
            maven {
                url = uri("https://storage.googleapis.com/r8-releases/raw")
            }
        }
        dependencies {
            classpath("com.android.tools:r8:8.3.6-dev")
        }
    }
}

Groovy

pluginManagement {
    buildscript {
        repositories {
            mavenCentral()
            maven {
                url uri('https://storage.googleapis.com/r8-releases/raw')
            }
        }
        dependencies {
            classpath 'com.android.tools:r8:8.3.6-dev"
        }
    }
}

使用 Gradle 构建时,请确保在以下命令中 assembleRelease 后添加 --info

./gradlew assembleRelease --info

然后将诊断信息打印到终端。

如果您的应用或任何库引用了任何反糖化 API,则这些类的捆绑兼容性实现始终包含在最后一个 DEX 文件中。此反糖化的最后一个 DEX 文件不参与 DEX 布局优化。