Monitoraggio

  
Scrivi eventi di traccia nel buffer di traccia di sistema.
Ultimo aggiornamento Release stabile Candidato per la release Release beta Release alpha
19 novembre 2025 1.3.0 - - -

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa libreria. Prima di segnalare un nuovo problema, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Crea un nuovo problema

Per ulteriori informazioni, consulta la documentazione di Issue Tracker.

Versione 1.3

Versione 1.3.0

23 aprile 2025

androidx.tracing:tracing:1.3.0, androidx.tracing:tracing-android:1.3.0 e androidx.tracing:tracing-ktx:1.3.0 sono stati rilasciati. La versione 1.3.0 contiene questi commit.

Modifiche importanti dalla versione 1.2.0

  • È stata convertita la classe androidx.tracing.Trace in Kotlin e tutto il codice è stato spostato dal modulo tracing-ktx a tracing.
  • Rimuovi crossinline dalla traccia per consentirne l'utilizzo in un @Composable. (I53882, b/248344805)

Versione 1.3.0-rc01

9 aprile 2025

androidx.tracing:tracing:1.3.0-rc01, androidx.tracing:tracing-android:1.3.0-rc01 e androidx.tracing:tracing-ktx:1.3.0-rc01 sono stati rilasciati senza modifiche rispetto all'ultima versione beta. La versione 1.3.0-rc01 contiene questi commit.

Versione 1.3.0-beta01

12 febbraio 2025

androidx.tracing:tracing:1.3.0-beta01, androidx.tracing:tracing-android:1.3.0-beta01 e androidx.tracing:tracing-ktx:1.3.0-beta01 sono stati rilasciati. La versione 1.3.0-beta01 contiene questi commit.

Modifiche alle API

  • Tutto il codice del modulo tracing-ktx è stato spostato in tracing. (Iba550)
  • È stata convertita la classe androidx.tracing.Trace in Kotlin. (Ie4e5d)

Correzioni di bug

  • È stata rimossa la definizione manuale dell'accesso alle nuove API della piattaforma, poiché questa operazione viene eseguita automaticamente tramite la modellazione delle API quando si utilizza R8 con AGP 7.3 o versioni successive (ad es. R8 versione 3.3) e per tutte le build quando si utilizza AGP 8.1 o versioni successive (ad es. D8 versione 8.1). I client che non utilizzano AGP sono invitati a eseguire l'aggiornamento alla versione 8.1 o successive di D8. Consulta questo articolo per ulteriori dettagli. (Ia60e0, b/345472586)

Versione 1.3.0-alpha02

21 giu 2023

androidx.tracing:tracing:1.3.0-alpha02 e androidx.tracing:tracing-ktx:1.3.0-alpha02 vengono rilasciati senza modifiche rispetto alla versione alpha precedente. La versione 1.3.0-alpha02 contiene questi commit.

Versione 1.3.0-alpha01

7 giugno 2023

androidx.tracing:tracing:1.3.0-alpha01 e androidx.tracing:tracing-ktx:1.3.0-alpha01 sono stati rilasciati. La versione 1.3.0-alpha01 contiene questi commit.

Modifiche alle API

  • Rimuovi crossinline dalla traccia per consentirne l'utilizzo in un @Composable. (I53882, b/248344805)

Versione 1.2

Versione 1.2.0

29 novembre 2023

androidx.tracing:tracing:1.2.0 e androidx.tracing:tracing-ktx:1.2.0 sono stati rilasciati. La versione 1.2.0 contiene questi commit.

Modifiche importanti dalla versione 1.1.0

  • Aggiungi le varianti trace() e traceAsync() con il calcolo di stringhe e cookie lazy. Ora salta correttamente anche Trace.end se Trace.begin genera un errore.

Versione 1.2.0-rc01

24 maggio 2023

androidx.tracing:tracing:1.2.0-rc01 e androidx.tracing:tracing-ktx:1.2.0-rc01 sono stati rilasciati. La versione 1.2.0-rc01 contiene questi commit.

Correzioni di bug

  • Evita arresti anomali quando vengono passati nomi di sezioni di traccia lunghi tramite troncamento automatico (Iaf6e2)

Versione 1.2.0-beta04

3 maggio 2023

