Traçage

  
Écrivez les événements de trace dans le tampon de trace système.
Dernière mise à jour Version stable Version finale Version bêta Version alpha
12 février 2025 1.2.0 - 1.3.0-beta01 -

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-beta01

12 février 2025

Publication d'androidx.tracing:tracing:1.3.0-beta01, androidx.tracing:tracing-android:1.3.0-beta01 et androidx.tracing:tracing-ktx:1.3.0-beta01. La version 1.3.0-beta01 contient ces commits.

Modifications apportées à l'API

  • Déplacement de tout le code du module tracing-ktx vers tracing. (Iba550)
  • Conversion de la classe androidx.tracing.Trace en Kotlin. (Ie4e5d)

Correction de bugs

  • Suppression de la description manuelle de l'accès aux nouvelles API de la plate-forme, car cela se produit automatiquement via la modélisation d'API lorsque vous utilisez R8 avec AGP 7.3 ou version ultérieure (par exemple, R8 version 3.3) et pour tous les builds lorsque vous utilisez AGP 8.1 ou version ultérieure (par exemple, D8 version 8.1). Les clients qui n'utilisent pas AGP sont invités à passer à la version 8.1 de D8 ou ultérieure. Consultez cet article pour en savoir plus. (Ia60e0, b/345472586)

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 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 de la trace crossinline pour permettre son 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

  • Empêche les plantages lorsque des noms de sections 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 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 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 corrige une erreur Could not find androidx.tracing:tracing-ktx:1.2.0-alpha02 lors de la mise à niveau vers 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

Corrections 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

  • Il s'agit de la 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 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.

  • Mise à niveau de la version pour correspondre à la version 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

  • 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

  • androidx.tracing.perfetto.Trace renommé en androidx.tracing.perfetto.PerfettoSdkTrace (I44af8)
  • Modification du nom des constantes "code de sortie" en "code de résultat" dans le protocole pour plus de cohérence (Id1d1e)
  • Changement de nom : EnableTracingResponse devient Response. (I56275)
  • Ajout d'une option permettant d'activer le traçage du démarrage à froid en mode persistant. Ajout d'une fonction permettant d'effacer (de manière persistante ou non) le traçage du démarrage à froid. (Iaa09d)
  • Mise en cohérence des API du SDK Perfetto de traçage avec android.os.Trace. (I73ba0, b/282199917)
  • Passage à un modèle d'usine pour LibrarySource, ce qui permet d'ajouter facilement des cas d'utilisation futurs (par exemple, le chargement direct du fichier .so) à l'API si nécessaire. (I128df)
  • Faire correspondre les paramètres enableTracingColdStart à 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 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 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 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 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.

Corrections 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

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