generating-baseline-profiles

Generate baseline profiles for Jetpack Compose using the AGP 8.2+ Baseline Profile Generator and Macrobenchmark harness to enable ahead-of-time compilation. This measures cold startup and first-scroll performance on real devices, ensuring faster startup.

CompilationMode Partial(BaselineProfileMode.Require) enforces the use of baseline profiles during macrobenchmark measurement. It ensures the profile is actively applied and validates that startup improvements are strictly derived from the generated baseline profile.

Yes, generating and validating baseline profiles requires running release builds on real physical devices. The Macrobenchmark harness measures actual cold startup and first-scroll performance, which cannot be accurately captured on emulators or debug builds.

Validate baseline profiles by confirming the assets/dexopt/baseline.prof and baseline.profm files are correctly packaged inside the APK. Additionally, verify the necessary profile wiring is present within the app module to enable ahead-of-time compilation.

Measure first-scroll smoothness using the Macrobenchmark harness configured with BaselineProfileRule. The system reports medians across multiple iterations, validating that the baseline profile effectively enhances Compose scrolling performance.

Startup may not improve if the baseline profile is not properly shipped in the APK or if measurement does not enforce CompilationMode Partial(BaselineProfileMode.Require). Ensure the profile wiring is present in the app module and tested on release builds.