מבצע מעקב
| העדכון האחרון | גרסה יציבה | גרסה מועמדת להפצה | גרסת בטא | גרסת אלפא |
|---|---|---|---|---|
| 21 באוקטובר 2026 | 2.0.5 | - | - | - |
הצהרה על יחסי תלות
כדי להוסיף תלות ב-Tracing, צריך להוסיף לפרויקט את מאגר Google Maven. מידע נוסף זמין במאמר מאגר ה-Maven של Google.
אתם יכולים להוסיף את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:
מגניב
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") }
מידע נוסף זמין במאמר הוספת יחסי תלות ב-build.
משוב
המשוב שלכם עוזר לנו לשפר את Jetpack. נשמח לדעת אם גיליתם בעיות חדשות או אם יש לכם רעיונות איך לשפר את הספרייה הזו. כדאי לעיין בבעיות הידועות בספרייה הזו לפני שמדווחים על בעיה. כדי להוסיף הצבעה בדיווח על בעיה קיימת, לוחצים על כפתור הכוכב.
מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.
מבצע מעקב
גרסה 2.0
גרסה 2.0.5
21 באוקטובר 2026
androidx.tracing:tracing-*:2.0.5 מופץ. גרסה 2.0.5 מכילה את השמירות האלה.
תיקוני באגים
- תוקן מרוץ תהליכים בניהול המאגר, שבו אותו שרשור יכול היה לרוקן ולשחרר חבילות בו-זמנית, מה שגרם למבוי סתום פוטנציאלי, במיוחד כשמשתמשים ב-
EmptyCoroutineContext. (Ia0aef48c, b/570135466)
גרסה 2.0.4
12 באוקטובר 2026
androidx.tracing:tracing-*:2.0.4 מופץ. גרסה 2.0.4 מכילה את השמירות האלה.
תיקוני באגים
- תוקן מרוץ תהליכים שקרה כשמנקים חבילות מעקב. (aosp/4344047)
גרסה 2.0.3
23 בספטמבר 2026
androidx.tracing:tracing-*:2.0.3 מופץ. גרסה 2.0.3 מכילה את השמירות האלה.
גרסה 2.0.2
9 בספטמבר 2026
androidx.tracing:tracing-*:2.0.2 מופץ. גרסה 2.0.2 מכילה את ה-commits האלה.
גרסה 2.0.1
26 באוגוסט 2026
androidx.tracing:tracing-*:2.0.1 מופץ. גרסה 2.0.1 מכילה את ה-commits האלה.
גרסה 2.0.0
12 באוגוסט 2026
androidx.tracing:tracing-*:2.0.0 מופץ. גרסה 2.0.0 מכילה את השמירות האלה.
התכונות העיקריות בגרסה 2.0.0:
ממשק API חדש בתהליך מאפשר:
- תיעוד תוכן של מעקב בתהליך, בשטח
- תהליכים ב-Perfetto (חצים מפרוסה אחת לאחרת)
- הערות Perfetto (מטא-נתונים של פרוסות מפתח/ערך)
-
traceCoroutine() {}– Coroutine Tracing API שעוקב אחרי החלפות שרשורים - Category filtering
- תקורה נמוכה משמעותית בהשוואה ל-API הקיים של
android.os.Traceולמעטפת שלtrace() {} - מעקב KMP – אפשר להשתמש בו בספריות ללא תלות ב-Android, ובפרויקטים של JVM מארח
- מיזוג עם הקלטה של עקבות המערכת אחרי ההקלטה (מוטמע כברירת מחדל ב-AndroidX Benchmark 1.5)
חשוב לדעת: ממשקי ה-API החדשים למעקב מתעדים למאגר נתונים זמני (buffer) שנשלט על ידי תהליך, שעדיין לא מתועד על ידי הקלטת עקבות המערכת ב-Studio. הבעיה הזו תטופל ב-Studio Profilers באחת מהגרסאות הבאות.
ממשקי ה-API הקיימים של android.os.Trace / trace() {} לא הוצאו משימוש. עדיין מומלץ להשתמש בממשקי ה-API האלה לאירועים בתדירות נמוכה שתמיד צריך לתעד במאגר של עקבות המערכת, במיוחד בספריות.
גרסה 2.0.0-rc01
29 ביולי 2026
androidx.tracing:tracing-*:2.0.0-rc01 מופץ. גרסה 2.0.0-rc01 מכילה את השמירות האלה.
גרסה 2.0.0-beta01
15 ביולי 2026
androidx.tracing:tracing-*:2.0.0-beta01 מופץ. גרסה 2.0.0-beta01 מכילה את השמירות האלה.
שינויים ב-API
- עכשיו אפשר להשתמש ב-
PerfettoCaptureוב-PerfettoTraceRuleכדי לתעד מעקבים בתהליך ולמזג אותם לחבילת יעד. (I9a00b, b/497959820) - עכשיו ל-
androidx.benchmarkישminSdkשל 24. (Ic2a85)
תיקוני באגים
- גרסת Tracing 2.0-beta01. (I1b162)
- כשיוצרים מידע על טראק, צריך להשתמש במזהי שרשורים ספציפיים לפלטפורמה. (I6ba64)
גרסה 2.0.0-alpha09
23 ביוני 2026
androidx.tracing:tracing-*:2.0.0-alpha09 מופץ. גרסה 2.0.0-alpha09 מכילה את השמירות האלה.
שינויים ב-API
- שינוי קל ב-API של
Tracerכדי להבחין ביןinstant(...)ל-writeInstant(...). (I0935a) - הוספת תמיכה בטוקנים של הפצה באירועים מיידיים. (I99f81)
- אפשר להשתמש באופן מלא בתהליכים של Perfetto ב-API הניסיוני להפצת הקשר באופן ידני. (I20cb6)
- דחיית היצירה של
BufferedSinkו-ProtoWriterב-TraceSink. (Ibd098) - הפיכת הגילוי של
Tracerלפשוט וניתן לחיבור גם לספריות Java וגם לספריות Android. (I99111) - כדי שמפתחי ספריות יוכלו למצוא בקלות מופע של
TraceDriverשאפשר להשתמש בו למעקב בתוך התהליך. (Ia503e)
גרסה 2.0.0-alpha08
19 במאי 2026
androidx.tracing:tracing-*:2.0.0-alpha08 מופץ. גרסה 2.0.0-alpha08 מכילה את השמירות האלה.
שינויים ב-API
- הוספת היכולת לגלות מופעים של
TraceDriverולבטל אותם, כדי להשתמש בהם בכל התהליך. (I3f715) - משנים את השם של
Tracer.recordExceptionלשםTracer.recordExceptionAndThrow. (I4411f, b/503092450)
גרסה 2.0.0-alpha07
6 במאי 2026
androidx.tracing:tracing-*:2.0.0-alpha07 מופץ. גרסה 2.0.0-alpha07 מכילה את השמירות האלה.
שינויים ב-API
- הוספת API כדי לקבל מעקב חלקי שאפשר להשתמש בו כשהמעקב מושבת. (I84c98)
- התאמה של מחזור החיים של המעקב למעקב המערכת. (Ib391b)
- ממשקי ה-API של המונים לא דורשים יותר הקצאה. (I5e73a)
תיקוני באגים
- תוקן כלל שמירה של Perfetto SDK (
tracing-perfetto) שמוודא שאפשר להפעיל את Perfetto SDK. (I1d227) - הוספת היכולת לעקוב אחרי אירועי
flush(). (I38014, b/495852704)
גרסה 2.0.0-alpha06
22 באפריל 2026
androidx.tracing:tracing-*:2.0.0-alpha06 מופץ. גרסה 2.0.0-alpha06 מכילה את השמירות האלה.
שינויים ב-API
- צריך לבטל את ההגבלה על
File.createPerfettoFile()כדי שאחרים יוכלו ליצור כיורים בבטחה. כש-block()זורק חריגה ב-trace/traceCoroutine, צריך ליצור אירועinstantלחריגה עם המטא-נתונים שמייצגים את רכיבי דוח הקריסות התואמים. (I682e5, b/501536851, b/437166283) - מוסיפים עומס יתר של
setCounter(...)שמקבל סוגLongשל Java. (Ic0469, b/356082604) - ב-Tracing 2.0 נעשה עכשיו שימוש ב-
LongלמזהיThreadספציפיים לפלטפורמה. (I67277)
תיקוני באגים
- שיפור המסמכים של
AttributeEntry.reset(). (I5d3a1, b/496079439)
גרסה 2.0.0-alpha05
8 באפריל 2026
androidx.tracing:tracing-*:2.0.0-alpha05 מופץ. גרסה 2.0.0-alpha05 מכילה את השמירות האלה.
שינויים ב-API
- פונקציות המפעל של
TraceSinkמחזירות עכשיו אתTraceSinkולא אתAbstractTraceSink. עכשיו לקבצים יש סיומת ייחודית. אנחנו מוודאים שאנחנו יכולים ליצור באופן אטומי קובץ חדש שישמש לאחסון חבילות מעקב. (I4c4aa, b/496298726) - לפשט ולהאיץ את ההפצה של הקשר ה-coroutine. (Ia62db)
- הוספת השדה האופציונלי
attributes()כשיוצריםTraceDriver, שמאפשר להוסיף מטא-נתונים שקשורים למעקב. (Ia147e)
תיקוני באגים
- התהליכים והמונים מסונכרנים עכשיו. הפעולה הזו מתקנת חריגות מהסוג:
java.lang.NullPointerException: Cannot invoke "androidx.tracing.ThreadTrack.flush$tracing()" because "threadTrack" is null - לא לשלוח אירועי sink כשהמעקב מושבת.
גרסה 2.0.0-alpha04
25 במרץ 2026
androidx.tracing:tracing-*:2.0.0-alpha04 מופץ. גרסה 2.0.0-alpha04 מכילה את השמירות האלה.
שינויים ב-API
- הופכים את
AbstractTraceDriverלמופשטת באמת, ומעבירים את ההטמעה שלPerfettoלמודולtracing-wire. (Ie2f59) - כדי להימנע משימוש בהטמעה הבסיסית הלא נכונה, כדאי לתת להטמעות הבסיסיות שמות תיאוריים יותר. מפתחים שהרחיבו בעבר את
androidx.tracing.Trace{Sink|Driver}יצטרכו עכשיו לעבור לשימוש ב-AbstractTrace{Sink|Driver}. (I9b46d)
גרסה 2.0.0-alpha03
11 במרץ 2026
androidx.tracing:tracing-*:2.0.0-alpha03 מופץ. גרסה 2.0.0-alpha03 מכילה את השמירות האלה.
שינויים ב-API
- הוספנו הטמעה ניסיונית של
InMemoryRingBufferTraceSinkשמאפשרת להגדיר מגבלת קיבולת ומונעת כתיבה בדיסק, אלא אם מבקשים זאת במפורש. (I1dc44, b/484409653, I65a37, b/484409653) - תיקון של מרוץ תהליכים כשפולטים אירועי נתוני מעקב להשעיה ולחידוש של שגרת המשך (coroutine). (Ie145e)
תיקוני באגים
- כברירת מחדל,
androidx.tracingלא מנסה יותר ליצור קשרים בין פונקציות קורוטין הורה וצאצא במעקבים. זה היה מבלבל, כי פורמט המעקב הבסיסי לא תומך בחיבורים של1:Nו-N:1, וכתוצאה מכך נוצר קן של חצים בגלל חוסר בהירות לגבי איזה פרוסת קורוטינה מתחברת למה. עדיין אפשר להצטרף באופן ידני להפצה באמצעות ה-API שלtokenForManualPropagation()אם זה חשוב לתרחיש לדוגמה שלכם. (Ib2cf9)
גרסה 2.0.0-alpha02
25 בפברואר 2026
androidx.tracing:tracing-*:2.0.0-alpha02 מופץ. גרסה 2.0.0-alpha02 מכילה את השמירות האלה.
תכונות חדשות
- שיפור הביצועים של הטמעת Perfetto Trace Sink באמצעות
suspendCoroutineUninterceptedOrReturnפנימי (2ea97b).
גרסה 2.0.0-alpha01
28 בינואר 2026
androidx.tracing:tracing-*:2.0.0-alpha01 מופץ. גרסה 2.0.0-alpha01 מכילה את השמירות האלה.
תכונות חדשות
ב-AndroidX Tracing 2.0 יש ממשק API חדש ומשמעותי למעקב בתוך התהליך עם תקורה נמוכה, כהשלמה לממשקי ה-API הקיימים שמבוססים על android.os.Tracing ב-Tracing 1.0. ממשקי ה-API החדשים זמינים גם ב-Android וגם במארח JVM, מה שמאפשר לכלי המארח להפיק מעקבים עם תקורה נמוכה לניתוח ביצועים, באמצעות אותו פורמט מעקב רגיל של Perfetto.
גם Android Studio וגם Perfetto תומכים בנתוני מעקב שנוצרו, ואפשר לתעד אותם באמצעות קבוצת תכונות מורחבת, כולל תיוג של פרוסות עם מטא-נתונים (כמו ארגומנטים של פונקציות!) והפצה של נתוני מעקב הקשר של שגרת המשך (coroutine).
גרסת האלפא הראשונית הזו מיועדת רק לתהליכי עבודה של מעקב תוך כדי תהליך, ועדיין לא משתלבת עם מעקב אחר מערכת ההפעלה של Android או עם מעקב אחר מערכת Studio Profiler – אלה יגיעו בגרסת אלפא עתידית.
/**
* 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)
}
}
}
שינויים ב-API
- הופכים את
Tracerלמאפיין שלTraceDriver. (Iabd9b) - הוספת תמיכה בהפצה ידנית של הקשר. (I899ff)
- הוספת האפשרות להוסיף מידע על סטאק הביצוע בקטע מעקב. (If6a1b)
- הצגת ממשקי ה-API החדשים של
androidx.tracing. (I5102b) - מאפשרים לאירועים מיידיים להכיל מטא-נתונים, ומוסיפים מונים לאירועים מיידיים ולמונים. (Ia2ed3)
- צמצום שטח הפנים של ה-API שמסומן ב-
@DelicateTracingApi. שום דבר ב-API ברמה העליונה לא אמור לדרוש שימוש ב-@DelicateTracingApi. (I565e0) - פישוט של הפצת ההקשר על ידי איחוד של
PropagationToken. (Iab839) -
BlackHoleממשקי API יציבים ב-androidx.benchmark. (I2b67e, b/451749438) - הוספת היכולת להוסיף הערות לקטע המעקב כיחידה לוגית בסיסית למעקב. (Ic8365)
- המפתח יכול להגדיר במפורש אסימוני הפצה. (I06bb1)
- השם של
MetadataHandleCloseableהשתנה ל-EventMetadataCloseable, והשם שלMetadataHandleהשתנה ל-EventMetadata. הוספנו גם ארגומנטCoroutinePropagationTokenאופציונלי ל-Tracer.traceCoroutineכדי לאפשר למפתח לציין באופן מפורש את אסימון ההפצה שבו יש להשתמש. (I219f7, b/454147392) - הוספנו נקודת כניסה חדשה של
Tracerשנותנת למפתחים הרבה יותר שליטה על אופן המעקב. (I24a7b) - הוספת היכולת לשלוט באופן שבו מתבצעת הפצת ההקשר ב-
SliceTrack. (Ieb8fc) - הפונקציה
fillCountב-PooledTracePacketArrayמסומנת עכשיו כהלכה כפונקציה תנודתית. (I75d2c) - סימון
MetadataEntry@DelicateTracingApi. (I8c723) - הוספת היכולת של
TraceSinkלטפל באירועי מעקב שאבדו (כשהמאגר מוצה). (I3b374) - הוספת היכולת להפיק אירועי מעקב באופן מותנה על סמך פרדיקט. (I621b4)
- הוספת האפשרות להוסיף קטגוריות לאירוע מעקב. (I449c2)
- סימון ההשתתפות של
TraceEvent(PooledTracePacketArray) כDelicateTracingApi. (Iaac6d) - הגדרת
ProcessTrack.id,ThreadTrack.id,ThreadTrack.name,CounterTrack.nameו-CounterTrack.parentכגלויים לכולם. (I81210) - שינינו את השם של ה-API
SliceTrack.traceFlow()ל-traceCoroutine(). (I79ad0) - הוספת היכולת להוסיף מידע לפי הקשר לפרוסות באמצעות הערות לניפוי באגים במעקב של Perfetto. (Ic2b56)
- מאפשרים ליצור מופע של
WireTraceSinkעםFileאוOutputStream. (Iecea0) - הסרת הערות
@RequiresApi(21)מיושנות (Ic4792)
גרסה 1.3
גרסה 1.3.0
23 באפריל 2025
הגרסאות androidx.tracing:tracing:1.3.0, androidx.tracing:tracing-android:1.3.0 ו-androidx.tracing:tracing-ktx:1.3.0 פורסמו. גרסה 1.3.0 מכילה את השמירות האלה.
שינויים חשובים מאז גרסה 1.2.0
- המרנו את המחלקה
androidx.tracing.Traceל-Kotlin, והעברנו את כל הקוד מהמודולtracing-ktxאלtracing. - צריך להסיר את crossinline מ-trace כדי לאפשר שימוש ב-
@Composable. (I53882, b/248344805)
גרסה 1.3.0-rc01
9 באפריל 2025
הגרסאות של androidx.tracing:tracing:1.3.0-rc01, androidx.tracing:tracing-android:1.3.0-rc01 ו-androidx.tracing:tracing-ktx:1.3.0-rc01 הושקו ללא שינויים מאז גרסת הבטא האחרונה. גרסה 1.3.0-rc01 מכילה את השמירות האלה.
גרסה 1.3.0-beta01
12 בפברואר 2025
הגרסאות androidx.tracing:tracing:1.3.0-beta01, androidx.tracing:tracing-android:1.3.0-beta01 ו-androidx.tracing:tracing-ktx:1.3.0-beta01 פורסמו. גרסה 1.3.0-beta01 מכילה את ה-commits האלה.
שינויים ב-API
- העברנו את כל הקוד מהמודול
tracing-ktxאלtracing. (Iba550) - המחלקה
androidx.tracing.Traceהומרה ל-Kotlin. (Ie4e5d)
תיקוני באגים
- הוסר המתווה הידני של הגישה לממשקי API חדשים של הפלטפורמה, כי זה קורה באופן אוטומטי באמצעות בניית מודלים של API כשמשתמשים ב-R8 עם AGP 7.3 ואילך (למשל, גרסה 3.3 של R8) ובכל ה-builds כשמשתמשים ב-AGP 8.1 ואילך (למשל, גרסה 8.1 של D8). ללקוחות שלא משתמשים ב-AGP, מומלץ לעדכן לגרסה 8.1 ומעלה של D8. למידע נוסף, מומלץ לעיין במאמר הזה. (Ia60e0, b/345472586)
גרסה 1.3.0-alpha02
21 ביוני 2023
הגרסאות androidx.tracing:tracing:1.3.0-alpha02 ו-androidx.tracing:tracing-ktx:1.3.0-alpha02 פורסמו ללא שינויים מגרסת האלפא הקודמת. גרסה 1.3.0-alpha02 מכילה את השמירות האלה.
גרסה 1.3.0-alpha01
7 ביוני 2023
androidx.tracing:tracing:1.3.0-alpha01 ו-androidx.tracing:tracing-ktx:1.3.0-alpha01 מופצים. גרסה 1.3.0-alpha01 מכילה את השינויים האלה.
שינויים ב-API
- צריך להסיר את crossinline מ-trace כדי לאפשר שימוש ב-
@Composable. (I53882, b/248344805)
גרסה 1.2
גרסה 1.2.0
29 בנובמבר 2023
androidx.tracing:tracing:1.2.0 ו-androidx.tracing:tracing-ktx:1.2.0 מופצים. גרסה 1.2.0 מכילה את השינויים האלה.
שינויים חשובים מאז גרסה 1.1.0
- הוספת גרסאות של
trace()ו-traceAsync()עם חישוב מחרוזת וקובצי Cookie מושהה. בנוסף, עכשיו המערכת מדלגת בצורה נכונה עלTrace.endאםTrace.beginזורק.
גרסה 1.2.0-rc01
24 במאי 2023
androidx.tracing:tracing:1.2.0-rc01 ו-androidx.tracing:tracing-ktx:1.2.0-rc01 מופצים. גרסה 1.2.0-rc01 מכילה את השינויים האלה.
תיקוני באגים
- מניעת קריסות כשמועברים שמות ארוכים של קטעי מעקב, על ידי חיתוך אוטומטי (Iaf6e2)
גרסה 1.2.0-beta04
3 במאי 2023
הגרסאות androidx.tracing:tracing:1.2.0-beta04 ו-androidx.tracing:tracing-ktx:1.2.0-beta04 פורסמו ללא שינויים. גרסה 1.2.0-beta04 מכילה את השינויים האלה.
גרסה 1.2.0-beta03
5 באפריל 2023
הגרסאות androidx.tracing:tracing:1.2.0-beta03 ו-androidx.tracing:tracing-ktx:1.2.0-beta03 פורסמו בלי שינויים חדשים. גרסה 1.2.0-beta03 מכילה את השינויים האלה.
גרסה 1.2.0-beta02
22 במרץ 2023
הגרסאות androidx.tracing:tracing:1.2.0-beta02 ו-androidx.tracing:tracing-ktx:1.2.0-beta02 הושקו ללא שינויים מאז גרסת הבטא הקודמת. גרסה 1.2.0-beta02 מכילה את השינויים האלה.
גרסה 1.2.0-beta01
8 במרץ 2023
הגרסאות androidx.tracing:tracing:1.2.0-beta01 ו-androidx.tracing:tracing-ktx:1.2.0-beta01 פורסמו ללא שינויים מאז גרסת האלפא האחרונה. גרסה 1.2.0-beta01 מכילה את השינויים האלה.
גרסה 1.2.0-alpha02
23 בפברואר 2023
הגרסאות androidx.tracing:tracing:1.2.0-alpha02 ו-androidx.tracing:tracing-ktx:1.2.0-alpha02 הושקו ללא שינויים מגרסת האלפא הקודמת. גרסה 1.2.0-alpha02 מכילה את השינויים האלה.
תיקוני באגים
- הגרסה הזו תתקן שגיאה מסוג
Could not find androidx.tracing:tracing-ktx:1.2.0-alpha02כשמשדרגים ל-androidx.tracing: tracing-perfetto-common:1.0.0-alpha11
גרסה 1.2.0-alpha01
5 באוקטובר 2022
androidx.tracing:tracing:1.2.0-alpha01 ו-androidx.tracing:tracing-ktx:1.2.0-alpha01 מופצים. גרסה 1.2.0-alpha01 מכילה את השינויים האלה.
תכונות חדשות
- הוספת גרסאות של
trace()ו-traceAsync()עם חישוב מחרוזת וקובצי Cookie מושהה. בנוסף, עכשיו המערכת מדלגת בצורה נכונה עלTrace.endאםTrace.beginזורק. (I31421, b/175233952, b/247066503)
גרסה 1.1
גרסה 1.1.0
11 במאי 2022
androidx.tracing:tracing:1.1.0 ו-androidx.tracing:tracing-ktx:1.1.0 מופצים. גרסה 1.1.0 מכילה את השינויים האלה.
שינויים חשובים מאז גרסה 1.0.0
- הוספנו את
Trace.forceEnableAppTracing(), ממשק API שמאפשר לחייב הפעלה של תיעוד קטעי מעקב של אפליקציות (כלומר ממשקי ה-API של android.os.Trace או androidx.tracing) בגרסאות build שלא ניתן לנפות בהן באגים. צריך להפעיל את הפונקציה הזו בתחילת ההפעלה כדי לאפשר מעקב מדויק אחר המערכת שלא ניתן לניפוי באגים לפני הוספת תג המניפסט שניתן ליצור לו פרופיל ב-API 29. (I3a309) - מניעת שגיאות באימות המחלקה כשטוענים את Trace.java בפעם הראשונה (05f6b4 ו-cb101f)
גרסה 1.1.0-rc01
20 באפריל 2022
הגרסאות androidx.tracing:tracing:1.1.0-rc01 ו-androidx.tracing:tracing-ktx:1.1.0-rc01 הושקו, ללא שינויים מאז beta01. גרסה 1.1.0-rc01 מכילה את השינויים האלה.
גרסה 1.1.0-beta01
1 בדצמבר 2021
androidx.tracing:tracing:1.1.0-beta01 ו-androidx.tracing:tracing-ktx:1.1.0-beta01 מופצים. גרסה 1.1.0-beta01 מכילה את השמירות האלה.
אין שינויים מאז 1.1.0-alpha02.
גרסה 1.1.0-alpha02
17 בנובמבר 2021
androidx.tracing:tracing:1.1.0-alpha02 ו-androidx.tracing:tracing-ktx:1.1.0-alpha02 מופצים. גרסה 1.1.0-alpha02 מכילה את השמירות האלה.
תכונות חדשות
- הוספנו את Trace.forceEnableAppTracing(), ממשק API שמאפשר לחייב הפעלה של תיעוד קטעי מעקב של אפליקציות (כלומר ממשקי ה-API של android.os.Trace / andoridx.tracing) בגרסאות build שלא ניתן לנפות בהן באגים. צריך להפעיל את הפונקציה הזו בתחילת ההפעלה כדי לאפשר מעקב מדויק אחר המערכת שלא ניתן לניפוי באגים, לפני הוספת תג המניפסט שניתן ליצור לו פרופיל ב-API 29. (I3a309)
גרסה 1.1.0-alpha01
3 בנובמבר 2021
androidx.tracing:tracing:1.1.0-alpha01 ו-androidx.tracing:tracing-ktx:1.1.0-alpha01 מופצים. גרסה 1.1.0-alpha01 מכילה את השמירות האלה.
תיקוני באגים
גירסה 1.0
גרסה 1.0.0
28 באוקטובר 2020
androidx.tracing:tracing:1.0.0 ו-androidx.tracing:tracing-ktx:1.0.0 מופצים. גרסה 1.0.0 מכילה את השמירות האלה.
התכונות העיקריות בגרסה 1.0.0
עוזר לכתוב אירועי מעקב למאגר הנתונים הזמני של מעקב המערכת. אפשר להציג את זה באמצעות כלים כמו Systrace ו-Perfetto. הספרייה הזו מחליפה את המחלקה androidx.core.os.TraceCompat שהוצאה משימוש.
גרסה 1.0.0-rc01
14 באוקטובר 2020
androidx.tracing:tracing:1.0.0-rc01 ו-androidx.tracing:tracing-ktx:1.0.0-rc01 מופצים. גרסה 1.0.0-rc01 מכילה את השמירות האלה.
הגרסה הזו זהה לגרסה 1.0.0-beta01.
גרסה 1.0.0-beta01
24 ביוני 2020
הגרסאות androidx.tracing:tracing:1.0.0-beta01 ו-androidx.tracing:tracing-ktx:1.0.0-beta01 הושקו ללא שינויים מאז 1.0.0-alpha01. גרסה 1.0.0-beta01 מכילה את השמירות האלה.
גרסה 1.0.0-alpha01
10 ביוני 2020
androidx.tracing:tracing:1.0.0-alpha01 ו-androidx.tracing:tracing-ktx:1.0.0-alpha01 מופצים. גרסה 1.0.0-alpha01 מכילה את השמירות האלה.
תכונות חדשות
androidx.tracing היא ספרייה שעוזרת לכתוב אירועי מעקב למאגר של עקבות המערכת. אפשר להציג את זה באמצעות כלים כמו Systrace ו-Perfetto. הספרייה הזו מחליפה את המחלקה androidx.core.os.TraceCompat שהוצאה משימוש. הגרסה הראשונית היא 1.0.0-alpha01.
מעקב אחר Perfetto
גירסה 1.0
גרסה 1.0.1
19 בנובמבר 2025
הגרסאות androidx.tracing:tracing-perfetto:1.0.1, androidx.tracing:tracing-perfetto-binary:1.0.1 ו-androidx.tracing:tracing-perfetto-handshake:1.0.1 פורסמו. גרסה 1.0.1 מכילה את השמירות האלה.
תיקוני באגים
- תמיכה בדפים בגודל 16KB (b7a7dd)
- הוסר המתווה הידני של הגישה לממשקי API חדשים של הפלטפורמה, כי זה קורה באופן אוטומטי באמצעות בניית מודלים של API כשמשתמשים ב-R8 עם AGP 7.3 ואילך (למשל, גרסה 3.3 של R8) ובכל ה-builds כשמשתמשים ב-AGP 8.1 ואילך (למשל, גרסה 8.1 של D8). ללקוחות שלא משתמשים ב-AGP, מומלץ לעדכן לגרסה 8.1 ומעלה של D8. למידע נוסף, מומלץ לעיין במאמר הזה. (Ia60e0, b/345472586)
- מומלץ להימנע מהוספת עותקים של
FastNative/CriticalNativeלספרייה, ולהשתמש בעותקים של הפלטפורמה היציבה. (I8238a, b/35664282, b/280878596)
גרסה 1.0.0
4 באוקטובר 2023
הגרסאות androidx.tracing:tracing-perfetto:1.0.0, androidx.tracing:tracing-perfetto-binary:1.0.0 ו-androidx.tracing:tracing-perfetto-handshake:1.0.0 פורסמו. גרסה 1.0.0 מכילה את השמירות האלה.
התכונות העיקריות בגרסה 1.0.0
- זו הגרסה היציבה הראשונה של ספריות Tracing-perfetto.
גרסה 1.0.0-rc01
20 בספטמבר 2023
הגרסאות של androidx.tracing:tracing-perfetto:1.0.0-rc01, androidx.tracing:tracing-perfetto-binary:1.0.0-rc01 ו-androidx.tracing:tracing-perfetto-handshake:1.0.0-rc01 הושקו ללא שינויים מאז גרסת הבטא האחרונה. גרסה 1.0.0-rc01 מכילה את השמירות האלה.
גרסה 1.0.0-beta03
30 באוגוסט 2023
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-beta03, androidx.tracing:tracing-perfetto-binary:1.0.0-beta03 ו-androidx.tracing:tracing-perfetto-handshake:1.0.0-beta03 פורסמו. גרסה 1.0.0-beta03 מכילה את השמירות האלה.
- הגרסה עודכנה כדי להתאים לגרסה של androidx.benchmark.
גרסה 1.0.0-beta02
23 באוגוסט 2023
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-beta02, androidx.tracing:tracing-perfetto-binary:1.0.0-beta02 ו-androidx.tracing:tracing-perfetto-handshake:1.0.0-beta02 פורסמו. גרסה 1.0.0-beta02 מכילה את השינויים האלה.
תכונות חדשות
- הוספנו תמיכה במעקב בזמן הפעלת האפליקציה (הפעלה מההתחלה).
גרסה 1.0.0-beta01
18 ביולי 2023
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-beta01, androidx.tracing:tracing-perfetto-binary:1.0.0-beta01 ו-androidx.tracing:tracing-perfetto-handshake:1.0.0-beta01 פורסמו. גרסה 1.0.0-beta01 מכילה את השמירות האלה.
שינויים ב-API
- השם של
androidx.tracing.perfetto.Traceשונה ל-androidx.tracing.perfetto.PerfettoSdkTrace(I44af8) - שינינו את השם של הקבועים exit code ל-result code בפרוטוקול כדי לשמור על עקביות (Id1d1e)
- השם של
EnableTracingResponseשונה ל-Response. (I56275) - הוספנו אפשרות להפעיל מעקב אחר הפעלה מההתחלה (cold start) במצב קבוע. הוספנו פונקציה לניקוי מעקב אחר הפעלה קרה (קבוע או לא). (Iaa09d)
- ממשקי ה-API של Tracing Perfetto SDK תואמים ל-
android.os.Trace. (I73ba0, b/282199917) - מעבר לתבנית מפעל (factory pattern) עבור
LibrarySource, שמאפשרת להוסיף בקלות ל-API תרחישי שימוש עתידיים (למשל, טעינת הקובץ.soישירות) במקרה הצורך. (I128df) - התאמת הפרמטרים של
enableTracingColdStartל-enableTracingImmediate(I54126) - הארגומנט
killProcessהוסר ב-enableTracingColdStart(I81c4d)
גרסה 1.0.0-alpha17
21 ביוני 2023
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-alpha17, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha17 ו-androidx.tracing:tracing-perfetto-handshake:1.0.0-alpha17 פורסמו ללא שינויים מגרסת האלפא הקודמת. גרסה 1.0.0-alpha17 מכילה את השינויים האלה.
גרסה 1.0.0-alpha16
7 ביוני 2023
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-alpha16, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha16 ו-androidx.tracing:tracing-perfetto-common:1.0.0-alpha16 פורסמו ללא שינויים מגרסת האלפא הקודמת. גרסה 1.0.0-alpha16 מכילה את השינויים האלה.
גרסה 1.0.0-alpha15
3 במאי 2023
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-alpha15, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha15 ו-androidx.tracing:tracing-perfetto-common:1.0.0-alpha15 הושקו ללא שינויים. גרסה 1.0.0-alpha15 מכילה את השמירות האלה.
גרסה 1.0.0-alpha14
5 באפריל 2023
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-alpha14, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha14 ו-androidx.tracing:tracing-perfetto-common:1.0.0-alpha14 הושקו ללא שינויים חדשים. גרסה 1.0.0-alpha14 כוללת את השינויים האלה.
גרסה 1.0.0-alpha13
22 במרץ 2023
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-alpha13, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha13 ו-androidx.tracing:tracing-perfetto-common:1.0.0-alpha13 פורסמו ללא שינויים מאז הפרסום האחרון. גרסה 1.0.0-alpha13 מכילה את השינויים האלה.
גרסה 1.0.0-alpha12
8 במרץ 2023
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-alpha12, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha12 ו-androidx.tracing:tracing-perfetto-common:1.0.0-alpha12 הושקו ללא שינויים מגרסת האלפא הקודמת. גרסה 1.0.0-alpha12 מכילה את השינויים האלה.
גרסה 1.0.0-alpha11
22 בפברואר 2023
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-alpha11, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha11 ו-androidx.tracing:tracing-perfetto-common:1.0.0-alpha11 הושקו ללא שינויים. גרסה 1.0.0-alpha11 מכילה את השמירות האלה.
גרסה 1.0.0-alpha10
8 בפברואר 2023
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-alpha10, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha10 ו-androidx.tracing:tracing-perfetto-common:1.0.0-alpha10 פורסמו ללא שינויים. גרסה 1.0.0-alpha10 מכילה את השינויים האלה.
גרסה 1.0.0-alpha09
10 בפברואר 2023
androidx.tracing:tracing-perfetto-binary:1.0.0-alpha09 מופץ. גרסה 1.0.0-alpha09 מכילה את השינויים האלה.
תכונות חדשות
- גרסה חדשה שמאפשרת לספריות
androidx.tracing:tracing-perfetto*: 1.0.0-alpha09אחרות לפעול ביחד.
11 בינואר 2023
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-alpha09 ו-androidx.tracing:tracing-perfetto-common:1.0.0-alpha09 פורסמו ללא שינויים. גרסה 1.0.0-alpha09 מכילה את השינויים האלה.
גרסה 1.0.0-alpha08
7 בדצמבר 2022
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-alpha08, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha08 ו-androidx.tracing:tracing-perfetto-common:1.0.0-alpha08 פורסמו. גרסה 1.0.0-alpha08 מכילה את השינויים האלה.
תכונות חדשות
- שיפור הביצועים באמצעות אופטימיזציה של הטיפול במחרוזות.
תיקוני באגים
- הוספנו כלל proguard שמונע הסרה של שיטות של
PerfettoNativeאם נעשה שימוש כלשהו במחלקה (מונע קריסה במקרה נישה שבו מתבצעת אתחול של מעקב, אבל אין קריאות מעקב באפליקציה).
גרסה 1.0.0-alpha07
9 בנובמבר 2022
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-alpha07, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha07 ו-androidx.tracing:tracing-perfetto-common:1.0.0-alpha07 פורסמו. גרסה 1.0.0-alpha07 מכילה את השמירות האלה.
- הפחתת התקורה של JNI בממשקי ה-API של
androidx.tracing:tracing-perfetto.
גרסה 1.0.0-alpha06
24 באוקטובר 2022
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-alpha06, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha06 ו-androidx.tracing:tracing-perfetto-common:1.0.0-alpha06 פורסמו. גרסה 1.0.0-alpha06 מכילה את השמירות האלה.
- העדכון הזה לא כולל שינויים, רק עדכון של מספר הגרסה לסנכרון עם androidx.benchmark.
גרסה 1.0.0-alpha05
5 באוקטובר 2022
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-alpha05, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha05 ו-androidx.tracing:tracing-perfetto-common:1.0.0-alpha05 פורסמו. גרסה 1.0.0-alpha05 מכילה את השמירות האלה.
גרסה 1.0.0-alpha04
21 בספטמבר 2022
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-alpha04, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha04 ו-androidx.tracing:tracing-perfetto-common:1.0.0-alpha04 פורסמו. גרסה 1.0.0-alpha04 מכילה את השמירות האלה.
גרסה 1.0.0-alpha03
7 בספטמבר 2022
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-alpha03, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha03 ו-androidx.tracing:tracing-perfetto-common:1.0.0-alpha03 פורסמו.
תכונות חדשות
- אין תכונות חדשות מגרסה 1.0.0-alpha02.
גרסה 1.0.0-alpha02
24 באוגוסט 2022
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-alpha02, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha02 ו-androidx.tracing:tracing-perfetto-common:1.0.0-alpha02 פורסמו. גרסה 1.0.0-alpha02 מכילה את השמירות האלה.
תיקוני באגים
- כמה שיפורים בהפעלה של שירות Perfetto
- טיפול משופר במקרה של חוסר תגובה על ידי הוספת קוד יציאה ייעודי: RESULT_CODE_CANCELLED.
- טיפול משופר בשגיאות ניתוח.
- הגדרנו את
EnableTracingResponse.requiredVersionכ-nullable, כי אנחנו לא יכולים לדעת מה הגרסה אם אנחנו לא יכולים לתקשר עם החבילה. (I5ba20)
גרסה 1.0.0-alpha01
27 ביולי 2022
הגרסאות androidx.tracing:tracing-perfetto:1.0.0-alpha01, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha01 ו-androidx.tracing:tracing-perfetto-common:1.0.0-alpha01 פורסמו. גרסה 1.0.0-alpha01 מכילה את השמירות האלה.
- הערה: כל ספריות
androidx.tracing:tracing-perfetto*מיועדות בהתחלה רק לשימוש פנימי בספריות AndroidX. לא אמור להיות צורך להסתמך עליהם ישירות.
תכונות חדשות
כל הספריות של
androidx.tracing:tracing-perfetto*מיועדות בהתחלה רק לשימוש פנימי בספריות של AndroidX, ואין צורך להסתמך עליהן באופן ישיר. אנחנו מתעדים את פרטי ההטמעה האלה כדי לשמור על שקיפות.
androidx.tracing:tracing-perfettoהיא ספרייה שעוזרת לכתוב אירועי מעקב באמצעות Perfetto SDK עם תקורה נמוכה. אפשר להשתמש בזה ב-Benchmark, ב-Android Studio או בממשק המשתמש של Perfetto.
androidx.tracing:tracing-perfetto-binaryהיא קבוצה של יחסי תלות בינאריים שנדרשים ל-androidx.tracing:tracing-perfetto.
androidx.tracing:tracing-perfetto-commonהיא תלות פנימית של androidx.tracing:tracing-perfetto, וכלים יכולים להשתמש בה כדי לשלב עם androidx.tracing:tracing-perfetto.