Arguments d'instrumentation Macrobenchmark

Configurez le comportement de la bibliothèque avec les arguments d'instrumentation suivants. Vous pouvez ajouter ces arguments à votre configuration Gradle ou les appliquer directement lorsque vous exécutez une instrumentation à partir de la ligne de commande. Si vous utilisez Gradle, ajoutez les arguments à testInstrumentationRunnerArguments :

android {
    defaultConfig {
        // ...
        testInstrumentationRunnerArguments["androidx.benchmark.enabledRules"] = "BaselineProfile"
    }
}

Si vous les appelez directement à partir de la ligne de commande, utilisez -P android.testInstrumentationRunnerArguments.[name of the argument].

./gradlew :benchmark:connectedAndroidTest -P android.testInstrumentationRunnerArguments.androidx.benchmark.enabledRules=BaselineProfile

androidx.benchmark.compilation.enabled

Permet de désactiver la compilation entre chaque itération de l'analyse comparative. Par défaut, l'application cible est réinstallée et recompilée entre chaque analyse comparative, afin de respecter le CompilationMode transmis dans measureRepeated. La désactivation de cette option vous permet d'ignorer la réinstallation et la compilation si vous souhaitez compiler entièrement l'application cible avant d'exécuter la suite de tests, par exemple. Vous pouvez également exécuter toutes les analyses comparatives sur cette cible entièrement compilée.

  • Type d'argument : booléen
  • Valeur par défaut : true

androidx.benchmark.dryRunMode.enable

Permet d'exécuter des analyses comparatives dans une seule boucle pour vérifier qu'elles fonctionnent correctement. Peut être combiné avec des tests classiques lors de la validation.

  • Type d'argument : booléen
  • Valeur par défaut : false

androidx.benchmark.enabledRules

Permet le filtrage des exécutions sur un seul type de test (la génération de profils de référence ou le test Macrobenchmark). Les listes comportant des éléments séparés par des virgules sont également prises en charge.

  • Type d'argument : chaîne
  • Options disponibles :
    • Macrobenchmark
    • BaselineProfile
  • Valeur par défaut : non spécifié

androidx.benchmark.fullTracing.enable (expérimental)

Active les tracepoints androidx.tracing.perfetto tels que le traçage de composition Jetpack Compose. Notez que cela affecte uniquement quand StartupMode.COLD n'est pas utilisé, car l'activation des tracepoints active le processus cible.

  • Type d'argument : booléen
  • Valeur par défaut : false

androidx.benchmark.suppressErrors

Accepte les listes d'erreurs séparées par une virgule qui deviennent des avertissements.

  • Type d'argument : liste de chaînes
  • Options disponibles :
    • DEBUGGABLE
    • LOW-BATTERY
    • EMULATOR
    • NOT-PROFILEABLE
  • Valeur par défaut : liste vide

additionalTestOutputDir

Configure l'emplacement sur l'appareil où sont enregistrés les rapports d'analyse comparative JSON et les résultats de profilage.

  • Type d'argument : chaîne du chemin d'accès au fichier
  • Valeur par défaut : tester le répertoire externe de l'APK