Argumentos de instrumentación de microcomparativas

Para configurar el comportamiento de tus comparativas, especifica diferentes argumentos en el ejecutor de instrumentación. Pueden aplicarse a tu configuración de Gradle o agregarse directamente cuando se ejecute la instrumentación desde la línea de comandos.

Para configurar argumentos de instrumentación cuando ejecutas las comparativas desde Android Studio, haz lo siguiente:

  1. Edita la configuración de ejecución .
  2. Edita argumentos de instrumentación .
  3. Agrega el argumento de instrumentación obligatorio .

additionalTestOutputDir

Establece en qué lugar del dispositivo se guardan los informes de comparativas de JSON y los resultados de la generación de perfiles.

  • Tipo de argumento: string de ruta de acceso del archivo
  • Configuración predeterminada: directorio externo del APK de prueba

androidx.benchmark.dryRunMode.enable

Permite ejecutar comparativas en un bucle único para verificar que funcionen correctamente. Se puede usar con pruebas regulares como parte de la verificación.

  • Tipo de argumento: booleano
  • Configuración predeterminada: false

androidx.benchmark.iterations

Anula la cantidad de iteraciones objetivo basadas en el tiempo a fin de garantizar una cantidad de trabajo coherente. Por lo general, esto resulta útil solo con la generación de perfiles habilitada (consulta Generación de perfiles) para garantizar que se realice una cantidad coherente de trabajo dentro de un seguimiento de generación de perfiles cuando se comparen diferentes implementaciones o ejecuciones. En otras situaciones, es probable que esto reduzca la precisión o la estabilidad de las mediciones.

  • Tipo de argumento: número entero
  • Configuración predeterminada: no se especifica

androidx.benchmark.output.enable

Permite escribir el archivo JSON resultante en el almacenamiento externo.

  • Tipo de argumento: booleano
  • Configuración predeterminada: true

androidx.benchmark.profiling.mode

Permite capturar archivos de registro mientras se ejecutan las comparativas. Consulta Cómo generar perfiles de las comparativas para ver las opciones disponibles.

  • Tipo de argumento: string
  • Opciones disponibles:
    • MethodTracing
    • StackSampling
    • None
  • Configuración predeterminada: None

androidx.benchmark.suppressErrors

Acepta una lista de errores separada por comas que se convertirán en advertencias.

  • Tipo de argumento: lista de strings
  • Opciones disponibles:
    • DEBUGGABLE
    • LOW-BATTERY
    • EMULATOR
    • CODE-COVERAGE
    • UNLOCKED
    • SIMPLEPERF
    • ACTIVITY-MISSING
  • Configuración predeterminada: una lista vacía

androidx.benchmark.startupMode.enable (Obsoleto)

Reconfigura el comportamiento de bucle a fin de admitir el código de comparativas durante el inicio. Las comparativas se ejecutan sin bucles de preparación en 10 mediciones. Para minimizar la sobrecarga en las microcomparativas, se inhabilitó el promedio de bucles.

  • Tipo de argumento: booleano
  • Configuración predeterminada: false