androidx.tracing:tracing:1.2.0-beta04 e androidx.tracing:tracing-ktx:1.2.0-beta04 vengono rilasciati senza modifiche. La versione 1.2.0-beta04 contiene questi commit.

Versione 1.2.0-beta03

5 aprile 2023

androidx.tracing:tracing:1.2.0-beta03 e androidx.tracing:tracing-ktx:1.2.0-beta03 vengono rilasciati senza nuove modifiche. La versione 1.2.0-beta03 contiene questi commit.

Versione 1.2.0-beta02

22 marzo 2023

androidx.tracing:tracing:1.2.0-beta02 e androidx.tracing:tracing-ktx:1.2.0-beta02 vengono rilasciati senza modifiche rispetto alla beta precedente. La versione 1.2.0-beta02 contiene questi commit.

Versione 1.2.0-beta01

8 marzo 2023

androidx.tracing:tracing:1.2.0-beta01 e androidx.tracing:tracing-ktx:1.2.0-beta01 vengono rilasciati senza modifiche rispetto all'ultima versione alpha. La versione 1.2.0-beta01 contiene questi commit.

Versione 1.2.0-alpha02

23 febbraio 2023

androidx.tracing:tracing:1.2.0-alpha02 e androidx.tracing:tracing-ktx:1.2.0-alpha02 vengono rilasciati senza modifiche rispetto alla versione alpha precedente. La versione 1.2.0-alpha02 contiene questi commit.

Correzioni di bug

  • Questa release correggerà un errore Could not find androidx.tracing:tracing-ktx:1.2.0-alpha02 durante l'upgrade a androidx.tracing: tracing-perfetto-common:1.0.0-alpha11

Versione 1.2.0-alpha01

5 ottobre 2022

androidx.tracing:tracing:1.2.0-alpha01 e androidx.tracing:tracing-ktx:1.2.0-alpha01 sono stati rilasciati. La versione 1.2.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Aggiungi le varianti trace() e traceAsync() con il calcolo di stringhe e cookie lazy. Ora salta correttamente anche Trace.end se Trace.begin genera un errore. (I31421, b/175233952, b/247066503)

Tracciamento versione 1.1

Versione 1.1.0

11 maggio 2022

androidx.tracing:tracing:1.1.0 e androidx.tracing:tracing-ktx:1.1.0 sono stati rilasciati. La versione 1.1.0 contiene questi commit.

Modifiche importanti dalla versione 1.0.0

  • Aggiunta di Trace.forceEnableAppTracing() un'API per forzare l'acquisizione della sezione di traccia dell'app (ovvero le API android.os.Trace / androidx.tracing) nelle build non eseguibili in modalità di debug. Chiama questo metodo all'inizio dell'avvio per attivare la tracciabilità accurata del sistema non eseguibile in modalità di debug prima dell'introduzione del tag manifest profilabile nell'API 29. (I3a309)
  • Evitare errori di verifica della classe quando Trace.java viene caricato per la prima volta (05f6b4 e cb101f)

Versione 1.1.0-rc01

20 aprile 2022

androidx.tracing:tracing:1.1.0-rc01 e androidx.tracing:tracing-ktx:1.1.0-rc01 sono stati rilasciati senza modifiche dal giorno beta01. La versione 1.1.0-rc01 contiene questi commit.

Versione 1.1.0-beta01

1° dicembre 2021

androidx.tracing:tracing:1.1.0-beta01 e androidx.tracing:tracing-ktx:1.1.0-beta01 sono stati rilasciati. La versione 1.1.0-beta01 contiene questi commit.

Nessuna modifica dal giorno 1.1.0-alpha02.

Versione 1.1.0-alpha02

17 novembre 2021

androidx.tracing:tracing:1.1.0-alpha02 e androidx.tracing:tracing-ktx:1.1.0-alpha02 sono stati rilasciati. La versione 1.1.0-alpha02 contiene questi commit.

Nuove funzionalità

  • Aggiunta di Trace.forceEnableAppTracing(), un'API per forzare l'abilitazione dell'acquisizione della sezione di traccia dell'app (ovvero le API android.os.Trace / andoridx.tracing) sulle build non eseguibili in modalità di debug. Chiama questo metodo all'inizio dell'avvio per attivare la tracciabilità accurata del sistema non eseguibile in modalità di debug prima dell'introduzione del tag manifest profilabile nell'API 29. (I3a309)

