Santa Tracker Performance

Performance tests for Santa Tracker Android project.

The project contains Gradle Profiler benchmark scenarios to test the performance of different kinds of behavior using the Santa Tracker Android app.

The repo has two submodules pointing to the same Gradle fork of the official Santa Trakcer repository. One submodule points to an older branch of the original repository that is kept more or less up-to-date by Gradle, and uses Java sources only. The other submodule is derived from the master branch of the main repo. This variant is in large part written in Kotlin.

Respectively, there are separate performance tests scenarios for the Java and Kotlin.

There is also a submodule pointing to Gradle Profiler itself.

Running a benchmark

To run a benchmark set the following environment variables:

• JAVA_HOME
• ANDROID_HOME

You can customize the tool versions for the following:

• GRADLE_VERSION for the Gradle distribution to use to run the tests
• AGP_VERSION for the Android Gradle plugin version
• KOTLIN_VERSION for the Kotlin Gradle plugin version

Note that if you don't set these environment variables explicitly, then the defaults from the respective scripts will be used.

Once these are set up you can run either of the shell scripts:

• run-faster-incremental-java.sh for Java, or
• run-faster-incremental-kotlin.sh for the Kotlin variant (duh!)

Doing so will use Gradle Profiler from the gradle-profiler submodule.

You can also pass a number as a parameter to the above tests to make it run the given number of iterations, like so:

$ AGP_VERSION=4.0.0-beta01 ./run-faster-incremental-java.sh 40

This will run 40 iterations with the default Gradle and Kotlin versions, using AGP 4.0.0-beta01.