Metriche

Dichiara le dipendenze

Per aggiungere una dipendenza da Metrics, devi aggiungere il repository Maven di Google al tuo progetto. Per saperne di più, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle per la tua app o il tuo modulo:

dependencies {
    implementation "androidx.metrics:metrics-performance:1.0.0-beta03"
}

dependencies {
    implementation("androidx.metrics:metrics-performance:1.0.0-beta03")
}

Per saperne di più sulle dipendenze, consulta Aggiungi dipendenze di build.

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.0.0

Versione 1.0.0-beta03

27 agosto 2025

androidx.metrics:metrics-performance:1.0.0-beta03 viene rilasciata. La versione 1.0.0-beta03 contiene questi commit.

Correzioni di bug

• Correzione di IllegalArgumentException("tentativo di rimozione di OnFrameMetricsAvailableListener che non è mai stato aggiunto"). Non viene effettuato alcun tentativo di registrare la sincronizzazione dei frame quando una finestra non è accelerata dall'hardware, in quanto questa operazione non è supportata da Window.OnFrameMetricsAvailableListener. (I8fef2, b/436880904)

Versione 1.0.0-beta02

12 marzo 2025

androidx.metrics:metrics-performance:1.0.0-beta02 viene rilasciata. La versione 1.0.0-beta02 contiene questi commit.

Correzioni di bug

• Correzione degli arresti anomali DelegatingFrameMetricsListener cannot be cast... (Id891c, b/311218678).

Versione 1.0.0-beta01

10 gennaio 2024

L'API e la funzionalità di questa libreria sono stabili da un po' di tempo. Questa release sposta semplicemente la libreria in versione beta.

androidx.metrics:metrics-performance:1.0.0-beta01 viene rilasciata. La versione 1.0.0-beta01 contiene questi commit.

Versione 1.0.0-alpha04

5 aprile 2023

Questa release aggiorna JankStats alle ultime correzioni, che includono informazioni di temporizzazione più accurate e complete.

androidx.metrics:metrics-performance:1.0.0-alpha04 viene rilasciata. La versione 1.0.0-alpha04 contiene questi commit.

Modifiche alle API

• cpuDuration ora più preciso, inoltre nuovo totalDuration su API31 (I59ce8, b/243694893)

Versione 1.0.0-alpha03

27 luglio 2022

androidx.metrics:metrics-performance:1.0.0-alpha03 viene rilasciata. La versione 1.0.0-alpha03 contiene questi commit.

• Questa release contiene perfezionamenti minori delle API man mano che la libreria si avvicina alla versione beta. Una delle modifiche all'API rimuove l'Executor dal metodo di fabbrica createAndTrack() per la creazione di un oggetto JankStats. Ciò ha implicazioni per il callback OnFrameListener, poiché il listener viene ora chiamato sul thread che fornisce i dati per frame a JankStats (il thread principale/UI nelle versioni precedenti all'API 24 e il thread FrameMetrics nell'API 24 e versioni successive). Inoltre, l'oggetto FrameData passato al listener viene ora riutilizzato ogni frame, quindi i dati di questo oggetto devono essere copiati e memorizzati nella cache altrove durante il callback, poiché l'oggetto deve essere considerato obsoleto non appena il listener restituisce.

• Sono state apportate anche varie correzioni di bug, inclusi alcuni problemi di concorrenza.

• Infine, la correzione per riutilizzare FrameData (menzionata sopra) significa che ora non ci sono allocazioni per frame a causa della pubblicazione delle metriche dei frame. Prima non erano molte le allocazioni, ma il nuovo approccio ti consente di utilizzare JankStats senza incorrere in alcun overhead GC per frame nella tua app.

Modifiche alle API

• Nomi di metodi e parametri aggiornati in PerformanceMetricsState per rendere più chiari i risultati di queste chiamate. (I56da5, b/233421985)
• Sono stati aggiunti test di benchmark per monitorare le allocazioni ed eliminate alcune allocazioni interne relative alla gestione dello stato e ai report. Tieni presente che FrameData passato ai listener è ora considerato volatile; questa struttura verrà riutilizzata per il frame successivo e i dati sono affidabili solo fino al ritorno del listener.
• È stato rimosso Executor dal costruttore per JankStats; ora i listener vengono chiamati sul thread su cui sono stati ricevuti i dati interni. (I12743)

Correzioni di bug

• Arresto anomalo corretto a causa della doppia rimozione di OnFrameMetricsAvailableListener (I44094, b/239457413)
• Torna alla logica originale di pubblicazione dei messaggi OnPreDrawListener all'inizio della coda, per una sincronizzazione dei frame più coerente e prevedibile. (I05a43, b/233358407)
• È stato corretto il bug ConcurrentModificationException per cui l'elenco dei delegati del listener veniva modificato durante l'iterazione per inviare i dati per frame. (Ib7693, b/236612357)

Versione 1.0.0-alpha02

29 giugno 2022

androidx.metrics:metrics-performance:1.0.0-alpha02 viene rilasciata. La versione 1.0.0-alpha02 contiene questi commit.

Modifiche alle API

• Il nome MetricsStateHolder è stato modificato in Supporto (all'interno di PerformanceMetricsState): (I5a4d9, b/226565716, b/213499234)

Correzioni di bug

• È stato risolto un problema di sincronizzazione a causa del quale gli stati potevano essere sostituiti con nuovi valori prima che fossero elaborati i frame in cui lo stato precedente sarebbe stato corretto (aosp/2061892, b/213499234)
• È stata corretta l'eccezione di modifica simultanea nell'aggiunta/rimozione di listener (aosp/2092714, b/213499234)
• Calcoli di startTime più precisi (aosp/2027704, b/213245198)
• Correzione di un bug nell'implementazione di FrameData.equals() (aosp/2025866, b/218296544)

Versione 1.0.0-alpha01

9 febbraio 2022

androidx.metrics:metrics-performance:1.0.0-alpha01 viene rilasciata. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

• La libreria JankStats fornisce funzionalità per instrumentare e ricevere callback nell'applicazione in fase di runtime, il che può aiutare a trovare problemi di prestazioni reali.
• JankStats combina un'API che semplifica l'inserimento di informazioni sullo stato dell'interfaccia utente con funzionalità di monitoraggio e generazione di report sulle prestazioni per frame per consentire agli sviluppatori di capire non se un'applicazione ha problemi di prestazioni, ma quando e perché.