Versione 1.1.0-alpha01

3 novembre 2021

androidx.tracing:tracing:1.1.0-alpha01 e androidx.tracing:tracing-ktx:1.1.0-alpha01 sono stati rilasciati. La versione 1.1.0-alpha01 contiene questi commit.

Correzioni di bug

  • Evitare errori di verifica della classe quando Trace.java viene caricato per la prima volta (05f6b4 e cb101f)

Tracciamento Perfetto versione 1.0.0

Versione 1.0.1

19 novembre 2025

androidx.tracing:tracing-perfetto:1.0.1, androidx.tracing:tracing-perfetto-binary:1.0.1 e androidx.tracing:tracing-perfetto-handshake:1.0.1 sono stati rilasciati. La versione 1.0.1 contiene questi commit.

Correzioni di bug

  • Supporto delle dimensioni delle pagine di 16 kB (b7a7dd)
  • È stata rimossa la definizione manuale dell'accesso alle nuove API della piattaforma, poiché questa operazione viene eseguita automaticamente tramite la modellazione delle API quando si utilizza R8 con AGP 7.3 o versioni successive (ad es. R8 versione 3.3) e per tutte le build quando si utilizza AGP 8.1 o versioni successive (ad es. D8 versione 8.1). I client che non utilizzano AGP sono invitati a eseguire l'aggiornamento alla versione 8.1 o successive di D8. Consulta questo articolo per ulteriori dettagli. (Ia60e0, b/345472586)
  • Evita di raggruppare copie di FastNative/CriticalNative nella libreria e utilizza le copie della piattaforma stabile. (I8238a, b/35664282, b/280878596)

Versione 1.0.0

4 ottobre 2023

androidx.tracing:tracing-perfetto:1.0.0, androidx.tracing:tracing-perfetto-binary:1.0.0 e androidx.tracing:tracing-perfetto-handshake:1.0.0 sono stati rilasciati. La versione 1.0.0 contiene questi commit.

Funzionalità principali della versione 1.0.0

  • Questa è la prima release stabile delle librerie Tracing-perfetto.

Versione 1.0.0-rc01

20 settembre 2023

androidx.tracing:tracing-perfetto:1.0.0-rc01, androidx.tracing:tracing-perfetto-binary:1.0.0-rc01 e androidx.tracing:tracing-perfetto-handshake:1.0.0-rc01 sono stati rilasciati senza modifiche rispetto all'ultima versione beta. La versione 1.0.0-rc01 contiene questi commit.

Versione 1.0.0-beta03

30 agosto 2023

androidx.tracing:tracing-perfetto:1.0.0-beta03, androidx.tracing:tracing-perfetto-binary:1.0.0-beta03 e androidx.tracing:tracing-perfetto-handshake:1.0.0-beta03 sono stati rilasciati. La versione 1.0.0-beta03 contiene questi commit.

  • Aumento della versione per corrispondere alla release di androidx.benchmark.

Versione 1.0.0-beta02

23 agosto 2023

androidx.tracing:tracing-perfetto:1.0.0-beta02, androidx.tracing:tracing-perfetto-binary:1.0.0-beta02 e androidx.tracing:tracing-perfetto-handshake:1.0.0-beta02 sono stati rilasciati. La versione 1.0.0-beta02 contiene questi commit.

Nuove funzionalità

  • È stato attivato il supporto per la tracciatura all'avvio dell'app (avvio completo).

Versione 1.0.0-beta01

18 luglio 2023

androidx.tracing:tracing-perfetto:1.0.0-beta01, androidx.tracing:tracing-perfetto-binary:1.0.0-beta01 e androidx.tracing:tracing-perfetto-handshake:1.0.0-beta01 sono stati rilasciati. La versione 1.0.0-beta01 contiene questi commit.

