I dispositivi con Android 9 (livello API 28) o versioni successive includono un'app a livello di sistema
chiamata Tracciamento del sistema. Questa app è simile all'utilità a riga di comando systrace, ma ti 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 i dispositivi precedenti le registrano in formato Systrace. Ti consigliamo di utilizzare il visualizzatore di tracce Perfetto per aprire entrambi i formati e poi analizzare le tracce.
È utile registrare le tracce quando si risolvono bug relativi alle prestazioni nell'app, come avvio lento, transizioni lente o jank dell'interfaccia utente.
Registra una traccia di sistema
L'app Tracciamento del sistema ti consente di registrare un tracciamento del sistema utilizzando il riquadro Impostazioni rapide o un menu all'interno dell'app stessa. Le sezioni seguenti descrivono come completare il processo di registrazione utilizzando queste interfacce.
Registra utilizzando il riquadro Impostazioni rapide
Il riquadro Impostazioni rapide è in genere il modo più pratico per completare la procedura di tracciamento del sistema on-device.
Configura il riquadro
Se utilizzi Tracciamento del sistema per la prima volta sul dispositivo di test o se non vedi il riquadro Tracciamento 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 Tracciamento del sistema. Si apre l'app Tracciamento del sistema, che mostra il menu dell'app.
Dal menu dell'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. L'opzione Mostra il riquadro Impostazioni rapide nell'app Tracciamento del sistema. 
Figura 2. Il riquadro Tracciamento del sistema nel pannello 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 venga visualizzato in una posizione diversa, utilizza la modalità di modifica del pannello per spostarlo.
Completa una registrazione di tracciamento del sistema
Per registrare un tracciamento del sistema utilizzando il riquadro Impostazioni rapide, completa i seguenti passaggi:
Tocca il riquadro Tracciamento del sistema, che ha l'etichetta Registra traccia. Il riquadro viene attivato e viene visualizzata una notifica permanente 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 un tracciamento del sistema on-device. Esegui nell'app le azioni che vuoi che il sistema ispezioni.
Interrompi il tracciamento toccando il riquadro Tracciamento del sistema nel riquadro Impostazioni rapide o nella notifica di Tracciamento del sistema.
Il sistema visualizza una nuova notifica contenente il messaggio "Salvataggio della traccia in corso". Al termine del salvataggio, il sistema chiude la notifica e ne visualizza una terza, che conferma che la traccia è stata salvata e che puoi condividere il tracciamento del sistema, come mostrato nella figura 4:
Figura 4. Notifica persistente visualizzata dopo che il sistema ha terminato di salvare una traccia registrata.
Registra utilizzando il menu dell'app
Il menu dell'app ti consente di configurare diverse impostazioni avanzate relative al tracciamento del sistema e fornisce un pulsante di attivazione/disattivazione per avviare e interrompere un tracciamento del sistema.
Per registrare una traccia di sistema utilizzando il menu dell'app Tracciamento del sistema, completa i seguenti passaggi:
- Attiva le Opzioni sviluppatore.
Apri la schermata delle impostazioni Opzioni sviluppatore. Nella sezione Debug, seleziona Tracciamento del sistema. Si apre l'app Tracciamento del sistema.
In alternativa, se configuri il riquadro Tracciamento del sistema, puoi toccarlo e tenerlo premuto per accedere all'app Tracciamento del sistema.
Assicurati che l'opzione Traccia le applicazioni abilitate al debug sia selezionata per includere nel tracciamento del sistema le app per cui è abilitato il debug.
Se vuoi, scegli le Categorie di chiamate di sistema e sensori da tracciare e scegli una Dimensione del buffer per CPU in kB. Scegli le categorie che corrispondono al caso d'uso che stai testando, ad esempio la categoria Audio per testare le operazioni Bluetooth o la categoria Memoria per le allocazioni heap.
Facoltativamente, seleziona Tracce lunghe per attivare le tracce che vengono salvate continuamente nello spazio sul 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 viene attivato e viene visualizzata una notifica permanente per informarti che il sistema sta registrando una traccia, come mostrato nella Figura 3.
Figura 5. L'opzione Registra traccia nelle impostazioni di Tracciamento del sistema. Esegui nell'app le azioni che vuoi che il sistema ispezioni.
Interrompi il tracciamento disattivando l'opzione Registra traccia.
Il sistema visualizza una nuova notifica contenente il messaggio "Salvataggio della traccia in corso". Al termine del salvataggio, il sistema chiude la notifica e ne visualizza una terza, che conferma che il tracciamento del sistema è stato salvato e che puoi condividere il tracciamento del sistema, come mostrato nella figura 4.
Condividi un tracciamento del sistema
L'app Tracciamento del sistema ti aiuta a condividere i risultati del tracciamento 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
.ctrace, che indica il formato Systrace.
Condividi come messaggio
Il Tracciamento 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 connettere un dispositivo alla tua macchina di sviluppo.
Dopo aver registrato un tracciamento del 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 che preferisci.
Condividi dall'app Files
Sui dispositivi con Android 10 (livello API 29) o versioni successive, le tracce vengono visualizzate nell'app File. Puoi condividere una traccia da questa app.
Scarica il report utilizzando ADB
Puoi anche estrarre un tracciamento del sistema da un dispositivo utilizzando adb. Collega il dispositivo utilizzato per registrare la traccia alla 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/ .
Converti tra formati di traccia
Puoi convertire i file di traccia di Perfetto nel formato Systrace. Per saperne di più, consulta Conversione tra formati di traccia.
Crea 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 o in un file .ctrace per tutte le altre versioni.
Crea un report HTML dal file di traccia utilizzando una UI basata sul web o dalla riga di comando.
UI basata sul web
Utilizza la UI 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 l'interfaccia utente precedente. La UI precedente ha lo stesso aspetto del report Systrace.
Riga di comando
Esegui questi 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 ancora il programma a riga di comando systrace, puoi scaricarlo dal progetto Catapult su GitHub o direttamente da Android Open Source Project.
Consigliati per te
- Nota: il testo del link viene visualizzato quando JavaScript è disattivato
- Benchmark nell'integrazione continua
- Acquisisci un tracciamento del sistema dalla riga di comando