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