Modifiche alle API

  • androidx.tracing.perfetto.Trace rinominato in androidx.tracing.perfetto.PerfettoSdkTrace (I44af8)
  • Rinominate le costanti "codice di uscita" in "codice risultato" nel protocollo per coerenza (Id1d1e)
  • EnableTracingResponse rinominato in Response. (I56275)
  • È stata aggiunta un'opzione per attivare la tracciabilità dell'avviamento a freddo in modalità persistente. È stata aggiunta una funzione per cancellare la traccia dell'avvio a freddo (persistente o meno). (Iaa09d)
  • Le API Perfetto SDK di Tracing sono state rese coerenti con android.os.Trace. (I73ba0, b/282199917)
  • È stato adottato un pattern di fabbrica per LibrarySource, consentendo di aggiungere facilmente all'API casi d'uso futuri (ad es. il caricamento diretto del file .so) se necessario. (I128df)
  • Corrispondenza dei parametri enableTracingColdStart con enableTracingImmediate (I54126)
  • Argomento killProcess rimosso in enableTracingColdStart (I81c4d)

Versione 1.0.0-alpha17

21 giu 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha17, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha17 e androidx.tracing:tracing-perfetto-handshake:1.0.0-alpha17 sono stati rilasciati senza modifiche rispetto alla versione alpha precedente. La versione 1.0.0-alpha17 contiene questi commit.

Versione 1.0.0-alpha16

7 giugno 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha16, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha16 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha16 sono stati rilasciati senza modifiche rispetto alla versione alpha precedente. La versione 1.0.0-alpha16 contiene questi commit.

Versione 1.0.0-alpha15

3 maggio 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha15, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha15 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha15 sono stati rilasciati senza modifiche. La versione 1.0.0-alpha15 contiene questi commit.

Versione 1.0.0-alpha14

5 aprile 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha14, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha14 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha14 sono stati rilasciati senza nuove modifiche. La versione 1.0.0-alpha14 contiene questi commit.

Versione 1.0.0-alpha13

22 marzo 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha13, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha13 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha13 sono stati rilasciati senza modifiche rispetto all'ultima release. La versione 1.0.0-alpha13 contiene questi commit.

Versione 1.0.0-alpha12

8 marzo 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha12, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha12 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha12 sono stati rilasciati senza modifiche rispetto alla versione alpha precedente. La versione 1.0.0-alpha12 contiene questi commit.

Versione 1.0.0-alpha11

22 febbraio 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha11, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha11 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha11 sono stati rilasciati senza modifiche. La versione 1.0.0-alpha11 contiene questi commit.

Versione 1.0.0-alpha10

8 febbraio 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha10, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha10 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha10 vengono rilasciati senza modifiche. La versione 1.0.0-alpha10 contiene questi commit.

Versione 1.0.0-alpha09

10 febbraio 2023

androidx.tracing:tracing-perfetto-binary:1.0.0-alpha09 è stato rilasciato. La versione 1.0.0-alpha09 contiene questi commit.

Nuove funzionalità

  • Rilascio dell'incremento di versione per consentire il funzionamento congiunto di altre librerie androidx.tracing:tracing-perfetto*: 1.0.0-alpha09.

11 gennaio 2023

androidx.tracing:tracing-perfetto:1.0.0-alpha09 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha09 vengono rilasciati senza modifiche. La versione 1.0.0-alpha09 contiene questi commit.

Versione 1.0.0-alpha08

7 dicembre 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha08, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha08 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha08 sono stati rilasciati. La versione 1.0.0-alpha08 contiene questi commit.

Nuove funzionalità

  • Miglioramento del rendimento grazie all'ottimizzazione della gestione delle stringhe.

Correzioni di bug

  • È stata aggiunta una regola proguard che impedisce l'eliminazione dei metodi di PerfettoNative se la classe viene utilizzata (impedisce un arresto anomalo in un caso di nicchia quando viene inizializzato il tracciamento, ma non sono presenti chiamate di tracciamento nell'app).

Versione 1.0.0-alpha07

9 novembre 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha07, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha07 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha07 sono stati rilasciati. La versione 1.0.0-alpha07 contiene questi commit.

  • Riduzione dell'overhead JNI delle API androidx.tracing:tracing-perfetto.

Versione 1.0.0-alpha06

24 ottobre 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha06, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha06 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha06 sono stati rilasciati. La versione 1.0.0-alpha06 contiene questi commit.

  • Questo aggiornamento non include modifiche, ma solo l'aggiornamento del numero di versione per la sincronizzazione con androidx.benchmark.

Versione 1.0.0-alpha05

5 ottobre 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha05, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha05 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha05 sono stati rilasciati. La versione 1.0.0-alpha05 contiene questi commit.

