Argomenti strumentazione Microbenchmark

Configura il comportamento dei benchmark specificando argomenti diversi per l'esecutore della strumentazione. Possono essere applicati alla configurazione di Gradle o aggiunti direttamente durante l'esecuzione della strumentazione dalla riga di comando.

Per impostare gli argomenti di strumentazione quando esegui i benchmark da Android Studio, procedi nel seguente modo:

  1. Modifica la configurazione dell'esecuzione facendo clic su Modifica e selezionando la configurazione da modificare.
    Figura 1. Modifica la configurazione di esecuzione.
  2. Modifica gli argomenti della strumentazione facendo clic su accanto al campo Argomenti strumentazione.
    Figura 2. Modifica l'argomento della strumentazione.
  3. Fai clic su e aggiungi l'argomento di strumentazione richiesto.
    Figura 3. Aggiungi l'argomento strumentazione.

DirOutputTest aggiuntivo

Consente di configurare la posizione in cui i report JSON sui benchmark e i risultati della profilazione vengono salvati sul dispositivo.

  • Tipo di argomento: stringa del percorso file
  • Valore predefinito: test della directory esterna dell'APK

androidx.benchmark.dryRunMode.enable

Consente di eseguire i benchmark in un unico loop per verificarne il corretto funzionamento. Puoi utilizzarlo con i normali test nell'ambito della verifica.

  • Tipo di argomento: booleano
  • Il valore predefinito è: false

androidx.benchmark.iterations

Esegue l'override dei conteggi delle iterazioni target basate sul tempo per garantire un volume di lavoro coerente. In genere questa opzione è utile solo se è abilitata la profilazione per garantire che venga eseguita una quantità coerente di lavoro all'interno di una traccia di profilazione quando confronti diverse implementazioni o esecuzioni. In altri scenari, ciò riduce l'accuratezza o la stabilità delle misurazioni.

  • Tipo di argomento: numero intero
  • Valore predefinito: non specificato

androidx.benchmark.junit4.SideEffectRunListener

Potresti ricevere risultati di benchmark incoerenti se durante l'esecuzione del benchmark vengono eseguite attività in background non correlate.

Per disattivare il lavoro in background durante il benchmarking, imposta il tipo di argomento di strumentazione listener su androidx.benchmark.junit4.SideEffectRunListener.

  • Tipo di argomento: stringa
  • Opzioni disponibili:
    • androidx.benchmark.junit4.SideEffectRunListener
  • Valore predefinito: non specificato

androidx.benchmark.output.enable

Consente di scrivere il file JSON dei risultati in un'unità di archiviazione esterna.

  • Tipo di argomento: booleano
  • Il valore predefinito è: true

androidx.benchmark.profiling.mode

Consente di acquisire i file di traccia durante l'esecuzione dei benchmark. Vedi Profilare un Microbenchmark per le opzioni disponibili.

  • Tipo di argomento: stringa
  • Opzioni disponibili:
    • MethodTracing
    • StackSampling
    • None
  • Il valore predefinito è: None

androidx.benchmark.suppressErrors

Accetta un elenco separato da virgole di errori da trasformare in avvisi.

  • Tipo di argomento: elenco di stringhe
  • Opzioni disponibili:
    • DEBUGGABLE
    • LOW-BATTERY
    • EMULATOR
    • CODE-COVERAGE
    • UNLOCKED
    • SIMPLEPERF
    • ACTIVITY-MISSING
  • Il valore predefinito è: un elenco vuoto

androidx.benchmark.startupMode.enable (Deprecato)

Riconfigura il comportamento di loop per supportare il codice di benchmarking durante l'avvio. I benchmark vengono eseguiti senza loop di warmup per 10 misurazioni. Per ridurre al minimo l'overhead nei microbenchmark, il calcolo della media loop è disattivato.

  • Tipo di argomento: booleano
  • Il valore predefinito è: false