Traçage
androidx.tracing
androidx.tracing.wire
androidx.tracing.perfetto
| Dernière mise à jour | Version stable | Version finale | Version bêta | Version alpha |
|---|---|---|---|---|
| 21 octobre 2026 | 2.0.5 | - | - | - |
Déclarer des dépendances
Pour ajouter une dépendance à Tracing, vous devez ajouter le dépôt Maven de Google à votre projet. Pour en savoir plus, consultez la section Dépôt Maven de Google.
Ajoutez les dépendances des artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou module :
Groovy
dependencies { def tracing_version = "2.0.5" // Core tracing API (for libraries and apps to emit trace events) implementation "androidx.tracing:tracing:$tracing_version" // In-process tracing backend and Perfetto sink (for apps) implementation "androidx.tracing:tracing-wire:$tracing_version" // Optional - Kotlin extensions for system tracing (only needed before 1.3.0; included in `tracing` since 1.3.0) implementation "androidx.tracing:tracing-ktx:$tracing_version" }
Kotlin
dependencies { val tracing_version = "2.0.5" // Core tracing API (for libraries and apps to emit trace events) implementation("androidx.tracing:tracing:$tracing_version") // In-process tracing backend and Perfetto sink (for apps) implementation("androidx.tracing:tracing-wire:$tracing_version") // Optional - Kotlin extensions for system tracing (only needed before 1.3.0; included in `tracing` since 1.3.0) implementation("androidx.tracing:tracing-ktx:$tracing_version") }
Pour en savoir plus sur les dépendances, consultez Ajouter des dépendances de compilation.
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.
Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.
Traçage
Version 2.0
Version 2.0.5
21 octobre 2026
Publication d'androidx.tracing:tracing-*:2.0.5. Liste des commits de la version 2.0.5
Correction de bugs
- Correction d'une condition de concurrence dans la gestion du pool, où le même thread pouvait vider et libérer des paquets simultanément, ce qui entraînait des blocages potentiels, en particulier lors de l'utilisation d'un
EmptyCoroutineContext. (Ia0aef48c, b/570135466)
Version 2.0.4
12 octobre 2026
Publication d'androidx.tracing:tracing-*:2.0.4. Liste des commits de la version 2.0.4
Correction de bugs
- Correction d'une condition de concurrence lors du vidage des paquets de trace. (aosp/4344047)
Version 2.0.3
23 septembre 2026
Publication d'androidx.tracing:tracing-*:2.0.3. Liste des commits de la version 2.0.3
Version 2.0.2
9 septembre 2026
Publication d'androidx.tracing:tracing-*:2.0.2. Liste des commits de la version 2.0.2
Version 2.0.1
26 août 2026
Publication d'androidx.tracing:tracing-*:2.0.1. Liste des commits de la version 2.0.1
Version 2.0.0
12 août 2026
Publication d'androidx.tracing:tracing-*:2.0.0. Liste des commits de la version 2.0.0
Principales fonctionnalités de la version 2.0.0 :
La nouvelle API in-process permet d'effectuer les opérations suivantes :
- Enregistrer le contenu de la trace en cours de traitement, sur le terrain
- Flux Perfetto (flèches d'une tranche à une autre)
- Annotations Perfetto (métadonnées de tranche clé/valeur)
traceCoroutine() {}: API de traçage de coroutines qui trace les changements de thread- Filtrage par catégorie
- Surcharge nettement inférieure à celle de l'API
android.os.Traceet du wrappertrace() {}existants - Traçage KMP : peut être utilisé sur les bibliothèques sans dépendance Android et sur les projets JVM hôtes.
- Fusion après coup avec l'enregistrement de trace système (implémenté par défaut dans AndroidX Benchmark 1.5)
Notez que les nouvelles API de traçage enregistrent dans un tampon contrôlé par le processus, qui n'est pas encore capturé par l'enregistrement de trace système de Studio. Ce problème sera résolu dans les profileurs Studio dans une prochaine version.
Les API android.os.Trace/trace() {} existantes n'ont pas été abandonnées. Ces API sont toujours recommandées pour les événements à faible fréquence qui doivent toujours être enregistrés dans le tampon de trace du système, en particulier dans les bibliothèques.
Version 2.0.0-rc01
29 juillet 2026
Publication d'androidx.tracing:tracing-*:2.0.0-rc01. Liste des commits de la version 2.0.0-rc01.
Version 2.0.0-beta01
15 juillet 2026
Publication d'androidx.tracing:tracing-*:2.0.0-beta01. Liste des commits de la version 2.0.0-beta01
Modifications apportées à l'API
PerfettoCaptureetPerfettoTraceRulepeuvent désormais capturer des traces en cours de traitement et les fusionner pour un package cible. (I9a00b, b/497959820)androidx.benchmarka désormais une valeurminSdkde 24. (Ic2a85)
Correction de bugs
- Publication de Tracing 2.0-beta01. (I1b162)
- Utilisez des identifiants de thread spécifiques à la plate-forme lors de la génération des informations de suivi. (I6ba64)
Version 2.0.0-alpha09
23 juin 2026
Publication d'androidx.tracing:tracing-*:2.0.0-alpha09. Liste des commits de la version 2.0.0-alpha09
Modifications apportées à l'API
- Modification mineure de l'API dans
Tracerpour lever l'ambiguïté entreinstant(...)etwriteInstant(...). (I0935a) - Ajout de la prise en charge des jetons de propagation dans les événements instantanés. (I99f81)
- Autorisation de l'utilisation complète des flux Perfetto dans l'API expérimentale de propagation manuelle du contexte. (I20cb6)
- Différez la création de
BufferedSinket deProtoWriterdansTraceSink. (Ibd098) - Simplifiez la découverte de
Traceret rendez-la pluggable pour les bibliothèques Java et Android. (I99111) - Permettre aux développeurs de bibliothèques de découvrir facilement une instance de
TraceDriverpouvant être utilisée pour le traçage en cours. (Ia503e)
Version 2.0.0-alpha08
19 mai 2026
Publication d'androidx.tracing:tracing-*:2.0.0-alpha08. La version 2.0.0-alpha08 contient ces commits.
Modifications apportées à l'API
- Ajout de la possibilité de découvrir et de remplacer les instances de
TraceDriverà utiliser à l'échelle du processus. (I3f715) Tracer.recordExceptiona été renomméTracer.recordExceptionAndThrow. (I4411f, b/503092450)
Version 2.0.0-alpha07
6 mai 2026
Publication d'androidx.tracing:tracing-*:2.0.0-alpha07. La version 2.0.0-alpha07 contient ces commits.
Modifications apportées à l'API
- Ajout d'une API pour obtenir un traceur de bouchon pouvant être utilisé lorsque le traçage est désactivé. (I84c98)
- Le cycle de vie du traçage est désormais cohérent avec le traçage système. (Ib391b)
- Les API de compteur sont désormais entièrement sans allocation. (I5e73a)
Correction de bugs
- Correction d'une règle de conservation pour le SDK Perfetto (
tracing-perfetto) qui garantit que le SDK Perfetto peut être activé. (I1d227) - Ajout de la possibilité de tracer les événements
flush(). (I38014, b/495852704)
Version 2.0.0-alpha06
22 avril 2026
Publication d'androidx.tracing:tracing-*:2.0.0-alpha06. Liste des commits de la version 2.0.0-alpha06
Modifications apportées à l'API
- Supprimez les restrictions sur
File.createPerfettoFile()pour que d'autres utilisateurs puissent créer des récepteurs en toute sécurité. Lorsqu'unblock()génère une exception danstrace/traceCoroutine, créez un événementinstantpour l'exception avec les métadonnées représentant les éléments de trace de la pile correspondants. (I682e5, b/501536851, b/437166283) - Ajoutez une surcharge
setCounter(...)qui accepte un type JavaLong. (Ic0469, b/356082604) - Tracing 2.0 utilise désormais
Longpour les identifiantsThreadspécifiques à la plate-forme. (I67277)
Correction de bugs
- Amélioration de la documentation pour
AttributeEntry.reset(). (I5d3a1, b/496079439)
Version 2.0.0-alpha05
8 avril 2026
Publication d'androidx.tracing:tracing-*:2.0.0-alpha05. La version 2.0.0-alpha05 contient ces commits.
Modifications apportées à l'API
- Les fonctions d'usine
TraceSinkrenvoient désormaisTraceSinket nonAbstractTraceSink. Les fichiers ont désormais un suffixe unique. Nous nous assurons de pouvoir créer de manière atomique un nouveau fichier qui sera utilisé pour stocker les paquets de trace. (I4c4aa, b/496298726) - Simplification et accélération de la propagation du contexte de coroutine. (Ia62db)
- Introduction du paramètre facultatif
attributes()lors de la création d'unTraceDriver, qui permet d'ajouter des métadonnées relatives à une trace. (Ia147e)
Correction de bugs
- Les threads de processus et les pistes de compteur sont désormais synchronisés. Cela corrige les exceptions de la forme :
java.lang.NullPointerException: Cannot invoke "androidx.tracing.ThreadTrack.flush$tracing()" because "threadTrack" is null - Évitez d'émettre des événements de récepteur lorsque le traçage est désactivé.
Version 2.0.0-alpha04
25 mars 2026
Publication d'androidx.tracing:tracing-*:2.0.0-alpha04. Liste des commits de la version 2.0.0-alpha04
Modifications apportées à l'API
- Rendez
AbstractTraceDrivervraiment abstrait et déplacez l'implémentation dePerfettovers le moduletracing-wire. (Ie2f59) - Donnez des noms plus descriptifs aux implémentations de base pour éviter d'utiliser la mauvaise. Les développeurs qui étendaient auparavant
androidx.tracing.Trace{Sink|Driver}devront désormais utiliserAbstractTrace{Sink|Driver}. (I9b46d)
Version 2.0.0-alpha03
11 mars 2026
Publication d'androidx.tracing:tracing-*:2.0.0-alpha03. La version 2.0.0-alpha03 contient ces commits.
Modifications apportées à l'API
- Ajout d'une implémentation
InMemoryRingBufferTraceSinkexpérimentale qui permet de définir une restriction de capacité et d'éviter l'écriture sur le disque, sauf demande explicite. (I1dc44, b/484409653, I65a37, b/484409653) - Correction de la condition de concurrence lors de l'émission d'événements de trace pour les suspensions et les reprises de coroutines. (Ie145e)
Correction de bugs
- Par défaut,
androidx.tracingne tente plus d'établir de connexions entre les coroutines parentes et enfants dans les traces. Cela a pu prêter à confusion, car le format de trace sous-jacent n'est pas compatible avec les connexions1:NetN:1, ce qui entraîne un enchevêtrement de flèches en raison de l'ambiguïté concernant la tranche de coroutine qui se connecte à quoi. Vous pouvez toujours activer manuellement la propagation avec l'APItokenForManualPropagation()lorsque cela est important pour votre cas d'utilisation. (Ib2cf9)
Version 2.0.0-alpha02
25 février 2026
Publication d'androidx.tracing:tracing-*:2.0.0-alpha02. Liste des commits de la version 2.0.0-alpha02
Nouvelles fonctionnalités
- Amélioration des performances de l'implémentation de Perfetto Trace Sink à l'aide de l'intrinsèque
suspendCoroutineUninterceptedOrReturn(2ea97b).
Version 2.0.0-alpha01
28 janvier 2026
Publication d'androidx.tracing:tracing-*:2.0.0-alpha01. Liste des commits de la version 2.0.0-alpha01
Nouvelles fonctionnalités
AndroidX Tracing 2.0 introduit une nouvelle surface d'API importante pour le traçage en cours à faible surcharge, en complément des API existantes basées sur android.os.Tracing dans Tracing 1.0. Les nouvelles API sont disponibles à la fois sur Android et sur la JVM hôte, ce qui permet aux outils hôtes d'émettre des traces à faible coût pour l'analyse des performances, en utilisant le même format de trace Perfetto standard.
Les traces émises sont compatibles avec Android Studio et Perfetto, et peuvent être enregistrées avec un ensemble de fonctionnalités étendu, y compris l'ajout de tags aux segments avec des métadonnées (comme les arguments de fonction !) et la propagation des traces de contexte de coroutine.
Cette version alpha initiale est uniquement destinée aux workflows de traçage en cours de traitement et ne s'intègre pas encore au traçage de l'OS Android ni au traçage système du profileur Studio. Ces fonctionnalités seront disponibles dans une prochaine version alpha.
/**
* A [TraceSink] defines how traces are serialized.
*
* [androidx.tracing.wire.TraceSink] uses the `Perfetto` trace packet format.
*/
fun createSink(): TraceSink {
val outputDirectory = File(/* pathname = */ "/tmp/perfetto")
// We are using the factory function defined in androidx.tracing.wire
return TraceSink(
sequenceId = 1,
directory = outputDirectory
)
}
/**
* Creates a new instance of [androidx.tracing.TraceDriver].
*/
fun createTraceDriver(): TraceDriver {
// We are using a factory function from androidx.tracing.wire here.
// `isEnabled` controls whether tracing is enabled for the application.
val driver = TraceDriver(sink = createSink(), isEnabled = true)
return driver
}
fun main() {
val driver = createTraceDriver()
driver.use {
driver.tracer.trace(category = CATEGORY_MAIN, name = "basic") {
Thread.sleep(100L)
}
}
}
Modifications apportées à l'API
- Faites de
Tracerune propriété deTraceDriver. (Iabd9b) - Ajout de la prise en charge de la propagation manuelle du contexte. (I899ff)
- Ajout de la possibilité d'ajouter des informations sur la pile d'appel dans une section de trace. (If6a1b)
- Présentation des nouvelles API
androidx.tracing. (I5102b) - Autorisez les événements instantanés à contenir des métadonnées, et ajoutez des compteurs aux instants et aux compteurs. (Ia2ed3)
- Réduction de la surface de l'API annotée avec
@DelicateTracingApi. Rien dans l'API de niveau supérieur ne doit nécessiter l'utilisation de@DelicateTracingApi. (I565e0) - Simplifiez la propagation du contexte en unifiant les
PropagationToken. (Iab839) - Stabilisation des API
BlackHoledansandroidx.benchmark. (I2b67e, b/451749438) - Ajout de la possibilité d'annoter la section de trace en tant que segment racine. (Ic8365)
- Permettre au développeur d'être explicite sur les jetons de propagation. (I06bb1)
MetadataHandleCloseablea été renomméEventMetadataCloseable, etMetadataHandleEventMetadata. Ajout d'un argumentCoroutinePropagationTokenfacultatif àTracer.traceCoroutinepour permettre au développeur de spécifier explicitement le jeton de propagation à utiliser. (I219f7, b/454147392)- Introduction d'un nouveau point d'entrée
Tracerqui permet aux développeurs de mieux contrôler le traçage. (I24a7b) - Ajout de la possibilité de contrôler la propagation du contexte dans un
SliceTrack. (Ieb8fc) fillCountdansPooledTracePacketArrayest désormais correctement marqué comme volatile. (I75d2c)- Marquer
MetadataEntry@DelicateTracingApi. (I8c723) - Ajout de la possibilité pour un
TraceSinkde gérer les événements de trace perdus (lorsque le pool est épuisé). (I3b374) - Ajout de la possibilité d'émettre des événements de trace de manière conditionnelle en fonction d'un prédicat. (I621b4)
- Ajout de la possibilité d'ajouter des catégories à un événement de trace. (I449c2)
- Marquer
TraceEvent,PooledTracePacketArraycommeDelicateTracingApi. (Iaac6d) - Rendre
ProcessTrack.id,ThreadTrack.id,ThreadTrack.name,CounterTrack.nameetCounterTrack.parentpublics. (I81210) - L'API
SliceTrack.traceFlow()a été renomméetraceCoroutine(). (I79ad0) - Ajout de la possibilité d'ajouter des informations contextuelles aux segments via des annotations de débogage dans une trace Perfetto. (Ic2b56)
- Permettre de construire une instance de
WireTraceSinkavec unFile/OutputStream. (Iecea0) - Suppression des annotations
@RequiresApi(21)obsolètes (Ic4792)
Version 1.3
Version 1.3.0
23 avril 2025
Publication d'androidx.tracing:tracing:1.3.0, androidx.tracing:tracing-android:1.3.0 et androidx.tracing:tracing-ktx:1.3.0. Liste des commits de la version 1.3.0
Changements importants depuis la version 1.2.0
- Conversion de la classe
androidx.tracing.Traceen Kotlin et déplacement de tout le code du moduletracing-ktxverstracing. - Suppression de crossinline de trace pour permettre l'utilisation dans un
@Composable. (I53882, b/248344805)
Version 1.3.0-rc01
9 avril 2025
Publication d'androidx.tracing:tracing:1.3.0-rc01, androidx.tracing:tracing-android:1.3.0-rc01 et androidx.tracing:tracing-ktx:1.3.0-rc01 sans modification par rapport à la dernière version bêta. Liste des commits de la version 1.3.0-rc01
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-ktxverstracing. (Iba550) - Conversion de la classe
androidx.tracing.Traceen 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 lors de l'utilisation de R8 avec AGP 7.3 ou version ultérieure (par exemple, R8 version 3.3) et pour tous les builds lors de l'utilisation d'AGP 8.1 ou version ultérieure (par exemple, D8 version 8.1). Nous conseillons aux clients qui n'utilisent pas AGP de passer à la version 8.1 ou ultérieure de D8. 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 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 de crossinline de 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()ettraceAsync()avec calcul différé des chaînes et des cookies. De plus,Trace.endest désormais correctement ignoré siTrace.beginest 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 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 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-alpha02lors de la mise à niveau versandroidx.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()ettraceAsync()avec calcul différé des chaînes et des cookies. De plus,Trace.endest désormais correctement ignoré siTrace.beginest généré. (I31421, b/175233952, b/247066503)
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)
Version 1.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.
Tracing Perfetto
Version 1.0
Version 1.0.1
19 novembre 2025
Publication d'androidx.tracing:tracing-perfetto:1.0.1, androidx.tracing:tracing-perfetto-binary:1.0.1 et androidx.tracing:tracing-perfetto-handshake:1.0.1. Liste des commits de la version 1.0.1
Correction de bugs
- Compatibilité avec les tailles de page de 16 ko (b7a7dd)
- 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 lors de l'utilisation de R8 avec AGP 7.3 ou version ultérieure (par exemple, R8 version 3.3) et pour tous les builds lors de l'utilisation d'AGP 8.1 ou version ultérieure (par exemple, D8 version 8.1). Nous conseillons aux clients qui n'utilisent pas AGP de passer à la version 8.1 ou ultérieure de D8. Consultez cet article pour en savoir plus. (Ia60e0, b/345472586)
- Évitez de regrouper des copies de
FastNative/CriticalNativedans la bibliothèque et utilisez les copies de la plate-forme stable. (I8238a, b/35664282, b/280878596)
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, androidx.tracing:tracing-perfetto-binary:1.0.0-rc01 et 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.
- Correctif de version correspondant à 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
- Ajout de la compatibilité avec le 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.Tracedevientandroidx.tracing.perfetto.PerfettoSdkTrace. (I44af8) - Changement de nom : les constantes "exit code" deviennent "result code" dans le protocole pour plus de cohérence (Id1d1e).
- Changement de nom :
EnableTracingResponsedevientResponse. (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 le traçage du démarrage à froid (persistant ou non). (Iaa09d)
- Les API du SDK Tracing Perfetto ont été rendues cohérentes avec
android.os.Trace. (I73ba0, b/282199917) - Passage à un modèle de fabrique pour
LibrarySource, ce qui permet d'ajouter facilement à l'API de futurs cas d'utilisation (par exemple, le chargement direct du fichier.so) si nécessaire. (I128df) - Faire correspondre les paramètres
enableTracingColdStartàenableTracingImmediate(I54126) - Suppression de l'argument
killProcessdansenableTracingColdStart(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 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 version précédente. 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, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha12 et 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-alpha09de 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
PerfettoNativesi 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.requiredVersionpeut 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-perfettoest 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-binaryest un ensemble de dépendances binaires requises pour androidx.tracing:tracing-perfetto.androidx.tracing:tracing-perfetto-commonest 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.