I dispositivi con Android 9 (livello API 28) o versioni successive includono un'app a livello di sistema chiamata Monitoraggio del sistema. Questa app è simile all'utilità a riga di comando systrace, ma consente di registrare le tracce direttamente da un dispositivo di test, senza dover collegare il dispositivo e connetterti tramite adb. Puoi quindi utilizzare l'app per condividere i risultati di queste tracce con il tuo team di sviluppo.
I dispositivi con Android 10 e versioni successive registrano le tracce in formato Perfetto, mentre quelli precedenti le registrano in formato Systrace. Ti consigliamo di utilizzare il visualizzatore di traccia di Perfetto per aprire entrambi i formati e poi analizzare le tracce.
È utile per registrare le tracce quando si risolvono bug relativi al rendimento nell'app, come avvio lento, transizioni lente o UI a scatti.
Registrare una traccia di sistema
L'app Monitoraggio sistema ti consente di registrare una traccia di sistema utilizzando il riquadro Impostazioni rapide o un menu all'interno dell'app stessa. Le sezioni seguenti descrivono come completare la procedura di registrazione utilizzando queste interfacce.
Registrare utilizzando il riquadro Impostazioni rapide
Il riquadro Impostazioni rapide è in genere il modo più pratico per completare la procedura di monitoraggio del sistema sul dispositivo.
Configurare il riquadro
Se utilizzi la funzionalità di monitoraggio del sistema per la prima volta sul dispositivo di test o se non vedi il riquadro Monitoraggio del sistema nel riquadro Impostazioni rapide del dispositivo, come mostrato nella figura 2, completa i seguenti passaggi di configurazione:
- Attiva le opzioni sviluppatore.
- Apri la schermata delle impostazioni Opzioni sviluppatore.
- Nella sezione Debug, seleziona Monitoraggio sistema. Si apre l'app Monitoraggio sistema, che mostra il menu dell'app.
Dal menu dell'app, attiva Mostra riquadro Impostazioni rapide, come mostrato in Figura 1. Il sistema aggiunge il riquadro Monitoraggio sistema al riquadro Impostazioni rapide, come mostrato nella figura 2:
Figura 1. L'opzione Mostra il riquadro Impostazioni rapide nell'app Monitoraggio sistema. 
Figura 2. Il riquadro Monitoraggio sistema nel riquadro Impostazioni rapide. Nota:per impostazione predefinita, il sistema aggiunge il riquadro Monitoraggio sistema come primo riquadro nel riquadro Impostazioni rapide. Se vuoi che il riquadro venga visualizzato in una posizione diversa, usa la modalità di modifica del riquadro per spostarlo.
Completare una registrazione della traccia di sistema
Per registrare una traccia di sistema utilizzando il riquadro Impostazioni rapide, completa i seguenti passaggi:
Tocca il riquadro Monitoraggio sistema, con l'etichetta Registra traccia. Il riquadro viene attivato e viene visualizzata una notifica persistente per informarti che il sistema sta registrando una traccia, come mostrato nella figura 3:
Figura 3. Notifica persistente che viene visualizzata dopo l'avvio di una traccia di sistema sul dispositivo. Esegui nell'app le azioni che vuoi che il sistema esamini.
Interrompi il monitoraggio toccando il riquadro Monitoraggio sistema nel riquadro Impostazioni rapide o la notifica Monitoraggio sistema.
Il sistema mostra una nuova notifica contenente il messaggio "Salvataggio del tracciato". Al termine del salvataggio, il sistema chiude la notifica e visualizza una terza notifica che conferma che la traccia è stata salvata e che puoi condividere la traccia di sistema, come mostrato nella figura 4:
Figura 4. Notifica persistente che viene visualizzata al termine del salvataggio di una traccia registrata dal sistema.
Registrazione tramite il menu dell'app
Il menu dell'app ti consente di configurare diverse impostazioni avanzate relative al monitoraggio del sistema e fornisce un'opzione per avviare e interrompere una traccia di sistema.
Per registrare una traccia di sistema utilizzando il menu dell'app Monitoraggio sistema, completa i seguenti passaggi:
- Attiva le opzioni sviluppatore.
Apri la schermata delle impostazioni Opzioni sviluppatore. Nella sezione Debug, seleziona Monitoraggio sistema. Si apre l'app Monitoraggio sistema.
In alternativa, se hai configurato il riquadro Monitoraggio sistema, puoi toccarlo e tenerlo premuto per accedere all'app Monitoraggio sistema.
Assicurati che l'opzione Traccia applicazioni di debug sia selezionata per includere le app per le quali è abilitato il debug nella traccia di sistema.
Se vuoi, scegli le Categorie di chiamate di sistema e del sensore da monitorare e una Dimensione del buffer per CPU in KB. Scegli le categorie corrispondenti al caso d'uso che stai testando, ad esempio la categoria Audio per testare le operazioni Bluetooth o la categoria Memoria per le allocazioni dell'heap.
Se vuoi, seleziona Tracce lunghe per attivare le tracce che vengono salvate continuamente nello spazio di archiviazione del dispositivo. Per questa opzione, imposta i limiti per le Dimensioni massime della traccia lunga e la Durata massima della traccia lunga.
Attiva l'opzione Registra traccia, evidenziata in figura 5. Il riquadro viene attivato e viene visualizzata una notifica persistente che ti informa che il sistema sta registrando una traccia, come mostrato nella Figura 3.
Figura 5. L'opzione Registra traccia nelle impostazioni di monitoraggio del sistema. Esegui nell'app le azioni che vuoi che il sistema esamini.
Interrompi il monitoraggio disattivando l'opzione Registra traccia.
Il sistema mostra una nuova notifica contenente il messaggio "Salvataggio del tracciato". Al termine del salvataggio, il sistema chiude la notifica e visualizza una terza notifica che conferma che la traccia è stata salvata e che puoi condividere la traccia di sistema, come mostrato nella Figura 4.
Condividere un tracciamento del sistema
L'app Monitoraggio sistema ti aiuta a condividere i risultati della traccia del sistema nell'ambito di diversi flussi di lavoro. Su un dispositivo con Android 10 (livello API 29) o versioni successive, i file di traccia vengono salvati con l'estensione del nome file .perfetto-trace e possono essere aperti nell'interfaccia utente di Perfetto. Su un dispositivo con una versione precedente di Android, i file di traccia vengono salvati con l'estensione del nome file .ctrace, che indica il formato Systrace.
Condividere come messaggio
La funzionalità di monitoraggio del sistema ti consente di condividere la traccia raccolta con altre app sul tuo dispositivo. Puoi inviare la traccia al tuo team di sviluppo tramite un'email o un'app di monitoraggio dei bug senza dover collegare un dispositivo alla tua macchina di sviluppo.
Dopo aver registrato una traccia di sistema, tocca la notifica visualizzata sul dispositivo, come quella mostrata nella figura 4. Viene visualizzato il selettore di intent della piattaforma, che ti consente di condividere la traccia utilizzando l'app di messaggistica di tua scelta.
Condividere file dall'app File
Sui dispositivi con Android 10 (livello API 29) o versioni successive, le tracce vengono mostrate nell'app Files. Puoi condividere una traccia da questa app.
Scaricare il report utilizzando ADB
Puoi anche estrarre una traccia di sistema da un dispositivo utilizzando adb. Collega il dispositivo utilizzato per registrare la traccia alla tua macchina di sviluppo, quindi esegui i seguenti comandi in una finestra del terminale:
cd /path-to-traces-on-my-dev-machine && \ adb pull /data/local/traces/ .
Convertire tra formati di traccia
Puoi convertire i file di traccia di Perfetto nel formato Systrace. Per ulteriori informazioni, consulta la sezione Conversione tra formati di traccia.
Creare un report HTML
Quando condividi la traccia, il report stesso si trova in un file .perfetto-trace su dispositivi con Android 10 o versioni successive oppure in un file .ctrace per tutte le altre versioni.
Crea un report HTML dal file di traccia utilizzando un'interfaccia utente basata sul web o dalla riga di comando.
Interfaccia utente basata sul web
Utilizza l'interfaccia utente di Perfetto per aprire il file di traccia e generare il report.
Per un file Perfetto, fai clic su Apri file di traccia. Per un file Systrace, fai clic su Apri con UI precedente. L'interfaccia utente precedente ha lo stesso aspetto del report Systrace.
Riga di comando
Esegui i seguenti comandi in una finestra del terminale per generare un report HTML dal file di traccia:
cd /path-to-traces-on-my-dev-machine && \
systrace --from-file trace-file-name{.ctrace | .perfetto-trace}
Se non hai già il programma a riga di comando systrace, puoi scaricarlo dal progetto Catapult su GitHub o direttamente dal progetto Android Open Source.
Consigliati per te
- Nota: il testo del link viene visualizzato quando JavaScript è disattivato
- Benchmark nell'integrazione continua
- Acquisire una traccia di sistema dalla riga di comando