Versione 1.0.0-alpha04

21 settembre 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha04, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha04 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha04 sono stati rilasciati. La versione 1.0.0-alpha04 contiene questi commit.

Versione 1.0.0-alpha03

7 settembre 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha03, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha03 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha03 sono stati rilasciati.

Nuove funzionalità

  • Nessuna nuova funzionalità dalla versione 1.0.0-alpha02.

Versione 1.0.0-alpha02

24 agosto 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha02, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha02 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha02 sono stati rilasciati. La versione 1.0.0-alpha02 contiene questi commit.

Correzioni di bug

  • Diversi miglioramenti all'inizializzazione del servizio Perfetto
  • Migliore gestione di un caso senza risposta tramite l'introduzione di un codice di uscita dedicato: RESULT_CODE_CANCELLED.
  • Miglioramento della gestione degli errori di analisi.
  • EnableTracingResponse.requiredVersion è stato reso annullabile, in quanto non possiamo conoscere la versione se non possiamo comunicare con il pacchetto. (I5ba20)

Versione 1.0.0-alpha01

27 luglio 2022

androidx.tracing:tracing-perfetto:1.0.0-alpha01, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha01 e androidx.tracing:tracing-perfetto-common:1.0.0-alpha01 sono stati rilasciati. La versione 1.0.0-alpha01 contiene questi commit.

  • Nota: tutte le librerie androidx.tracing:tracing-perfetto* sono inizialmente destinate solo all'uso interno nelle librerie AndroidX. Non dovresti aver bisogno di dipendere direttamente da loro.

Nuove funzionalità

  • Tutte le librerie androidx.tracing:tracing-perfetto* sono inizialmente destinate solo all'uso interno nelle librerie AndroidX e non dovresti aver bisogno di utilizzarle direttamente. Stiamo documentando questi dettagli di implementazione per garantire la trasparenza.

  • androidx.tracing:tracing-perfetto è una libreria che consente di scrivere eventi di traccia utilizzando l'SDK Perfetto a basso overhead. Può essere utilizzato in Benchmark, Android Studio o nell'interfaccia utente di Perfetto.

  • androidx.tracing:tracing-perfetto-binary è un insieme di dipendenze binarie richieste per androidx.tracing:tracing-perfetto.

  • androidx.tracing:tracing-perfetto-common è una dipendenza interna di androidx.tracing:tracing-perfetto e può essere utilizzata dagli strumenti per l'integrazione con androidx.tracing:tracing-perfetto.

Tracciamento versione 1.0.0

Versione 1.0.0

28 ottobre 2020

androidx.tracing:tracing:1.0.0 e androidx.tracing:tracing-ktx:1.0.0 sono stati rilasciati. La versione 1.0.0 contiene questi commit.

Funzionalità principali della versione 1.0.0

Aiuta a scrivere eventi di traccia nel buffer di traccia del sistema. Questo può essere visualizzato utilizzando strumenti come Systrace e Perfetto. Questa libreria sostituisce la classe androidx.core.os.TraceCompat deprecata.

Versione 1.0.0-rc01

14 ottobre 2020

androidx.tracing:tracing:1.0.0-rc01 e androidx.tracing:tracing-ktx:1.0.0-rc01 sono stati rilasciati. La versione 1.0.0-rc01 contiene questi commit.

Questa release è identica a 1.0.0-beta01.

Versione 1.0.0-beta01

24 giugno 2020

androidx.tracing:tracing:1.0.0-beta01 e androidx.tracing:tracing-ktx:1.0.0-beta01 vengono rilasciati senza modifiche dal giorno 1.0.0-alpha01. La versione 1.0.0-beta01 contiene questi commit.

Versione 1.0.0-alpha01

10 giugno 2020

androidx.tracing:tracing:1.0.0-alpha01 e androidx.tracing:tracing-ktx:1.0.0-alpha01 sono stati rilasciati. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

androidx.tracing è una libreria che consente di scrivere eventi di traccia nel buffer di traccia del sistema. Questo può essere visualizzato utilizzando strumenti come Systrace e Perfetto. Questa libreria sostituisce la classe androidx.core.os.TraceCompat, deprecata. Questa release iniziale è 1.0.0-alpha01.