تتبُّع

  
كتابة أحداث التتبُّع في المخزن المؤقت لتتبُّع النظام
آخر تعديل الإصدار المستقر إصدار مرشح الإصدار التجريبي الإصدار الأولي
29 تشرين الثاني (نوفمبر) 2023 1.2.0 - - 1.3.0-alpha02

ملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إخبارنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة تصويتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء عدد جديد

راجع مستندات أداة تتبُّع المشاكل للحصول على مزيد من المعلومات.

الإصدار 1.3

الإصدار 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 على هذه الالتزامات.

تغييرات واجهة برمجة التطبيقات

  • عليك إزالة علامة زائد مضمَّنة من التتبع للسماح باستخدامها في @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() باستخدام السلسلة الكسولة وعملية حساب ملفات تعريف الارتباط. الآن أيضًا يتم تخطّي 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() باستخدام السلسلة الكسولة وعملية حساب ملفات تعريف الارتباط. الآن أيضًا يتم تخطّي 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() واجهة برمجة تطبيقات لفرض تفعيل ميزة تسجيل قسم تتبُّع التطبيقات (أي واجهات برمجة التطبيقات android.os.Trace / androidx.tracing) في الإصدارات التي لا يمكن تصحيح الأخطاء فيها. يمكنك استدعاء هذه الميزة في بداية بدء التشغيل لتفعيل تتبُّع النظام الدقيق غير القابل للتصحيح قبل تقديم علامة البيان القابلة للملف الشخصي في واجهة برمجة التطبيقات 29 API. (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() وهي واجهة برمجة تطبيقات لفرض تفعيل التقاط قسم تتبُّع التطبيقات (مثل android.os.Trace / andoridx.tracing APIs) في الإصدارات التي لا يمكن تصحيح الأخطاء فيها. عليك استدعاء هذا الإجراء في بداية بدء التشغيل لتفعيل تتبُّع النظام الدقيق غير القابل للتصحيح قبل تقديم علامة البيان القابلة للتحليل في واجهة برمجة التطبيقات 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.0 من Perfetto

الإصدار 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.{/9}

الإصدار 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 هذه الالتزامات.

تغييرات واجهة برمجة التطبيقات

  • تمت إعادة تسمية androidx.tracing.perfetto.Trace إلى androidx.tracing.perfetto.PerfettoSdkTrace (I44af8).
  • تمت إعادة تسمية "رمز الخروج" إلى ثوابت "رمز النتيجة" في البروتوكول لتحقيق التناسق (Id1d1e).
  • تمت إعادة تسمية EnableTracingResponse إلى Response. (I56275)
  • تمت إضافة خيار لتفعيل تتبُّع التشغيل على البارد في الوضع الدائم. تمت إضافة وظيفة لمحو تتبُّع البدء على البارد (الدائم أو غير الدائم). (Iaa09d)
  • تم جعل واجهات برمجة تطبيقات Tracing Perfetto SDK متوافقة مع android.os.Trace. (I73ba0، b/282199917)
  • تم نقلها إلى نمط الإعدادات الأصلية في LibrarySource، ما يسمح بإضافة حالات الاستخدام المستقبلية بسهولة (مثل تحميل ملف .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 على هذه الالتزامات.

الميزات الجديدة

  • تحسين الأداء من خلال تحسين طريقة التعامل مع السلاسل

إصلاح الأخطاء

  • تمت إضافة قاعدة حماية تمنع اقتطاع أساليب PerfettoNative في حال استخدام الفئة على الإطلاق (منع حدوث عطل في حالة مخصَّصة عند إعداد التتبُّع، ولكن لا يتوفّر أي طلبات تتبُّع في التطبيق).

الإصدار 1.0.0-alpha07

تشرين الثاني (نوفمبر) 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 العامة على واجهات androidx.tracing:tracing-perfetto API.

الإصدار 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.measure.

الإصدار 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 قابلة للقيم الفارغة، لأنّه لا يمكننا معرفة الإصدار في حال تعذّر علينا الاتصال بالحزمة. (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" هي مكتبة تساعد في كتابة بيانات تتبُّع الأحداث باستخدام حزمة تطوير برامج (SDK) Perfetto المنخفضة التكلفة. يمكن استخدامها داخل مقياس الأداء أو 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 من التتبُّع

الإصدار 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.