מבצע מעקב

כתיבת אירועי מעקב למאגר של עקבות המערכת או תיעוד עקבות בתהליך עם תקורה נמוכה.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫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)

תיקוני באגים

גרסה ‎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 מכילה את השמירות האלה.

תיקוני באגים

  • מניעת שגיאות באימות המחלקה כשטוענים את 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 ואילך (למשל, גרסה 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.