Argumentos de instrumentação da biblioteca Macrobenchmark

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