מבצע מעקב

  
כתיבת אירועי מעקב למאגר המעקב של המערכת.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
12 בפברואר 2025 1.2.0 - 1.3.0-beta01 -

משוב

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

דיווח על בעיה חדשה

מידע נוסף זמין במסמכי התיעוד של Issue Tracker.

גרסה 1.3

גרסה 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) ובכל גרסאות ה-build כשמשתמשים ב-AGP מגרסה 8.1 ואילך (למשל, D8 מגרסה 8.1). לקוחות שלא משתמשים ב-AGP מומלצים לעדכן ל-D8 בגרסה 8.1 ואילך. למידע נוסף, מומלץ לעיין במאמר הזה. (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 מהמעקב כדי לאפשר שימוש ב-@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 של Tracing

גרסה 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)

Tracing Perfetto גרסה 1.0.0

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

גרסה 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 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

  • הפחתת זמן ה-overhead של 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 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

גרסה 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.

גרסה 1.0.0 של Tracing

גרסה 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.