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:
- Para editar la configuración de ejecución, haz clic en Edit y selecciona la configuración que deseas editar.
- Para editar los argumentos de instrumentación, haz clic en junto al campo Instrumentation arguments.
- Haz clic en y agrega el argumento de instrumentación requerido.
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
Te permite ejecutar comparativas en un solo bucle para verificar si funcionan correctamente. Puedes usarla con pruebas periódicas 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 para garantizar una cantidad de trabajo coherente. Por lo general, esto resulta útil solo con la generación de perfiles habilitada 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.junit4.SideEffectRunListener
Es posible que obtengas resultados de comparativas incoherentes si se ejecuta un trabajo en segundo plano no relacionado mientras se ejecutan las comparativas.
Para inhabilitar el trabajo en segundo plano durante las comparativas, establece el tipo de argumento de instrumentación listener
en androidx.benchmark.junit4.SideEffectRunListener
.
- Tipo de argumento: Cadena
- Opciones disponibles:
androidx.benchmark.junit4.SideEffectRunListener
- 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 con Microbenchmark para ver las opciones disponibles.
- Tipo de argumento: Cadena
- 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 cadenas
- 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 para 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
Recomendaciones para ti
- Nota: El texto del vínculo se muestra cuando JavaScript está desactivado
- Argumentos de instrumentación de Macrobenchmark
- Cómo generar perfiles con Microbenchmark
- Cómo crear perfiles de Baseline {:#creating-profile-rules}