I dispositivi con Android 9 (livello API 28) o versioni successive includono un'app a livello di sistema denominata Tracciamento del sistema. Questa app è simile all'utilità a riga di comando di systrace, ma consente di registrare le tracce direttamente da un dispositivo di test, senza dover collegare il dispositivo e stabilire la connessione 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 tracce in formato Perfetto, mentre i dispositivi precedenti le registrano in formato Systrace. Ti consigliamo di utilizzare Visualizzatore traccia Perfetto per aprire entrambi i formati e per analizzare le tracce.
Consente di registrare le tracce quando si risolvono bug relativi alle prestazioni nella tua app, come avvio lento, transizioni lente o jank dell'interfaccia utente.
Registra una traccia di sistema
L'app Tracciamento del sistema consente di registrare un tracciamento del sistema utilizzando il riquadro Impostazioni rapide o un menu all'interno dell'app stessa. Le seguenti sezioni descrivono come completare il processo di registrazione utilizzando queste interfacce.
Registra usando il riquadro Impostazioni rapide
Il riquadro Impostazioni rapide è in genere il modo più conveniente per completare la procedura di tracciamento del sistema sul dispositivo.
Riquadro di configurazione
Se è la prima volta che utilizzi il tracciamento del sistema sul dispositivo di test o se non vedi il riquadro System Tracciamento (Tracciamento del sistema) nel riquadro Impostazioni rapide del dispositivo, come mostrato nella figura 2, completa i seguenti passaggi di configurazione:
- Attiva Opzioni sviluppatore.
- Apri la schermata delle impostazioni Opzioni sviluppatore.
- Nella sezione Debug, seleziona Tracciamento del sistema. Si apre l'app Tracciamento del sistema, che mostra il menu dell'app.
Dal menu delle app, attiva Mostra il riquadro Impostazioni rapide, come mostrato nella figura 1. Il sistema aggiunge il riquadro Tracciamento del sistema al riquadro Impostazioni rapide, come mostrato nella Figura 2:
Figura 1. Opzione Mostra riquadro Impostazioni rapide nell'app Tracciamento del sistema. 
Figura 2. Il riquadro Tracciamento del sistema nel riquadro Impostazioni rapide. Nota: per impostazione predefinita, il sistema aggiunge il riquadro Tracciamento del sistema come primo riquadro nel riquadro Impostazioni rapide. Se vuoi che il riquadro appaia in una posizione diversa, usa la modalità di modifica del riquadro per spostarlo.
Completare una registrazione delle tracce di sistema
Per registrare un tracciamento del sistema utilizzando il riquadro Impostazioni rapide, procedi nel seguente modo:
Tocca il riquadro Tracciamento del sistema, che ha l'etichetta Registra traccia. Il riquadro diventa abilitato e viene visualizzata una notifica persistente che ti informa 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 tracciamento toccando il riquadro Tracciamento del sistema nel riquadro Impostazioni rapide o nella notifica Tracciamento del sistema.
Il sistema visualizza una nuova notifica con il messaggio "Salvataggio della traccia in corso". Al termine del salvataggio, il sistema ignora la notifica e visualizza una terza notifica, a conferma del fatto 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 dopo che il sistema ha completato il salvataggio di una traccia registrata.
Registra usando il menu delle app
Il menu dell'app consente di configurare diverse impostazioni avanzate relative al tracciamento del sistema e offre un'opzione per avviare e interrompere una traccia del sistema.
Per registrare una traccia di sistema utilizzando il menu dell'app Tracciamento del sistema, procedi nel seguente modo:
- Attiva Opzioni sviluppatore.
Apri la schermata delle impostazioni Opzioni sviluppatore. Nella sezione Debug, seleziona Tracciamento del sistema. Si apre l'app System Tracciamento.
In alternativa, se hai configurato il riquadro Tracciamento del sistema, puoi toccare e tenere premuto il riquadro per accedere all'app System Tracciamento.
Assicurati che l'opzione Trace di applicazioni di cui è possibile eseguire il debug sia selezionata in modo da includere le app con debug abilitato nella traccia del sistema.
Facoltativamente, scegli le Categorie di chiamate di sistema e sensori da tracciare e scegli 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 il test delle operazioni Bluetooth o la categoria Memoria per le allocazioni dell'heap.
(Facoltativo) Seleziona Tracce lunghe per abilitare le tracce che vengono salvate in modo continuo nello spazio di archiviazione del dispositivo. Per questa opzione, imposta i limiti per Dimensione massima della traccia lunga e Durata massima della traccia lunga.
Attiva l'opzione Registra traccia, evidenziata nella figura 5. Il riquadro diventa abilitato 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 Tracciamento del sistema. Esegui nell'app le azioni che vuoi che il sistema esamini.
Interrompi il tracciamento disattivando l'opzione Registra traccia.
Il sistema visualizza una nuova notifica con il messaggio "Salvataggio della traccia in corso". Al termine del salvataggio, il sistema ignora la notifica e visualizza una terza notifica, a conferma del fatto che la traccia è stata salvata e che puoi condividere la traccia di sistema, come mostrato nella Figura 4.
Condividi una traccia di sistema
L'app System Tracciamento consente di condividere i risultati delle tracce di 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'UI 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.
Condividi come messaggio
Il tracciamento del sistema 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 rilevamento di bug senza dover collegare un dispositivo alla 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 intenzione della piattaforma, che ti consente di condividere la traccia utilizzando l'app di messaggistica che preferisci.
Condividi dall'app File
Sui dispositivi con Android 10 (livello API 29) o versioni successive, le tracce vengono mostrate nell'app File. Puoi condividere una traccia da questa app.
Scarica il report utilizzando ADB
Puoi anche estrarre una traccia di sistema da un dispositivo usando adb. Connetti il dispositivo utilizzato per registrare la traccia alla macchina di sviluppo, quindi esegui i comandi seguenti in una finestra del terminale:
cd /path-to-traces-on-my-dev-machine && \ adb pull /data/local/traces/ .
Convertire i formati di traccia
Puoi convertire i file di traccia Perfetto nel formato di Systrace. Per ulteriori informazioni, consulta Conversione tra formati di traccia.
Creare un report HTML
Quando condividi la traccia, il report stesso si trova in un file .perfetto-trace sui 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.
UI basata sul web
Usa la UI perfetta 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. La UI precedente ha lo stesso aspetto del report di Systrace.
Riga di comando
Esegui i comandi seguenti 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 ancora il programma a riga di comando systrace, puoi scaricarlo dal progetto Catapult su GitHub o direttamente dal Progetto open source Android.
Consigliato per te
- Nota: il testo del link viene visualizzato quando JavaScript è disattivato
- Benchmark per l'integrazione continua
- Acquisizione di una traccia del sistema dalla riga di comando