Configure o comportamento da biblioteca com os argumentos
de instrumentação apresentados a seguir. Eles podem ser adicionados à configuração do Gradle ou aplicados
diretamente durante a execução da instrumentação na linha de comando. Se estiver usando o Gradle,
adicione os argumentos a testInstrumentationRunnerArguments
:
android {
defaultConfig {
// ...
testInstrumentationRunnerArguments["androidx.benchmark.enabledRules"] = "BaselineProfile"
}
}
Se estiver chamando diretamente pela linha de comando, use
-P android.testInstrumentationRunnerArguments.[name of the argument]
.
./gradlew :benchmark:connectedAndroidTest -P android.testInstrumentationRunnerArguments.androidx.benchmark.enabledRules=BaselineProfile
androidx.benchmark.compilation.enabled
Permite desativar a compilação entre cada iteração da comparação. Por padrão, o aplicativo de destino é reinstalado e recompilado entre cada comparação, para respeitar o CompilationMode transmitido para measureRepeated. Desativar essa opção permite pular a reinstalação e a compilação se, por exemplo, você quiser compilar totalmente o app de destino uma vez antes de executar o pacote de teste e executar todas as comparações nesse destino totalmente compilado.
- Tipo de argumento: booleano
- Padrão:
true
androidx.benchmark.dryRunMode.enable
Permite executar comparações em repetição única para verificar se funcionam corretamente. Pode ser usado com testes regulares como parte da verificação.
- Tipo de argumento: booleano
- Padrão:
false
androidx.benchmark.enabledRules
Permite filtrar execuções para apenas um tipo de teste: geração de perfil de referência ou teste de Macrobenchmark. Uma lista separada por vírgulas também é permitida.
- Tipo de argumento: string
- Opções disponíveis:
Macrobenchmark
BaselineProfile
- Padrão: não especificado
androidx.benchmark.fullTracing.enable (experimental)
Ativa os tracepoints androidx.tracing.perfetto
, como o rastreamento de composição do Jetpack Compose.
Funciona apenas quando o StartupMode.COLD
não é usado, já que a ativação dos tracepoints aciona o processo de destino.
- Tipo de argumento: booleano
- Padrão:
false
androidx.benchmark.suppressErrors
Aceita uma lista de erros separada por vírgulas para transformar em avisos.
- Tipo de argumento: lista de strings
- Opções disponíveis:
DEBUGGABLE
LOW-BATTERY
EMULATOR
NOT-PROFILEABLE
- Padrão: uma lista vazia
additionalTestOutputDir
Configura o local onde os relatórios de comparação JSON e os resultados de criação de perfil são salvos no dispositivo.
- Tipo de argumento: string do caminho do arquivo
- Padrão: testar o diretório externo do APK