Le tracce sono spesso la migliore fonte di informazioni quando si esamina per la prima volta un problema di rendimento. Ti consentono di formulare un'ipotesi sul problema e su dove iniziare a cercare.
Su Android sono supportati due livelli di monitoraggio: monitoraggio di sistema e monitoraggio metodi.
Poiché il monitoraggio del sistema monitora solo le aree contrassegnate specificamente per il monitoraggio, ha un overhead ridotto e non influisce in modo significativo sul rendimento dell'app. Il monitoraggio del sistema è ottimo per vedere il tempo di esecuzione di determinate sezioni del codice.
Il tracciamento del metodo monitora ogni chiamata di funzione nella tua app. È molto costoso e quindi influisce notevolmente sulle prestazioni dell'app, ma ti offre un quadro complessivo di ciò che sta accadendo, di quali funzioni vengono chiamate e della frequenza con cui vengono chiamate.
Per impostazione predefinita, le tracce di sistema non includono singole funzioni componibili. Sono disponibili nelle tracce dei metodi.
Al momento stiamo testando una nuova funzionalità di monitoraggio del sistema per mostrare le funzioni composable all'interno delle tracce di sistema. Offre la bassa invasività del monitoraggio sistema, con i livelli di dettaglio della composizione del monitoraggio dei metodi.
Configurazione per il monitoraggio della composizione
Per provare il monitoraggio della ricostituzione nel tuo progetto, devi eseguire l'aggiornamento almeno alle seguenti versioni:
- Android Studio Flamingo
- Interfaccia utente di Compose: 1.3.0
- Compose Compiler: 1.3.0
Anche il dispositivo o l'emulatore su cui esegui la traccia deve avere almeno il livello API 30.
Inoltre, devi aggiungere una nuova dipendenza dal monitoraggio del runtime di Compose:
implementation("androidx.compose.runtime:runtime-tracing:1.0.0-beta01")
Con questa dipendenza, quando acquisisci una traccia di sistema che include la ricostituzione, puoi vedere automaticamente le funzioni componibili.
Acquisisci una traccia di sistema
Per acquisire una traccia di sistema e vedere in azione il nuovo monitoraggio della ricostituzione, segui questi passaggi:
Apri il profiler:
Fai clic su Cronologia CPU.
Passa all'app fino alla UI che vuoi monitorare, quindi seleziona Tracciamento del sistema e Registra.
Utilizza l'app per causare la ricompozione e interrompere la registrazione. Una volta che la traccia è stata elaborata e visualizzata, dovresti essere in grado di vedere gli elementi componibili nella traccia di ricomposizione. Puoi utilizzare la tastiera e il mouse per eseguire lo zoom e la panoramica della traccia; se non hai dimestichezza con l'esplorazione di una traccia, consulta la documentazione relativa alla registrazione di tracce.
Se fai doppio clic su un composable nel grafico, viene visualizzato il relativo codice sorgente.
Puoi visualizzare i componibili anche nel diagramma a fiamme insieme al file e al numero di riga:
Limitazioni
Overhead dimensioni APK
Anche se abbiamo cercato di ridurre al minimo l'overhead della funzionalità, si è verificato un aumento delle dimensioni dell'APK per le app Compose proveniente dalle stringhe di monitoraggio incorporate nell'APK dal compilatore di Compose. Questo aumento delle dimensioni può essere relativamente ridotto se la tua app non utilizza molto Componi o maggiore per le app con Componi completo. Inoltre, queste stringhe di monitoraggio non sono offuscate, quindi possono essere visualizzate negli strumenti di monitoraggio, come mostrato in precedenza. Il compilatore Compose li inietta in tutte le app, a partire dalla versione 1.3.0.
Le stringhe di tracciamento possono essere rimosse nella build di produzione aggiungendo la seguente regola di proGuard:
-assumenosideeffects public class androidx.compose.runtime.ComposerKt {
boolean isTraceInProgress();
void traceEventStart(int,int,int,java.lang.String);
void traceEventStart(int,java.lang.String);
void traceEventEnd();
}
Queste funzioni potrebbero cambiare in futuro, ma eventuali modifiche verranno indicate nelle note di rilascio di Scrivi.
Tieni presente che, se li mantieni, pur con un costo aggiuntivo per le dimensioni dell'APK, hai la garanzia che l'APK di cui viene eseguito il profilo sia lo stesso che viene eseguito dagli utenti dell'app.
Tempistica accurata
Per un profilo accurato, come per qualsiasi test delle prestazioni, devi impostare l'app su profileable
e non-debuggable
come indicato in App profilabili.
Acquisire una traccia dal terminale
È possibile acquisire una traccia della composizione dal terminale. Per farlo, devi eseguire i passaggi che normalmente Android Studio esegue automaticamente per te.
Aggiungi dipendenze
Innanzitutto, aggiungi le dipendenze aggiuntive all'app.
implementation("androidx.tracing:tracing-perfetto:1.0.0")
implementation("androidx.tracing:tracing-perfetto-binary:1.0.0")
Genera un comando record
- Genera un comando di registrazione utilizzando Perfetto.
Aggiungi manualmente la sezione dell'origine dati
track_event
come nell'esempio seguente:adb shell perfetto \ -c - --txt \ -o /data/misc/perfetto-traces/trace \ <<EOF buffers: { size_kb: 63488 fill_policy: RING_BUFFER } buffers: { size_kb: 2048 fill_policy: RING_BUFFER } data_sources: { config { name: "track_event" } } duration_ms: 10000 flush_period_ms: 30000 incremental_state_config { clear_period_ms: 5000 } EOF
Acquisisci una traccia
- Avvia l'app e prepara la sezione che vuoi tracciare.
Attiva il monitoraggio nell'app emettendo una trasmissione.
# set app package variable, e.g. com.google.samples.apps.nowinandroid.debug # can be found through `adb shell ps -ef` or `adb shell cmd package list packages` package=<your app process> # issue a broadcast to enable tracing adb shell am broadcast \ -a androidx.tracing.perfetto.action.ENABLE_TRACING \ $package/androidx.tracing.perfetto.TracingReceiver
Avvia il comando di registrazione creato in precedenza.
Apri la traccia
adb pull <location>
la traccia dal dispositivo (posizione specificata nel comando record).Apri in Perfetto.
Acquisisci una traccia con Jetpack Macrobenchmark
Puoi misurare il rendimento con Jetpack Macrobenchmark, che fornisce le tracce come risultati. Per attivare il monitoraggio della composizione con i macrobenchmark, devi:
Aggiungi queste dipendenze aggiuntive al modulo di test Macrobenchmark:
implementation("androidx.tracing:tracing-perfetto:1.0.0") implementation("androidx.tracing:tracing-perfetto-binary:1.0.0")
Aggiungi l'argomento di misurazione
androidx.benchmark.fullTracing.enable=true
prima di eseguire i benchmark. Consulta Argomenti di misurazione di Macrobenchmark per ulteriori informazioni sugli argomenti di misurazione di Macrobenchmark.
Feedback
Ci piacerebbe ricevere il tuo feedback su questa funzionalità, eventuali bug riscontrati e richieste. Puoi inviarci feedback tramite il tracker dei problemi.