From 67ad73283d18c05045ff9a80251e3f699c7a8c32 Mon Sep 17 00:00:00 2001 From: Peng Quah Date: Tue, 27 Oct 2026 14:06:32 +0000 Subject: [PATCH 1/4] Add performance documentation snippets module --- snippets/.gitignore | 15 ++ snippets/build.gradle.kts | 61 +++++ snippets/gradle.properties | 17 ++ snippets/gradle/libs.versions.toml | 42 +++ snippets/gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 43705 bytes .../gradle/wrapper/gradle-wrapper.properties | 7 + snippets/gradlew | 251 ++++++++++++++++++ snippets/gradlew.bat | 94 +++++++ snippets/settings.gradle.kts | 33 +++ .../BaselineProfilesOverview.kt | 51 ++++ .../MeasureBaselineProfile.kt | 80 ++++++ .../startupprofiles/DexLayoutOptimizations.kt | 54 ++++ snippets/src/main/AndroidManifest.xml | 30 +++ .../appstartup/AnalysisOptimization.kt | 73 +++++ .../android/performance/vitals/LaunchTime.kt | 80 ++++++ 15 files changed, 888 insertions(+) create mode 100644 snippets/.gitignore create mode 100644 snippets/build.gradle.kts create mode 100644 snippets/gradle.properties create mode 100644 snippets/gradle/libs.versions.toml create mode 100644 snippets/gradle/wrapper/gradle-wrapper.jar create mode 100644 snippets/gradle/wrapper/gradle-wrapper.properties create mode 100755 snippets/gradlew create mode 100644 snippets/gradlew.bat create mode 100644 snippets/settings.gradle.kts create mode 100644 snippets/src/androidTest/java/com/example/android/performance/baselineprofiles/BaselineProfilesOverview.kt create mode 100644 snippets/src/androidTest/java/com/example/android/performance/baselineprofiles/MeasureBaselineProfile.kt create mode 100644 snippets/src/androidTest/java/com/example/android/performance/startupprofiles/DexLayoutOptimizations.kt create mode 100644 snippets/src/main/AndroidManifest.xml create mode 100644 snippets/src/main/java/com/example/android/performance/appstartup/AnalysisOptimization.kt create mode 100644 snippets/src/main/java/com/example/android/performance/vitals/LaunchTime.kt diff --git a/snippets/.gitignore b/snippets/.gitignore new file mode 100644 index 00000000..aa724b77 --- /dev/null +++ b/snippets/.gitignore @@ -0,0 +1,15 @@ +*.iml +.gradle +/local.properties +/.idea/caches +/.idea/libraries +/.idea/modules.xml +/.idea/workspace.xml +/.idea/navEditor.xml +/.idea/assetWizardSettings.xml +.DS_Store +/build +/captures +.externalNativeBuild +.cxx +local.properties diff --git a/snippets/build.gradle.kts b/snippets/build.gradle.kts new file mode 100644 index 00000000..43d2c39e --- /dev/null +++ b/snippets/build.gradle.kts @@ -0,0 +1,61 @@ +/* + * Copyright 2026 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +plugins { + alias(libs.plugins.android.application) + alias(libs.plugins.kotlin.android) + alias(libs.plugins.compose.compiler) +} + +kotlin { + jvmToolchain(17) +} + +android { + namespace = "com.example.android.performance" + compileSdk = libs.versions.compileSdk.get().toInt() + + defaultConfig { + applicationId = "com.example.android.performance" + minSdk = libs.versions.minSdk.get().toInt() + targetSdk = libs.versions.targetSdk.get().toInt() + versionCode = 1 + versionName = "1.0" + testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner" + } + + compileOptions { + sourceCompatibility = JavaVersion.VERSION_17 + targetCompatibility = JavaVersion.VERSION_17 + } + + buildFeatures { + compose = true + } +} + +dependencies { + val composeBom = platform(libs.androidx.compose.bom) + implementation(composeBom) + implementation(libs.androidx.compose.runtime) + implementation(libs.androidx.activity.compose) + implementation(libs.androidx.lifecycle.runtime.ktx) + + androidTestImplementation(libs.androidx.benchmark.macro.junit4) + androidTestImplementation(libs.androidx.test.ext.junit) + androidTestImplementation(libs.androidx.test.runner) + androidTestImplementation(libs.androidx.uiautomator) +} diff --git a/snippets/gradle.properties b/snippets/gradle.properties new file mode 100644 index 00000000..e8be5cc3 --- /dev/null +++ b/snippets/gradle.properties @@ -0,0 +1,17 @@ +# Copyright 2026 The Android Open Source Project +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8 +android.useAndroidX=true +kotlin.code.style=official diff --git a/snippets/gradle/libs.versions.toml b/snippets/gradle/libs.versions.toml new file mode 100644 index 00000000..2e74dd06 --- /dev/null +++ b/snippets/gradle/libs.versions.toml @@ -0,0 +1,42 @@ +# Copyright 2026 The Android Open Source Project +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# https://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +[versions] +agp = "8.13.1" +activity = "1.11.0" +benchmark = "1.4.1" +compileSdk = "36" +composeBom = "2025.11.00" +junit = "1.3.0" +kotlin = "2.2.21" +lifecycle = "2.9.4" +minSdk = "24" +targetSdk = "36" +testRunner = "1.7.0" +uiAutomator = "2.4.0-alpha06" + +[libraries] +androidx-activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activity" } +androidx-benchmark-macro-junit4 = { group = "androidx.benchmark", name = "benchmark-macro-junit4", version.ref = "benchmark" } +androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" } +androidx-compose-runtime = { group = "androidx.compose.runtime", name = "runtime" } +androidx-lifecycle-runtime-ktx = { group = "androidx.lifecycle", name = "lifecycle-runtime-ktx", version.ref = "lifecycle" } +androidx-test-ext-junit = { group = "androidx.test.ext", name = "junit", version.ref = "junit" } +androidx-test-runner = { group = "androidx.test", name = "runner", version.ref = "testRunner" } +androidx-uiautomator = { group = "androidx.test.uiautomator", name = "uiautomator", version.ref = "uiAutomator" } + +[plugins] +android-application = { id = "com.android.application", version.ref = "agp" } +compose-compiler = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" } +kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" } diff --git a/snippets/gradle/wrapper/gradle-wrapper.jar b/snippets/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..9bbc975c742b298b441bfb90dbc124400a3751b9 GIT binary patch literal 43705 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 DHx0+F literal 0 HcmV?d00001 diff --git a/snippets/gradle/wrapper/gradle-wrapper.properties b/snippets/gradle/wrapper/gradle-wrapper.properties new file mode 100644 index 00000000..d4081da4 --- /dev/null +++ b/snippets/gradle/wrapper/gradle-wrapper.properties @@ -0,0 +1,7 @@ +distributionBase=GRADLE_USER_HOME +distributionPath=wrapper/dists +distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.3-bin.zip +networkTimeout=10000 +validateDistributionUrl=true +zipStoreBase=GRADLE_USER_HOME +zipStorePath=wrapper/dists diff --git a/snippets/gradlew b/snippets/gradlew new file mode 100755 index 00000000..faf93008 --- /dev/null +++ b/snippets/gradlew @@ -0,0 +1,251 @@ +#!/bin/sh + +# +# Copyright © 2015-2021 the original authors. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# https://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# SPDX-License-Identifier: Apache-2.0 +# + +############################################################################## +# +# Gradle start up script for POSIX generated by Gradle. +# +# Important for running: +# +# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is +# noncompliant, but you have some other compliant shell such as ksh or +# bash, then to run this script, type that shell name before the whole +# command line, like: +# +# ksh Gradle +# +# Busybox and similar reduced shells will NOT work, because this script +# requires all of these POSIX shell features: +# * functions; +# * expansions «$var», «${var}», «${var:-default}», «${var+SET}», +# «${var#prefix}», «${var%suffix}», and «$( cmd )»; +# * compound commands having a testable exit status, especially «case»; +# * various built-in commands including «command», «set», and «ulimit». +# +# Important for patching: +# +# (2) This script targets any POSIX shell, so it avoids extensions provided +# by Bash, Ksh, etc; in particular arrays are avoided. +# +# The "traditional" practice of packing multiple parameters into a +# space-separated string is a well documented source of bugs and security +# problems, so this is (mostly) avoided, by progressively accumulating +# options in "$@", and eventually passing that to Java. +# +# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS, +# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly; +# see the in-line comments for details. +# +# There are tweaks for specific operating systems such as AIX, CygWin, +# Darwin, MinGW, and NonStop. +# +# (3) This script is generated from the Groovy template +# https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt +# within the Gradle project. +# +# You can find Gradle at https://github.com/gradle/gradle/. +# +############################################################################## + +# Attempt to set APP_HOME + +# Resolve links: $0 may be a link +app_path=$0 + +# Need this for daisy-chained symlinks. +while + APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path + [ -h "$app_path" ] +do + ls=$( ls -ld "$app_path" ) + link=${ls#*' -> '} + case $link in #( + /*) app_path=$link ;; #( + *) app_path=$APP_HOME$link ;; + esac +done + +# This is normally unused +# shellcheck disable=SC2034 +APP_BASE_NAME=${0##*/} +# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036) +APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s\n' "$PWD" ) || exit + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD=maximum + +warn () { + echo "$*" +} >&2 + +die () { + echo + echo "$*" + echo + exit 1 +} >&2 + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +nonstop=false +case "$( uname )" in #( + CYGWIN* ) cygwin=true ;; #( + Darwin* ) darwin=true ;; #( + MSYS* | MINGW* ) msys=true ;; #( + NONSTOP* ) nonstop=true ;; +esac + +CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar + + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD=$JAVA_HOME/jre/sh/java + else + JAVACMD=$JAVA_HOME/bin/java + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD=java + if ! command -v java >/dev/null 2>&1 + then + die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +fi + +# Increase the maximum file descriptors if we can. +if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then + case $MAX_FD in #( + max*) + # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked. + # shellcheck disable=SC2039,SC3045 + MAX_FD=$( ulimit -H -n ) || + warn "Could not query maximum file descriptor limit" + esac + case $MAX_FD in #( + '' | soft) :;; #( + *) + # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked. + # shellcheck disable=SC2039,SC3045 + ulimit -n "$MAX_FD" || + warn "Could not set maximum file descriptor limit to $MAX_FD" + esac +fi + +# Collect all arguments for the java command, stacking in reverse order: +# * args from the command line +# * the main class name +# * -classpath +# * -D...appname settings +# * --module-path (only if needed) +# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables. + +# For Cygwin or MSYS, switch paths to Windows format before running java +if "$cygwin" || "$msys" ; then + APP_HOME=$( cygpath --path --mixed "$APP_HOME" ) + CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" ) + + JAVACMD=$( cygpath --unix "$JAVACMD" ) + + # Now convert the arguments - kludge to limit ourselves to /bin/sh + for arg do + if + case $arg in #( + -*) false ;; # don't mess with options #( + /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath + [ -e "$t" ] ;; #( + *) false ;; + esac + then + arg=$( cygpath --path --ignore --mixed "$arg" ) + fi + # Roll the args list around exactly as many times as the number of + # args, so each arg winds up back in the position where it started, but + # possibly modified. + # + # NB: a `for` loop captures its iteration list before it begins, so + # changing the positional parameters here affects neither the number of + # iterations, nor the values presented in `arg`. + shift # remove old arg + set -- "$@" "$arg" # push replacement arg + done +fi + + +# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"' + +# Collect all arguments for the java command: +# * DEFAULT_JVM_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments, +# and any embedded shellness will be escaped. +# * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be +# treated as '${Hostname}' itself on the command line. + +set -- \ + "-Dorg.gradle.appname=$APP_BASE_NAME" \ + -classpath "$CLASSPATH" \ + org.gradle.wrapper.GradleWrapperMain \ + "$@" + +# Stop when "xargs" is not available. +if ! command -v xargs >/dev/null 2>&1 +then + die "xargs is not available" +fi + +# Use "xargs" to parse quoted args. +# +# With -n1 it outputs one arg per line, with the quotes and backslashes removed. +# +# In Bash we could simply go: +# +# readarray ARGS < <( xargs -n1 <<<"$var" ) && +# set -- "${ARGS[@]}" "$@" +# +# but POSIX shell has neither arrays nor command substitution, so instead we +# post-process each arg (as a line of input to sed) to backslash-escape any +# character that might be a shell metacharacter, then use eval to reverse +# that process (while maintaining the separation between arguments), and wrap +# the whole thing up as a single "set" statement. +# +# This will of course break if any of these variables contains a newline or +# an unmatched quote. +# + +eval "set -- $( + printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" | + xargs -n1 | + sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' | + tr '\n' ' ' + )" '"$@"' + +exec "$JAVACMD" "$@" diff --git a/snippets/gradlew.bat b/snippets/gradlew.bat new file mode 100644 index 00000000..9b42019c --- /dev/null +++ b/snippets/gradlew.bat @@ -0,0 +1,94 @@ +@rem +@rem Copyright 2015 the original author or authors. +@rem +@rem Licensed under the Apache License, Version 2.0 (the "License"); +@rem you may not use this file except in compliance with the License. +@rem You may obtain a copy of the License at +@rem +@rem https://www.apache.org/licenses/LICENSE-2.0 +@rem +@rem Unless required by applicable law or agreed to in writing, software +@rem distributed under the License is distributed on an "AS IS" BASIS, +@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +@rem See the License for the specific language governing permissions and +@rem limitations under the License. +@rem +@rem SPDX-License-Identifier: Apache-2.0 +@rem + +@if "%DEBUG%"=="" @echo off +@rem ########################################################################## +@rem +@rem Gradle startup script for Windows +@rem +@rem ########################################################################## + +@rem Set local scope for the variables with windows NT shell +if "%OS%"=="Windows_NT" setlocal + +set DIRNAME=%~dp0 +if "%DIRNAME%"=="" set DIRNAME=. +@rem This is normally unused +set APP_BASE_NAME=%~n0 +set APP_HOME=%DIRNAME% + +@rem Resolve any "." and ".." in APP_HOME to make it shorter. +for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi + +@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m" + +@rem Find java.exe +if defined JAVA_HOME goto findJavaFromJavaHome + +set JAVA_EXE=java.exe +%JAVA_EXE% -version >NUL 2>&1 +if %ERRORLEVEL% equ 0 goto execute + +echo. 1>&2 +echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2 +echo. 1>&2 +echo Please set the JAVA_HOME variable in your environment to match the 1>&2 +echo location of your Java installation. 1>&2 + +goto fail + +:findJavaFromJavaHome +set JAVA_HOME=%JAVA_HOME:"=% +set JAVA_EXE=%JAVA_HOME%/bin/java.exe + +if exist "%JAVA_EXE%" goto execute + +echo. 1>&2 +echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2 +echo. 1>&2 +echo Please set the JAVA_HOME variable in your environment to match the 1>&2 +echo location of your Java installation. 1>&2 + +goto fail + +:execute +@rem Setup the command line + +set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar + + +@rem Execute Gradle +"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %* + +:end +@rem End local scope for the variables with windows NT shell +if %ERRORLEVEL% equ 0 goto mainEnd + +:fail +rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of +rem the _cmd.exe /c_ return code! +set EXIT_CODE=%ERRORLEVEL% +if %EXIT_CODE% equ 0 set EXIT_CODE=1 +if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE% +exit /b %EXIT_CODE% + +:mainEnd +if "%OS%"=="Windows_NT" endlocal + +:omega diff --git a/snippets/settings.gradle.kts b/snippets/settings.gradle.kts new file mode 100644 index 00000000..a9bc7170 --- /dev/null +++ b/snippets/settings.gradle.kts @@ -0,0 +1,33 @@ +/* + * Copyright 2026 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +pluginManagement { + repositories { + google() + mavenCentral() + gradlePluginPortal() + } +} + +dependencyResolutionManagement { + repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) + repositories { + google() + mavenCentral() + } +} + +rootProject.name = "snippets" diff --git a/snippets/src/androidTest/java/com/example/android/performance/baselineprofiles/BaselineProfilesOverview.kt b/snippets/src/androidTest/java/com/example/android/performance/baselineprofiles/BaselineProfilesOverview.kt new file mode 100644 index 00000000..b713319e --- /dev/null +++ b/snippets/src/androidTest/java/com/example/android/performance/baselineprofiles/BaselineProfilesOverview.kt @@ -0,0 +1,51 @@ +/* + * Copyright 2026 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.example.android.performance.baselineprofiles + +import androidx.benchmark.macro.junit4.BaselineProfileRule +import androidx.test.uiautomator.Direction +import androidx.test.uiautomator.textAsString +import androidx.test.uiautomator.uiAutomator +import org.junit.Rule +import org.junit.Test + +private const val PACKAGE_NAME = "com.example.snippets" + +// [START android_performance_baselineprofiles_overview_generator] +class BaselineProfileGenerator { + @get:Rule + val baselineProfileRule = BaselineProfileRule() + + @Test + fun appStartupAndUserJourneys() { + baselineProfileRule.collect(packageName = PACKAGE_NAME) { + uiAutomator { + // App startup journey. + startApp(PACKAGE_NAME) + + // Find and click elements using the new DSL + onElement { textAsString() == "COMPOSE LAZYLIST" }.click() + onElement { viewIdResourceName == "myLazyColumn" }.also { + it.fling(Direction.DOWN) + it.fling(Direction.UP) + } + pressBack() + } + } + } +} +// [END android_performance_baselineprofiles_overview_generator] diff --git a/snippets/src/androidTest/java/com/example/android/performance/baselineprofiles/MeasureBaselineProfile.kt b/snippets/src/androidTest/java/com/example/android/performance/baselineprofiles/MeasureBaselineProfile.kt new file mode 100644 index 00000000..e16c87f4 --- /dev/null +++ b/snippets/src/androidTest/java/com/example/android/performance/baselineprofiles/MeasureBaselineProfile.kt @@ -0,0 +1,80 @@ +/* + * Copyright 2026 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.example.android.performance.baselineprofiles + +import androidx.benchmark.macro.BaselineProfileMode +import androidx.benchmark.macro.CompilationMode +import androidx.benchmark.macro.StartupMode +import androidx.benchmark.macro.StartupTimingMetric +import androidx.benchmark.macro.junit4.MacrobenchmarkRule +import androidx.test.ext.junit.runners.AndroidJUnit4 +import androidx.test.uiautomator.uiAutomator +import org.junit.Rule +import org.junit.Test +import org.junit.runner.RunWith + +// [START android_performance_baselineprofiles_measure_compilation_modes] +@RunWith(AndroidJUnit4::class) +class ColdStartupBenchmark { + @get:Rule + val benchmarkRule = MacrobenchmarkRule() + + // No ahead-of-time (AOT) compilation at all. Represents performance of a + // fresh install on a user's device if you don't enable Baseline Profiles— + // generally the worst case performance. + @Test + fun startupNoCompilation() = startup(CompilationMode.None()) + + // Partial pre-compilation with Baseline Profiles. Represents performance of + // a fresh install on a user's device. + @Test + fun startupPartialWithBaselineProfiles() = + startup(CompilationMode.Partial(baselineProfileMode = BaselineProfileMode.Require)) + + // Partial pre-compilation with some just-in-time (JIT) compilation. + // Represents performance after some app usage. + @Test + fun startupPartialCompilation() = startup( + CompilationMode.Partial( + baselineProfileMode = BaselineProfileMode.Disable, + warmupIterations = 3 + ) + ) + + // Full pre-compilation. Generally not representative of real user + // experience, but can yield more stable performance metrics by removing + // noise from JIT compilation within benchmark runs. + @Test + fun startupFullCompilation() = startup(CompilationMode.Full()) + + private fun startup(compilationMode: CompilationMode) = benchmarkRule.measureRepeated( + packageName = "com.example.macrobenchmark.target", + metrics = listOf(StartupTimingMetric()), + compilationMode = compilationMode, + iterations = 10, + startupMode = StartupMode.COLD, + setupBlock = { + pressHome() + } + ) { + uiAutomator { + startApp(packageName) + onElement(5_000) { viewIdResourceName == "my-content" } + } + } +} +// [END android_performance_baselineprofiles_measure_compilation_modes] diff --git a/snippets/src/androidTest/java/com/example/android/performance/startupprofiles/DexLayoutOptimizations.kt b/snippets/src/androidTest/java/com/example/android/performance/startupprofiles/DexLayoutOptimizations.kt new file mode 100644 index 00000000..740ad300 --- /dev/null +++ b/snippets/src/androidTest/java/com/example/android/performance/startupprofiles/DexLayoutOptimizations.kt @@ -0,0 +1,54 @@ +/* + * Copyright 2026 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.example.android.performance.startupprofiles + +import android.content.Intent +import androidx.benchmark.macro.junit4.BaselineProfileRule +import androidx.test.ext.junit.runners.AndroidJUnit4 +import androidx.test.filters.LargeTest +import androidx.test.uiautomator.uiAutomator +import org.junit.Rule +import org.junit.Test +import org.junit.runner.RunWith + +// [START android_performance_startupprofiles_generator] +@RunWith(AndroidJUnit4::class) +@LargeTest +class BaselineProfileGenerator { + + @get:Rule + val rule = BaselineProfileRule() + + @Test + fun generate() { + rule.collect( + packageName = "com.example.app", + includeInStartupProfile = true + ) { + uiAutomator { + // Launch directly into the NEWS_FEED using startActivityIntent + startIntent( + Intent().apply { + setPackage(packageName) + setAction("com.example.app.NEWS_FEED") + } + ) + } + } + } +} +// [END android_performance_startupprofiles_generator] diff --git a/snippets/src/main/AndroidManifest.xml b/snippets/src/main/AndroidManifest.xml new file mode 100644 index 00000000..c9a15e47 --- /dev/null +++ b/snippets/src/main/AndroidManifest.xml @@ -0,0 +1,30 @@ + + + + + + + + + + + + + + diff --git a/snippets/src/main/java/com/example/android/performance/appstartup/AnalysisOptimization.kt b/snippets/src/main/java/com/example/android/performance/appstartup/AnalysisOptimization.kt new file mode 100644 index 00000000..6588de7d --- /dev/null +++ b/snippets/src/main/java/com/example/android/performance/appstartup/AnalysisOptimization.kt @@ -0,0 +1,73 @@ +/* + * Copyright 2026 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.example.android.performance.appstartup + +import android.app.Application +import android.os.StrictMode +import androidx.compose.runtime.Composable +import androidx.compose.runtime.LaunchedEffect +import androidx.compose.runtime.getValue +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.remember +import androidx.compose.runtime.setValue + +// [START android_performance_appstartup_strict_mode] +class MyApplication : Application() { + + override fun onCreate() { + super.onCreate() + + // ... + + if (BuildConfig.DEBUG) { + StrictMode.setThreadPolicy( + StrictMode.ThreadPolicy.Builder() + .detectAll() + .penaltyDeath() + .build() + ) + } + + // ... + } +} +// [END android_performance_appstartup_strict_mode] + +@Composable +private fun ConditionalCompositionSnippet() { + // [START android_compose_performance_conditional_composition] + var shouldLoad by remember { mutableStateOf(false) } + + if (shouldLoad) { + MyComposable() + } + // [END android_compose_performance_conditional_composition] + + // [START android_compose_performance_conditional_composition_effect] + LaunchedEffect(Unit) { + shouldLoad = true + } + // [END android_compose_performance_conditional_composition_effect] +} + +@Composable +private fun MyComposable() { +} + +private object BuildConfig { + const val DEBUG = true +} diff --git a/snippets/src/main/java/com/example/android/performance/vitals/LaunchTime.kt b/snippets/src/main/java/com/example/android/performance/vitals/LaunchTime.kt new file mode 100644 index 00000000..916f7c02 --- /dev/null +++ b/snippets/src/main/java/com/example/android/performance/vitals/LaunchTime.kt @@ -0,0 +1,80 @@ +/* + * Copyright 2026 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.example.android.performance.vitals + +import android.os.Bundle +import androidx.activity.ComponentActivity +import androidx.activity.compose.setContent +import androidx.compose.runtime.Composable +import androidx.compose.runtime.SideEffect +import androidx.compose.runtime.getValue +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.remember +import androidx.compose.runtime.setValue +import androidx.lifecycle.lifecycleScope +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.launch + +// [START android_performance_launch_time_fully_drawn_reporter] +class MainActivity : ComponentActivity() { + + sealed interface ActivityState { + data object LOADING : ActivityState + data object LOADED : ActivityState + } + + override fun onCreate(savedInstanceState: Bundle?) { + super.onCreate(savedInstanceState) + + setContent { + var activityState by remember { + mutableStateOf(ActivityState.LOADING as ActivityState) + } + fullyDrawnReporter.addOnReportDrawnListener { + activityState = ActivityState.LOADED + } + ReportFullyDrawnTheme { + when (activityState) { + is ActivityState.LOADING -> { + // Display the loading UI. + } + is ActivityState.LOADED -> { + // Display the full UI. + } + } + } + SideEffect { + fullyDrawnReporter.addReporter() + lifecycleScope.launch(Dispatchers.IO) { + // Perform the background operation. + fullyDrawnReporter.removeReporter() + } + fullyDrawnReporter.addReporter() + lifecycleScope.launch(Dispatchers.IO) { + // Perform the background operation. + fullyDrawnReporter.removeReporter() + } + } + } + } +} +// [END android_performance_launch_time_fully_drawn_reporter] + +@Composable +private fun ReportFullyDrawnTheme(content: @Composable () -> Unit) { + content() +} From 5ebce66eefe40f322fea2b0dafce686e3b939daa Mon Sep 17 00:00:00 2001 From: Peng Quah Date: Tue, 27 Oct 2026 18:28:06 +0000 Subject: [PATCH 2/4] Remove extra blank lines --- .../android/performance/appstartup/AnalysisOptimization.kt | 2 -- 1 file changed, 2 deletions(-) diff --git a/snippets/src/main/java/com/example/android/performance/appstartup/AnalysisOptimization.kt b/snippets/src/main/java/com/example/android/performance/appstartup/AnalysisOptimization.kt index 6588de7d..d8512477 100644 --- a/snippets/src/main/java/com/example/android/performance/appstartup/AnalysisOptimization.kt +++ b/snippets/src/main/java/com/example/android/performance/appstartup/AnalysisOptimization.kt @@ -32,7 +32,6 @@ class MyApplication : Application() { super.onCreate() // ... - if (BuildConfig.DEBUG) { StrictMode.setThreadPolicy( StrictMode.ThreadPolicy.Builder() @@ -41,7 +40,6 @@ class MyApplication : Application() { .build() ) } - // ... } } From a8e78c0fcb3750c0b1964e11210535a9f8ddb832 Mon Sep 17 00:00:00 2001 From: Ivan Morgillo Date: Tue, 17 Nov 2026 19:50:48 +0000 Subject: [PATCH 3/4] Update snippets dependencies to current stable versions - UI Automator 2.4.0-alpha06 -> 2.4.1, Benchmark 1.4.1 -> 1.5.0, Activity 1.11.0 -> 1.13.0, Compose BOM 2025.11.00 -> 2026.06.01, Lifecycle 2.9.4 -> 2.10.0, Kotlin 2.2.21 -> 2.4.21, AGP 8.13.1 -> 8.13.2, Gradle 8.14.3 -> 8.14.7 (with the distribution checksum pinned). Newer Compose and Lifecycle releases need compileSdk 37 and AGP 9. - Depend on lifecycle-runtime: lifecycle-runtime-ktx is empty since 2.8.0. - UI Automator 2.4.1 has no startIntent(); the startup profile snippet now calls startActivityIntent(), which its comment already names. - Sort the dependency and version entries alphabetically. - End two snippet comments with a full stop. --- snippets/build.gradle.kts | 4 ++-- snippets/gradle/libs.versions.toml | 16 ++++++++-------- snippets/gradle/wrapper/gradle-wrapper.jar | Bin 43705 -> 44309 bytes .../gradle/wrapper/gradle-wrapper.properties | 3 ++- snippets/gradlew | 4 ++-- snippets/gradlew.bat | 4 ++-- .../BaselineProfilesOverview.kt | 2 +- .../startupprofiles/DexLayoutOptimizations.kt | 4 ++-- 8 files changed, 19 insertions(+), 18 deletions(-) diff --git a/snippets/build.gradle.kts b/snippets/build.gradle.kts index 43d2c39e..e437114b 100644 --- a/snippets/build.gradle.kts +++ b/snippets/build.gradle.kts @@ -50,9 +50,9 @@ android { dependencies { val composeBom = platform(libs.androidx.compose.bom) implementation(composeBom) - implementation(libs.androidx.compose.runtime) implementation(libs.androidx.activity.compose) - implementation(libs.androidx.lifecycle.runtime.ktx) + implementation(libs.androidx.compose.runtime) + implementation(libs.androidx.lifecycle.runtime) androidTestImplementation(libs.androidx.benchmark.macro.junit4) androidTestImplementation(libs.androidx.test.ext.junit) diff --git a/snippets/gradle/libs.versions.toml b/snippets/gradle/libs.versions.toml index 2e74dd06..b48acb1c 100644 --- a/snippets/gradle/libs.versions.toml +++ b/snippets/gradle/libs.versions.toml @@ -13,25 +13,25 @@ # limitations under the License. [versions] -agp = "8.13.1" -activity = "1.11.0" -benchmark = "1.4.1" +activity = "1.13.0" +agp = "8.13.2" +benchmark = "1.5.0" compileSdk = "36" -composeBom = "2025.11.00" +composeBom = "2026.06.01" junit = "1.3.0" -kotlin = "2.2.21" -lifecycle = "2.9.4" +kotlin = "2.4.21" +lifecycle = "2.10.0" minSdk = "24" targetSdk = "36" testRunner = "1.7.0" -uiAutomator = "2.4.0-alpha06" +uiAutomator = "2.4.1" [libraries] androidx-activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activity" } androidx-benchmark-macro-junit4 = { group = "androidx.benchmark", name = "benchmark-macro-junit4", version.ref = "benchmark" } androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" } androidx-compose-runtime = { group = "androidx.compose.runtime", name = "runtime" } -androidx-lifecycle-runtime-ktx = { group = "androidx.lifecycle", name = "lifecycle-runtime-ktx", version.ref = "lifecycle" } +androidx-lifecycle-runtime = { group = "androidx.lifecycle", name = "lifecycle-runtime", version.ref = "lifecycle" } androidx-test-ext-junit = { group = "androidx.test.ext", name = "junit", version.ref = "junit" } androidx-test-runner = { group = "androidx.test", name = "runner", version.ref = "testRunner" } androidx-uiautomator = { group = "androidx.test.uiautomator", name = "uiautomator", version.ref = "uiAutomator" } diff --git a/snippets/gradle/wrapper/gradle-wrapper.jar b/snippets/gradle/wrapper/gradle-wrapper.jar index 9bbc975c742b298b441bfb90dbc124400a3751b9..02f06ab2a396743f0052e4328b0e5ac2cdd8b3d2 100644 GIT binary patch delta 35730 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 delta 35092 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 Date: Wed, 18 Nov 2026 13:13:32 +0000 Subject: [PATCH 4/4] Say where the androidTest snippet classes live in an app The Baseline Profile and Macrobenchmark snippet classes sit in androidTest so they compile. A comment outside each region says that in an app they live in a separate com.android.test module. --- .../performance/baselineprofiles/BaselineProfilesOverview.kt | 2 ++ .../performance/baselineprofiles/MeasureBaselineProfile.kt | 2 ++ .../performance/startupprofiles/DexLayoutOptimizations.kt | 2 ++ 3 files changed, 6 insertions(+) diff --git a/snippets/src/androidTest/java/com/example/android/performance/baselineprofiles/BaselineProfilesOverview.kt b/snippets/src/androidTest/java/com/example/android/performance/baselineprofiles/BaselineProfilesOverview.kt index eebf876c..0030c4a5 100644 --- a/snippets/src/androidTest/java/com/example/android/performance/baselineprofiles/BaselineProfilesOverview.kt +++ b/snippets/src/androidTest/java/com/example/android/performance/baselineprofiles/BaselineProfilesOverview.kt @@ -25,6 +25,8 @@ import org.junit.Test private const val PACKAGE_NAME = "com.example.snippets" +// In an app, this class lives in a Baseline Profile generator module (a +// com.android.test module), not in androidTest. // [START android_performance_baselineprofiles_overview_generator] class BaselineProfileGenerator { @get:Rule diff --git a/snippets/src/androidTest/java/com/example/android/performance/baselineprofiles/MeasureBaselineProfile.kt b/snippets/src/androidTest/java/com/example/android/performance/baselineprofiles/MeasureBaselineProfile.kt index e16c87f4..dd72b444 100644 --- a/snippets/src/androidTest/java/com/example/android/performance/baselineprofiles/MeasureBaselineProfile.kt +++ b/snippets/src/androidTest/java/com/example/android/performance/baselineprofiles/MeasureBaselineProfile.kt @@ -27,6 +27,8 @@ import org.junit.Rule import org.junit.Test import org.junit.runner.RunWith +// In an app, this class lives in a Macrobenchmark module (a com.android.test +// module), not in androidTest. // [START android_performance_baselineprofiles_measure_compilation_modes] @RunWith(AndroidJUnit4::class) class ColdStartupBenchmark { diff --git a/snippets/src/androidTest/java/com/example/android/performance/startupprofiles/DexLayoutOptimizations.kt b/snippets/src/androidTest/java/com/example/android/performance/startupprofiles/DexLayoutOptimizations.kt index 90a40695..3e1d117f 100644 --- a/snippets/src/androidTest/java/com/example/android/performance/startupprofiles/DexLayoutOptimizations.kt +++ b/snippets/src/androidTest/java/com/example/android/performance/startupprofiles/DexLayoutOptimizations.kt @@ -25,6 +25,8 @@ import org.junit.Rule import org.junit.Test import org.junit.runner.RunWith +// In an app, this class lives in a Baseline Profile generator module (a +// com.android.test module), not in androidTest. // [START android_performance_startupprofiles_generator] @RunWith(AndroidJUnit4::class) @LargeTest