Acquisisci tracce con Winscope

Esegui Winscope localmente o accedi da un server web.

Puoi acquisire le tracce utilizzando Winscope per lo sviluppo e il debug locale. Winscope utilizza adb, che supporta la connessione del dispositivo tramite USB o Wi-Fi.

La schermata Raccogli tracce viene visualizzata all'avvio di Winscope.

Connessione dispositivo

Puoi connettere i dispositivi in Winscope utilizzando Winscope Proxy o Web Device Proxy. Per impostazione predefinita, la home page di Winscope mostra l'interfaccia utente di configurazione della connessione del proxy Winscope.

Per iniziare a acquisire le tracce, scegli uno dei seguenti meccanismi di connessione del dispositivo.

Configurazione del proxy Winscope

Per configurare Winscope Proxy:

1. In Raccogli tracce nella home page, scegli Winscope Proxy nel menu a discesa Seleziona il tipo di connessione:

   

   Figura 1. Acquisisci le tracce utilizzando Winscope Proxy.

2. Avvia il proxy Winscope ADB Connect per acquisire le tracce direttamente dal browser eseguendo il seguente comando:

   python3 $ANDROID_BUILD_TOP/development/tools/winscope/src/adb/winscope_proxy.py
   

3. Prendi nota del token proxy Winscope visualizzato sul terminale dopo l'esecuzione.

4. Dopo aver avviato il proxy Winscope ADB Connect, la schermata cambia come segue. Per stabilire la connessione iniziale al proxy, inserisci il token del proxy Winscope del passaggio 3 e fai clic su Connetti.

   

   Figura 2. Connettiti a Winscope Proxy.

Configurazione di Web Device Proxy

Per configurare il proxy del dispositivo web:

1. In Raccogli tracce nella home page, scegli Proxy dispositivo web nel menu a discesa Seleziona il tipo di connessione:

   

   Figura 3. Acquisisci le tracce utilizzando il proxy del dispositivo web.

2. Se non hai il demone Web Device Proxy sulla tua macchina, fai clic su Installa o esegui il programma di installazione.

3. Approva l'accesso dell'origine a Web Device Proxy tramite la finestra di dialogo.

   

   Figura 4. Autorizza l'origine.

4. Approva l'accesso per ogni nuovo dispositivo la prima volta che ti connetti. Se la finestra di dialogo non viene visualizzata automaticamente, fai clic sull'icona lock_open accanto al dispositivo:

   

   Figura 5. Autorizza il dispositivo.

Tracce

Per raccogliere le tracce:

1. Una volta connesso, per avviare la procedura di acquisizione, seleziona i target e configura le impostazioni. Poi fai clic su Avvia traccia per iniziare l'acquisizione:

   

   Figura 6. Raccogli le tracce in Winscope.

2. Per interrompere l'acquisizione, fai clic su Termina traccia:

   

   Figura 7. Termina la traccia in Winscope.

Opzioni di traccia

Questa sezione descrive le opzioni per ogni tipo di traccia.

Registrazione dello schermo

Con Winscope puoi registrare lo schermo di più display. Scegli una visualizzazione dal menu per registrare lo schermo. Se non effettui una selezione, Winscope registra per impostazione predefinita la visualizzazione attiva.

SurfaceFlinger

• Dimensione buffer:regola la dimensione del buffer circolare in memoria per la traccia di SurfaceFlinger. Un buffer più grande consente di raccogliere più dati, ma aumenta l'utilizzo della memoria.

• Input:se la superficie contiene dati di input, monitora le specifiche della finestra di input.

• Composizione:traccia il tipo di composizione e la regione visibile.

• Metadati:rileva metadati aggiuntivi della visualizzazione, inclusi i livelli fuori schermo.

• HWC: traccia metadati aggiuntivi non strutturati del compositore hardware.

• Traccia buffer:configura SurfaceFlinger per tracciare tutte le modifiche ai buffer sulla superficie. Per impostazione predefinita, SurfaceFlinger traccia un nuovo stato solo quando la geometria viene modificata.

• Display virtuali:include i livelli di visualizzazione virtuali nella traccia.

WindowManager

• Dimensione buffer:regola le dimensioni del buffer circolare in memoria per la traccia WindowManager. Un buffer più grande consente la raccolta di più dati, ma aumenta l'utilizzo della memoria.

• Tipo di monitoraggio:definisce le opzioni di frequenza per la raccolta degli stati:

  • frame:in questa modalità, WindowManager esegue il dump di un singolo stato per frame, garantendo che vengano acquisiti solo gli stati WindowManager validi. Questa modalità ha il minore overhead di rendimento.
  • transaction: questa modalità registra uno stato WindowManager ogni volta che viene eseguito il commit di una transazione. Puoi eseguire il commit di più transazioni all'interno di un frame, in modo da poter eseguire il debug degli stati intermedi di WindowManager durante un frame. Tuttavia, questa modalità ha un overhead di prestazioni più elevato rispetto alla modalità frame.

• Livello di tracciamento:determina la modalità di visualizzazione delle tracce di WindowManager:

  • verbose:include tutte le finestre e le informazioni di configurazione per ogni finestra. Questa modalità ha il maggiore overhead di memoria e prestazioni.
  • debug: include informazioni su tutte le finestre, ma registra solo la configurazione della finestra se contiene una configurazione di override richiesta.
  • critical: include le stesse informazioni della modalità di debug, ma solo le finestre visibili. Questa modalità ha il minore overhead di memoria e prestazioni.

Dump

Per eseguire un dump dello stato utilizzando Winscope, nella sezione Raccogli tracce della home page, selezionare la scheda Dump e fare clic su Dump stato:

Figura 8. Esegui il dump dello stato in Winscope.

Configurazione degli screenshot

Winscope consente di acquisire uno screenshot di più display. Scegli una visualizzazione dal menu di cui acquisire uno screenshot. Se non viene effettuata alcuna selezione, viene raccolto uno screenshot per il display attivo.