Argumentos de instrumentação da biblioteca Macrobenchmark

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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