מבצע מעקב

  
כתיבת אירועי מעקב למאגר המעקב של המערכת.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫19 במאי 2026 1.3.0 - - ‎2.0.0-alpha08

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. נשמח לדעת אם גיליתם בעיות חדשות או אם יש לכם רעיונות איך לשפר את הספרייה הזו. כדאי לעיין בבעיות הידועות בספרייה הזו לפני שמדווחים על בעיה. כדי להוסיף הצבעה בדיווח על בעיה קיימת, לוחצים על כפתור הכוכב.

יצירת דיווח על בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

מבצע מעקב

גרסה 2.0

גרסה ‎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 כדי לקבל כלי למעקב אחר קוד חלופי (stub) שאפשר להשתמש בו כשהמעקב מושבת. (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)

תיקוני באגים

גרסה ‎2.0.0-alpha05

‫8 באפריל 2026

‫androidx.tracing:tracing-*:2.0.0-alpha05 מופץ. גרסה ‎2.0.0-alpha05 מכילה את השמירות האלה.

שינויים ב-API

  • פונקציות של TraceSink מחזירות עכשיו TraceSink ולא AbstractTraceSink. הקבצים מקבלים עכשיו סיומת ייחודית. אנחנו מוודאים שאפשר ליצור באופן אטומי קובץ חדש שישמש לאחסון מנות של נתוני מעקב. (I4c4aa, ‏ b/496298726)
  • פישוט והאצת ההפצה של הקשר של קורוטינה. (Ia62db)
  • הוספנו את האפשרות attributes() כשיוצרים TraceDriver, כדי לאפשר הוספה של מטא-נתונים שקשורים ל-Trace. (Ia147e)

תיקוני באגים

  • התהליכים של ה-threads והטראקים של המונים מסונכרנים עכשיו. כך נפתרות חריגות מהסוג הבא: java.lang.NullPointerException: Cannot invoke "androidx.tracing.ThreadTrack.flush$tracing()" because "threadTrack" is null
  • הימנעו מפליטת אירועים של יעד כשמעקב מושבת.

גרסה ‎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 intrinsic ‏ (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 תומכים בנתוני מעקב שמופקים, ואפשר להקליט אותם באמצעות מערך תכונות מורחב שכולל תיוג של פלחים במטא-נתונים (כמו ארגומנטים של פונקציות!) והפצה של נתוני מעקב בהקשר של שגרות המשך.

גרסת האלפא הראשונית הזו מיועדת רק לרצפי פעולות של מעקב בתוך התהליך, ועדיין לא משולבת עם מעקב ב-Android OS או עם מעקב במערכת 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)
  • ייצוב ממשקי ה-API‏ BlackHole ב-androidx.benchmark. (I2b67e, ‏ b/451749438)
  • הוספת האפשרות להוסיף הערות לקטע של המעקב כטווח בסיסי. (Ic8365)
  • התרת שימוש באסימוני הפצה מפורשים על ידי המפתח. (I06bb1)
  • שונה השם של MetadataHandleCloseable ל-EventMetadataCloseable, ושל MetadataHandle ל-EventMetadata. נוסף גם ארגומנט אופציונלי CoroutinePropagationToken ל-Tracer.traceCoroutine כדי לאפשר למפתח לציין באופן מפורש את אסימון ההפצה שבו רוצים להשתמש. (I219f7, ‏ b/454147392)
  • הוספנו Tracer נקודת כניסה חדשה שמעניקה למפתחים הרבה יותר שליטה על אופן המעקב. (I24a7b)
  • הוספת אפשרות לשלוט באופן ההפצה של ההקשר ב-SliceTrack. (Ieb8fc)
  • ‫fillCount ב-PooledTracePacketArray מסומן עכשיו כמשתנה (volatile) בצורה נכונה. (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 מכילה את השמירות האלה.

שינויים ב-API

  • העברנו את כל הקוד מהמודול tracing-ktx אל tracing. (Iba550)
  • המרתי את המחלקה androidx.tracing.Trace ל-Kotlin. (Ie4e5d)

תיקוני באגים

  • הסרנו את האפשרות ליצור באופן ידני תרשים של הגישה לממשקי API חדשים של הפלטפורמה, כי זה קורה אוטומטית באמצעות מידול API כשמשתמשים ב-R8 עם AGP 7.3 ואילך (למשל R8 גרסה 3.3) ובכל הבנייה כשמשתמשים ב-AGP 8.1 ואילך (למשל D8 גרסה 8.1). לקוחות שלא משתמשים ב-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 הזה בתחילת ההפעלה כדי להפעיל מעקב מדויק אחר המערכת בגרסאות build שלא ניתן לבצע בהן ניפוי באגים, לפני ההשקה של תג המניפסט profileable ב-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 להפעלה מאולצת של לכידת קטע של מעקב אחר אפליקציה (כלומר, android.os.Trace / andoridx.tracing APIs) בגרסאות build שלא ניתן לבצע בהן ניפוי באגים. צריך להפעיל את ה-API הזה בתחילת ההפעלה כדי להפעיל מעקב מדויק אחר המערכת בגרסאות 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 מכילה את השמירות האלה.

תיקוני באגים

  • הימנעות משגיאות באימות הכיתה כש-Trace.java נטען בפעם הראשונה (05f6b4 ו-cb101f)

גירסה 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 ואילך (למשל R8 גרסה 3.3) ובכל הבנייה כשמשתמשים ב-AGP 8.1 ואילך (למשל D8 גרסה 8.1). לקוחות שלא משתמשים ב-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 מכילה את השמירות האלה.

תכונות חדשות

  • הוספנו תמיכה במעקב בזמן הפעלת האפליקציה (cold start).

גרסה ‎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) במצב מתמשך. נוספה פונקציה לניקוי מעקב אחר הפעלה במצב התחלתי (cold start) (מתמשך או לא). (Iaa09d)
  • הפכנו את ממשקי ה-API של Tracing Perfetto SDK לעקביים עם android.os.Trace. (I73ba0, ‏ b/282199917)
  • עברנו לדפוס factory ל-LibrarySource כדי לאפשר הוספה קלה של תרחישי שימוש עתידיים (למשל, טעינה ישירה של קובץ .so) ל-API אם יהיה צורך בכך. (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.