Tracing

  
Écrivez les événements de trace dans le tampon de trace du système.
Dernière mise à jour Version stable Version finale Version bêta Version alpha
29 novembre 2023 1.2.0 - - 1.3.0-alpha02

Commentaires

Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.

Signaler un nouveau problème

Pour en savoir plus, consultez les documents sur l'outil Issue Tracker.

Version 1.3

Version 1.3.0-alpha02

21 juin 2023

Publication d'androidx.tracing:tracing:1.3.0-alpha02 et d'androidx.tracing:tracing-ktx:1.3.0-alpha02 sans aucune modification par rapport à la version alpha précédente. Liste des commits de la version 1.3.0-alpha02.

Version 1.3.0-alpha01

7 juin 2023

Publication d'androidx.tracing:tracing:1.3.0-alpha01 et d'androidx.tracing:tracing-ktx:1.3.0-alpha01. Liste des commits de la version 1.3.0-alpha01

Modifications apportées à l'API

  • Suppression du crossinline de la trace pour permettre l'utilisation dans un @Composable. (I53882, b/248344805).

Version 1.2

Version 1.2.0

29 novembre 2023

Publication d'androidx.tracing:tracing:1.2.0 et d'androidx.tracing:tracing-ktx:1.2.0. Liste des commits de la version 1.2.0

Changements importants depuis la version 1.1.0

  • Ajout des variantes trace() et traceAsync() avec calcul différé des chaînes et des cookies. De plus, Trace.end est désormais correctement ignoré si Trace.begin est généré.

Version 1.2.0-rc01

24 mai 2023

Publication d'androidx.tracing:tracing:1.2.0-rc01 et d'androidx.tracing:tracing-ktx:1.2.0-rc01. Liste des commits de la version 1.2.0-rc01.

Correction de bugs

  • Prévention des plantages lorsque les noms de section de trace longs sont transmis en les tronquant automatiquement. (Iaf6e2)

Version 1.2.0-beta04

3 mai 2023

Publication d'androidx.tracing:tracing:1.2.0-beta04 et androidx.tracing:tracing-ktx:1.2.0-beta04 sans aucune modification. Liste des commits de la version 1.2.0-beta04

Version 1.2.0-beta03

5 avril 2023

Publication d'androidx.tracing:tracing:1.2.0-beta03 et d'androidx.tracing:tracing-ktx:1.2.0-beta03 sans aucune nouvelle modification. Liste des commits de la version 1.2.0-beta03

Version 1.2.0-beta02

22 mars 2023

Publication d'androidx.tracing:tracing:1.2.0-beta02 et d'androidx.tracing:tracing-ktx:1.2.0-beta02 sans modification par rapport à la version bêta précédente. Liste des commits de la version 1.2.0-beta02

Version 1.2.0-beta01

8 mars 2023

Publication d'androidx.tracing:tracing:1.2.0-beta01 et d'androidx.tracing:tracing-ktx:1.2.0-beta01 sans aucune modification par rapport à la dernière version alpha. Liste des commits de la version 1.2.0-beta01

Version 1.2.0-alpha02

23 février 2023

Publication d'androidx.tracing:tracing:1.2.0-alpha02 et d'androidx.tracing:tracing-ktx:1.2.0-alpha02 sans aucune modification par rapport à la version alpha précédente. Liste des commits de la version 1.2.0-alpha02

Correction de bugs

  • Cette version corrigera une erreur Could not find androidx.tracing:tracing-ktx:1.2.0-alpha02 lors du passage à androidx.tracing: tracing-perfetto-common:1.0.0-alpha11

Version 1.2.0-alpha01

5 octobre 2022

Publication d'androidx.tracing:tracing:1.2.0-alpha01 et d'androidx.tracing:tracing-ktx:1.2.0-alpha01. Liste des commits de la version 1.2.0-alpha01

Nouvelles fonctionnalités

  • Ajout des variantes trace() et traceAsync() avec calcul différé des chaînes et des cookies. De plus, Trace.end est désormais correctement ignoré si Trace.begin est généré. (I31421, b/175233952, b/247066503)

