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 as comparações no Android Studio:

  1. Edite a configuração de execução
  2. Edite os argumentos de instrumentação
  3. Adicione o argumento de instrumentação necessário

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 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.iterations

Modifica as contagens de iterações desejadas por tempo para garantir uma quantidade consistente de trabalho. Isso normalmente é útil apenas quando a criação de perfil está ativada (consulte Criação de perfil) para 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 outras situações, isso provavelmente reduz a precisão e a estabilidade das medições.

  • Tipo de argumento: número inteiro
  • 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 Criação de perfil de comparações para ver 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)

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