Argumentos de instrumentação de Microbenchmark

Configure o comportamento das comparações especificando argumentos para o executor de instrumentação. Os argumentos podem ser aplicados à configuração do Gradle ou adicionados diretamente ao executar a instrumentação na linha de comando.

Para configurar argumentos de instrumentação ao executar os comparativos de mercado no Android Studio, faça o seguinte:

1. Edite a configuração de execução clicando em Edit e selecionando a configuração que você quer editar.

   

   Figura 1. Edite a configuração de execução.

2. Edite os argumentos de instrumentação clicando em ao lado do campo Instrumentation arguments.

   

   Figura 2. Edite o argumento de instrumentação.

3. Clique em e adicione o argumento de instrumentação necessário.

   

   Figura 3. Adicione o argumento de instrumentação.

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

androidx.benchmark.dryRunMode.enable

Permite que você execute comparativos de mercado em um único loop para verificar se eles funcionam corretamente. Pode ser usado com testes regulares como parte da verificação.

• Tipo de argumento: booleano
• Padrão: false

androidx.benchmark.iterations

Modifica as contagens de iterações desejadas por tempo para garantir uma quantidade consistente de trabalho. Isso normalmente é útil apenas com a criação de perfil ativada para ajudar a garantir que uma quantidade consistente de trabalho seja realizada em um rastro de criação de perfil ao comparar diferentes implementações ou execuções. Em outros cenários, isso provavelmente reduz a precisão ou estabilidade das medições.

• Tipo de argumento: número inteiro
• Padrão: não especificado

androidx.benchmark.junit4.SideEffectRunListener

Você poderá receber resultados inconsistentes de comparativos de mercado, se um trabalho em segundo plano não relacionado for executado enquanto o comparativo estiver em execução.

Para desativar o trabalho em segundo plano durante a execução do comparativo de mercado, defina o tipo de argumento de instrumentação listener como androidx.benchmark.junit4.SideEffectRunListener.

• Tipo de argumento: string
• Opções disponíveis:
  • androidx.benchmark.junit4.SideEffectRunListener
• Padrão: não especificado

androidx.benchmark.output.enable

Permite gravar o arquivo JSON de resultado no armazenamento externo.

• Tipo de argumento: booleano
• Padrão: true

androidx.benchmark.profiling.mode

Permite capturar arquivos de rastreamento ao realizar comparações. Consulte Criar um perfil de Microbenchmark para conferir as opções disponíveis.

• Tipo de argumento: string
• Opções disponíveis:
  • MethodTracing
  • StackSampling
  • None
• Padrão: None

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
  • CODE-COVERAGE
  • UNLOCKED
  • SIMPLEPERF
  • ACTIVITY-MISSING
• Padrão: uma lista vazia

androidx.benchmark.startupMode.enable (descontinuado)

Observação: a biblioteca Macrobenchmark é mais adequada para comparações na inicialização do app.

Reconfigura o comportamento de repetição para oferecer suporte ao código de comparação durante a inicialização As comparações são executadas sem repetição de aquecimento em 10 medições. Para minimizar a sobrecarga em Microbenchmarks, a média de repetição é desativada.

• Tipo de argumento: booleano
• Padrão: false