Tracing version 1.1

Version 1.1.0

11 mai 2022

Publication d'androidx.tracing:tracing:1.1.0 et d'androidx.tracing:tracing-ktx:1.1.0. Liste des commits de la version 1.1.0

Changements importants depuis la version 1.0.0

  • Ajout de Trace.forceEnableAppTracing(), une API permettant de forcer l'activation de la capture de sections de trace d'application (API android.os.Trace/androidx.tracing) sur les builds non débogables. Appelez-la au début du démarrage pour activer le traçage système précis non débogable avant l'introduction de la balise du manifeste profilable dans l'API 29. (I3a309)
  • Permet d'éviter les erreurs de validation de classe lors du premier chargement de Trace.java (05f6b4 et cb101f)

Version 1.1.0-rc01

20 avril 2022

Publication d'androidx.tracing:tracing:1.1.0-rc01 et androidx.tracing:tracing-ktx:1.1.0-rc01 sans aucune modification par rapport à la version beta01. Liste des commits de la version 1.1.0-rc01

Version 1.1.0-beta01

1er décembre 2021

Publication d'androidx.tracing:tracing:1.1.0-beta01 et d'androidx.tracing:tracing-ktx:1.1.0-beta01. Liste des commits de la version 1.1.0-beta01

Aucune modification par rapport à la version 1.1.0-alpha02.

Version 1.1.0-alpha02

17 novembre 2021

Publication d'androidx.tracing:tracing:1.1.0-alpha02 et d'androidx.tracing:tracing-ktx:1.1.0-alpha02. Liste des commits de la version 1.1.0-alpha02

Nouvelles fonctionnalités

  • Ajout de Trace.forceEnableAppTracing(), une API permettant de forcer l'activation de la capture de sections de trace d'application (API android.os.Trace/androidx.tracing) sur les builds non débogables. Appelez-la au début du démarrage pour activer le traçage système précis non débogable avant l'introduction de la balise du manifeste profilable dans l'API 29. (I3a309)

Version 1.1.0-alpha01

3 novembre 2021

Publication d'androidx.tracing:tracing:1.1.0-alpha01 et d'androidx.tracing:tracing-ktx:1.1.0-alpha01. Liste des commits de la version 1.1.0-alpha01

Correction de bugs

  • Permet d'éviter les erreurs de validation de classe lors du premier chargement de Trace.java (05f6b4 et cb101f)

Tracing Perfetto version 1.0.0

Version 1.0.0

4 octobre 2023

Publication d'androidx.tracing:tracing-perfetto:1.0.0, androidx.tracing:tracing-perfetto-binary:1.0.0 et androidx.tracing:tracing-perfetto-handshake:1.0.0. Liste des commits de la version 1.0.0

Principales fonctionnalités de la version 1.0.0

  • Première version stable des bibliothèques Tracing-perfetto.

Version 1.0.0-rc01

20 septembre 2023

Publication d'androidx.tracing:tracing-perfetto:1.0.0-rc01, d'androidx.tracing:tracing-perfetto-binary:1.0.0-rc01 et d'androidx.tracing:tracing-perfetto-handshake:1.0.0-rc01 sans aucune modification par rapport à la dernière version bêta. Liste des commits de la version 1.0.0-rc01

Version 1.0.0-beta03

30 août 2023

Publication d'androidx.tracing:tracing-perfetto:1.0.0-beta03, androidx.tracing:tracing-perfetto-binary:1.0.0-beta03 et androidx.tracing:tracing-perfetto-handshake:1.0.0-beta03. Liste des commits de la version 1.0.0-beta03.

  • Augmentation de la version pour correspondre à la version d'androidx.benchmark.

Version 1.0.0-beta02

23 août 2023

Publication d'androidx.tracing:tracing-perfetto:1.0.0-beta02, androidx.tracing:tracing-perfetto-binary:1.0.0-beta02 et androidx.tracing:tracing-perfetto-handshake:1.0.0-beta02. Liste des commits de la version 1.0.0-beta02

Nouvelles fonctionnalités

  • Activation de la prise en charge du traçage au démarrage de l'application (démarrage à froid).

Version 1.0.0-beta01

18 juillet 2023

Publication d'androidx.tracing:tracing-perfetto:1.0.0-beta01, androidx.tracing:tracing-perfetto-binary:1.0.0-beta01 et androidx.tracing:tracing-perfetto-handshake:1.0.0-beta01. Liste des commits de la version 1.0.0-beta01

Modifications apportées à l'API

  • Changement de nom : androidx.tracing.perfetto.Trace devient androidx.tracing.perfetto.PerfettoSdkTrace. (I44af8)
  • Remplacement du nom du "code de sortie" par les constantes "code de résultat" dans le protocole par souci de cohérence. (Id1d1e)
  • Changement de nom : EnableTracingResponse devient Response. (I56275).
  • Ajout d'une option permettant d'activer le traçage de démarrage à froid en mode persistant. Ajout d'une fonction pour effacer le traçage des démarrages à froid (persistant ou non). (Iaa09d).
  • Amélioration de la cohérence des API de traçage Perfetto avec android.os.Trace. (I73ba0, b/282199917).
  • Migration vers un modèle de fabrique pour LibrarySource permettant d'ajouter facilement de futurs cas d'utilisation (par exemple, chargement direct du fichier .so) à l'API si nécessaire. (I128df).
  • Mise en correspondance des paramètres enableTracingColdStart avec enableTracingImmediate. (I54126)
  • Suppression de l'argument killProcess dans enableTracingColdStart. (I81c4d)

Version 1.0.0-alpha17

21 juin 2023

Publication d'androidx.tracing:tracing-perfetto:1.0.0-alpha17, d'androidx.tracing:tracing-perfetto-binary:1.0.0-alpha17 et d'androidx.tracing:tracing-perfetto-handshake:1.0.0-alpha17 sans aucune modification par rapport à la version alpha précédente. Liste des commits de la version 1.0.0-alpha17

Version 1.0.0-alpha16

7 juin 2023

Publication d'androidx.tracing:tracing-perfetto:1.0.0-alpha16, d'androidx.tracing:tracing-perfetto-binary:1.0.0-alpha16 et d'androidx.tracing:tracing-perfetto-common:1.0.0-alpha16 sans aucune modification par rapport à la version alpha précédente. Liste des commits de la version 1.0.0-alpha16

Version 1.0.0-alpha15

3 mai 2023

Publication d'androidx.tracing:tracing-perfetto:1.0.0-alpha15, d'androidx.tracing:tracing-perfetto-binary:1.0.0-alpha15 et d'androidx.tracing:tracing-perfetto-common:1.0.0-alpha15 sans aucune modification. Liste des commits de la version 1.0.0-alpha15

Version 1.0.0-alpha14

5 avril 2023

Publication d'androidx.tracing:tracing-perfetto:1.0.0-alpha14, d'androidx.tracing:tracing-perfetto-binary:1.0.0-alpha14 et d'androidx.tracing:tracing-perfetto-common:1.0.0-alpha14 sans aucune nouvelle modification. Liste des commits de la version 1.0.0-alpha14

Version 1.0.0-alpha13

22 mars 2023

Publication d'androidx.tracing:tracing-perfetto:1.0.0-alpha13, d'androidx.tracing:tracing-perfetto-binary:1.0.0-alpha13 et d'androidx.tracing:tracing-perfetto-common:1.0.0-alpha13 sans aucune modification par rapport à la dernière version. Liste des commits de la version 1.0.0-alpha13

Version 1.0.0-alpha12

8 mars 2023

Publication d'androidx.tracing:tracing-perfetto:1.0.0-alpha12, d'androidx.tracing:tracing-perfetto-binary:1.0.0-alpha12 et d'androidx.tracing:tracing-perfetto-common:1.0.0-alpha12 sans aucune modification par rapport à la version alpha précédente. Liste des commits de la version 1.0.0-alpha12

Version 1.0.0-alpha11

22 février 2023

Publication d'androidx.tracing:tracing-perfetto:1.0.0-alpha11, d'androidx.tracing:tracing-perfetto-binary:1.0.0-alpha11 et d'androidx.tracing:tracing-perfetto-common:1.0.0-alpha11 sans aucune modification. Liste des commits de la version 1.0.0-alpha11

Version 1.0.0-alpha10

8 février 2023

Publication d'androidx.tracing:tracing-perfetto:1.0.0-alpha10, d'androidx.tracing:tracing-perfetto-binary:1.0.0-alpha10 et d'androidx.tracing:tracing-perfetto-common:1.0.0-alpha10 sans aucune modification. Liste des commits de la version 1.0.0-alpha10

Version 1.0.0-alpha09

10 février 2023

Publication d'androidx.tracing:tracing-perfetto-binary:1.0.0-alpha09. Liste des commits de la version 1.0.0-alpha09

Nouvelles fonctionnalités

  • Correctif de version permettant aux autres bibliothèques androidx.tracing:tracing-perfetto*: 1.0.0-alpha09 de fonctionner ensemble.

11 janvier 2023

Publication d'androidx.tracing:tracing-perfetto:1.0.0-alpha09 et androidx.tracing:tracing-perfetto-common:1.0.0-alpha09 sans aucune modification. Liste des commits de la version 1.0.0-alpha09

Version 1.0.0-alpha08

7 décembre 2022

Publication d'androidx.tracing:tracing-perfetto:1.0.0-alpha08, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha08 et androidx.tracing:tracing-perfetto-common:1.0.0-alpha08. Liste des commits de la version 1.0.0-alpha08.

Nouvelles fonctionnalités

  • Amélioration des performances grâce à l'optimisation de la gestion des chaînes.

Correction de bugs

  • Ajout d'une règle ProGuard empêchant l'élagage des méthodes de PerfettoNative si la classe est utilisée (évite un plantage dans le cas rare où le traçage est initialisé, mais qu'aucun appel de traçage n'est présent dans l'application).

Version 1.0.0-alpha07

9 novembre 2022

Publication d'androidx.tracing:tracing-perfetto:1.0.0-alpha07, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha07 et androidx.tracing:tracing-perfetto-common:1.0.0-alpha07. Liste des commits de la version 1.0.0-alpha07

  • Réduction de la surcharge JNI des API androidx.tracing:tracing-perfetto.

Version 1.0.0-alpha06

24 octobre 2022

Publication d'androidx.tracing:tracing-perfetto:1.0.0-alpha06, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha06 et androidx.tracing:tracing-perfetto-common:1.0.0-alpha06. Liste des commits de la version 1.0.0-alpha06

  • Cette mise à jour n'inclut aucune modification. Il s'agit seulement de la mise à jour du numéro de version pour le synchroniser avec androidx.benchmark.

Version 1.0.0-alpha05

5 octobre 2022

Publication d'androidx.tracing:tracing-perfetto:1.0.0-alpha05, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha05 et androidx.tracing:tracing-perfetto-common:1.0.0-alpha05. Liste des commits de la version 1.0.0-alpha05

Version 1.0.0-alpha04

21 septembre 2022

Publication d'androidx.tracing:tracing-perfetto:1.0.0-alpha04, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha04 et androidx.tracing:tracing-perfetto-common:1.0.0-alpha04. Liste des commits de la version 1.0.0-alpha04

Version 1.0.0-alpha03

7 septembre 2022

Publication d'androidx.tracing:tracing-perfetto:1.0.0-alpha03, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha03 et androidx.tracing:tracing-perfetto-common:1.0.0-alpha03.

Nouvelles fonctionnalités

  • Aucune nouvelle fonctionnalité depuis la version 1.0.0-alpha02.

Version 1.0.0-alpha02

24 août 2022

Publication d'androidx.tracing:tracing-perfetto:1.0.0-alpha02, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha02 et androidx.tracing:tracing-perfetto-common:1.0.0-alpha02. Liste des commits de la version 1.0.0-alpha02

Correction de bugs

  • Plusieurs améliorations apportées à l'initialisation du service Perfetto
  • Amélioration de la gestion d'une demande sans réponse en introduisant un code de sortie dédié : RESULT_CODE_CANCELLED
  • Amélioration de la gestion des erreurs d'analyse
  • EnableTracingResponse.requiredVersion peut désormais avoir une valeur nulle, car nous ne pouvons pas connaître la version si nous ne parvenons pas à communiquer avec le package. (I5ba20)

Version 1.0.0-alpha01

27 juillet 2022

Publication d'androidx.tracing:tracing-perfetto:1.0.0-alpha01, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha01 et androidx.tracing:tracing-perfetto-common:1.0.0-alpha01. Liste des commits de la version 1.0.0-alpha01

  • Remarque : Toutes les bibliothèques androidx.tracing:tracing-perfetto* sont initialement destinées à être utilisées uniquement en interne dans des bibliothèques AndroidX. Vous n'avez pas besoin d'en dépendre directement.

Nouvelles fonctionnalités

  • Toutes les bibliothèques androidx.tracing:tracing-perfetto* sont initialement destinées à être utilisées uniquement en interne dans des bibliothèques AndroidX et vous n'avez pas besoin d'en dépendre directement. Nous sommes en train de documenter ces détails de mise en œuvre à des fins de transparence.

  • androidx.tracing:tracing-perfetto est une bibliothèque qui permet d'écrire des événements de trace à l'aide du SDK Perfetto, dont les frais généraux sont limités. Elle peut être utilisée dans l'interface utilisateur de Benchmark, Android Studio ou Perfetto.

  • androidx.tracing:tracing-perfetto-binary est un ensemble de dépendances binaires requises pour androidx.tracing:tracing-perfetto.

  • androidx.tracing:tracing-perfetto-common est une dépendance interne d'androidx.tracing:tracing-perfetto et peut être utilisée par les outils pour l'intégration à androidx.tracing:tracing-perfetto.

Tracing version 1.0.0

Version 1.0.0

28 octobre 2020

Publication d'androidx.tracing:tracing:1.0.0 et d'androidx.tracing:tracing-ktx:1.0.0. Liste des commits de la version 1.0.0

Principales fonctionnalités de la version 1.0.0

Permet d'écrire des événements de trace dans le tampon de trace du système. Vous pouvez visualiser ces événements à l'aide d'outils tels que Systrace et Perfetto. Cette bibliothèque remplace la classe androidx.core.os.TraceCompat, qui est maintenant obsolète.

Version 1.0.0-rc01

14 octobre 2020

Publication d'androidx.tracing:tracing:1.0.0-rc01 et d'androidx.tracing:tracing-ktx:1.0.0-rc01. Liste des commits de la version 1.0.0-rc01

Cette version est identique à la version 1.0.0-beta01.

Version 1.0.0-beta01

24 juin 2020

Publication d'androidx.tracing:tracing:1.0.0-beta01 et d'androidx.tracing:tracing-ktx:1.0.0-beta01 sans modification par rapport à la version 1.0.0-alpha01. Liste des commits de la version 1.0.0-beta01

Version 1.0.0-alpha01

10 juin 2020

Publication d'androidx.tracing:tracing:1.0.0-alpha01 et d'androidx.tracing:tracing-ktx:1.0.0-alpha01. Liste des commits de la version 1.0.0-alpha01

Nouvelles fonctionnalités

androidx.tracing est une bibliothèque qui permet d'écrire des événements de trace dans le tampon de trace du système. Vous pouvez visualiser ces événements à l'aide d'outils tels que Systrace et Perfetto. Cette bibliothèque remplace la classe androidx.core.os.TraceCompat, qui est maintenant obsolète. Cette version initiale est la version 1.0.0-alpha01.