تسجيل تتبُّع النظام على جهاز

تتضمّن الأجهزة التي تعمل بالإصدار 9 من نظام التشغيل Android (المستوى 28 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث تطبيقًا على مستوى النظام يُسمى "تتبُّع النظام". يشبه هذا التطبيق أداة systrace سطر الأوامر، ولكنّه يتيح لك تسجيل عمليات التتبُّع مباشرةً من الجهاز الاختباري نفسه، بدون الحاجة إلى توصيل الجهاز وتوصيله به عبر adb. يمكنك بعد ذلك استخدام التطبيق لمشاركة النتائج من هذه الآثار مع فريق التطوير لديك.

تُسجِّل الأجهزة التي تعمل بنظام التشغيل Android 10 والإصدارات الأحدث عمليات التتبُّع بتنسيق Perfetto، في حين تسجِّلها الأجهزة الأقدم بتنسيق Systrace. ننصحك باستخدام Perfetto عارض التتبّع لفتح كلا التنسيقَين ثم تحليل عمليات التتبّع.

يساعد ذلك في تسجيل عمليات التتبّع عند معالجة الأخطاء المتعلّقة بالأداء في تطبيقك، مثل بطء بدء التشغيل أو الانتقالات البطيئة أو عدم سلاسة واجهة المستخدم.

تسجيل عملية تتبُّع للنظام

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

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

التسجيل باستخدام مربّع "الإعدادات السريعة"

عادةً ما يكون شريط الإعدادات السريعة هو الطريقة الأكثر ملاءمةً لإكمال عملية تتبُّع النظام على الجهاز.

إعداد شاشة المعلومات

إذا كنت تستخدم تتبّع النظام للمرة الأولى على جهاز الاختبار، أو إذا لم يظهر لك مربّع تتبُّع النظام في لوحة الإعدادات السريعة على جهازك، كما هو موضّح في الشكل 2، أكمِل خطوات الإعداد التالية:

1. فعِّل خيارات المطوّرين.
2. افتح شاشة إعدادات خيارات المطوّرين.
3. في قسم تصحيح الأخطاء، اختَر تتبُّع النظام. سيتم فتح تطبيق "تتبُّع النظام" ويعرض قائمة التطبيق.

4. من قائمة التطبيق، فعِّل عرض مربّع الإعدادات السريعة، كما هو موضّح في الشكل 1. يضيف النظام مربّع تتبُّع النظام إلى لوحة الإعدادات السريعة، كما هو موضّح في الشكل 2:

   

   الشكل 1. مفتاح تبديل عرض مربّع الإعدادات السريعة في تطبيق "تتبُّع النظام".

   

   الشكل 2. مربّع تتبُّع النظام ضمن لوحة الإعدادات السريعة

   ملاحظة: يُضيف النظام تلقائيًا مربّع تتبُّع النظام كأول مربّع في لوحة الإعدادات السريعة. إذا أردت أن يظهر المربّع في موضع مختلف، استخدِم وضع التعديل في اللوحة لتحريك المربّع.

إكمال تسجيل تتبُّع النظام

لتسجيل تتبُّع أداء النظام باستخدام لوحة الإعدادات السريعة، أكمِل الخطوات التالية:

1. انقر على مربّع تتبُّع النظام الذي يحمل التصنيف تسجيل تتبُّع. يتم تفعيل الجدول، ويظهر إشعار دائم لإعلامك بأنّ النظام يسجلّ عملية تتبُّع، كما هو موضّح في الشكل 3:

   

   الشكل 3. إشعار دائم يظهر بعد بدء تتبُّع النظام على الجهاز

2. نفِّذ الإجراءات في تطبيقك التي تريد أن يفحصها النظام.

   ملاحظة: يمكنك تسجيل الأخطاء التي يصعب تكرارها من خلال ترك ميزة "تتبُّع النظام" مفعّلة في الخلفية ثم إيقافها بعد وقت قصير من حدوث الخطأ. تُحفظ ميزة "تتبُّع النظام" نشاط الجهاز في ملف مؤقت متجدّد، والذي يحتفظ بأحداث تتراوح مدتها بين 10 و30 ثانية.

3. يمكنك إيقاف التتبُّع من خلال النقر على مربّع تتبُّع النظام في لوحة الإعدادات السريعة أو على إشعار "تتبُّع النظام".

   يعرض النظام إشعارًا جديدًا يتضمّن الرسالة "جارٍ حفظ آثار الأنشطة". عند اكتمال الحفظ، يغلق النظام الإشعار ويعرض إشعارًا ثالثًا، يؤكد أنه تم حفظ ملف التتبُّع وأنّك جاهز لمشاركة بيانات تتبُّع النظام، كما هو موضّح في الشكل 4:

   

   الشكل 4. إشعار دائم يظهر بعد انتهاء النظام من حفظ تتبع مسجَّل.

التسجيل باستخدام قائمة التطبيقات

تتيح لك قائمة التطبيق ضبط العديد من الإعدادات المتقدّمة المتعلّقة بتسجيل أثر النظام، كما توفّر مفتاح تبديل لبدء عملية تسجيل أثر النظام وإيقافها.

لتسجيل تتبُّع للنظام باستخدام قائمة تطبيق "تتبُّع النظام"، أكمِل الخطوات التالية:

1. تفعيل خيارات المطوّرين

2. افتح شاشة إعدادات خيارات المطوّرين. في قسم تصحيح الأخطاء، اختَر تتبُّع النظام. يتم فتح تطبيق "تتبُّع النظام".

   بدلاً من ذلك، إذا أعددت مربّع تتبُّع النظام، يمكنك النقر مع الاستمرار على مربّع التطبيق للدخول إليه.

3. تأكَّد من اختيار تتبُّع التطبيقات القابلة لتصحيح الأخطاء لتضمين التطبيقات التي تم تفعيل تصحيح الأخطاء فيها في تتبُّع النظام.

4. اختياريًا، اختَر الفئات لطلبات النظام وأجهزة الاستشعار لتتبُّعها، واختَر حجم المخزن المؤقت لكل وحدة معالجة مركزية بالكيلوبايت. اختَر الفئات التي تتوافق مع حالة الاستخدام التي تختبرها، مثل فئة الصوت لاختبار عمليات البلوتوث أو فئة الذاكرة لتخصيص الذاكرة.

   ملاحظة: تعمل هذه الفئات كإعدادات على مستوى التطبيق، لذلك يستخدم النظام هذه الفئات عند استخدام مربّع الإعدادات السريعة أيضًا. بالإضافة إلى ذلك، تظل هذه الإعدادات محفوظة عند إعادة تشغيل الجهاز.

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

6. فعِّل مفتاح التبديل تسجيل التتبُّع، كما هو موضّح في الشكل 5. يصبح المربّع مفعّلاً، ويظهر إشعار دائم لإعلامك بأنّ النظام يُسجّل عملية تتبُّع، كما هو موضّح في الشكل 3.

   

   الشكل 5. مفتاح التبديل تسجيل التتبُّع في إعدادات System (النظام) Tracing (التتبُّع).

7. نفِّذ الإجراءات في التطبيق التي تريد أن يفحصها النظام.

   ملاحظة: يمكنك تسجيل الأخطاء التي يصعب تكرارها من خلال ترك ميزة "تتبُّع النظام" مفعّلة في الخلفية، ثم إيقافها بعد وقت قصير من حدوث الخطأ. تُحفظ ميزة "تتبُّع النظام" تلقائيًا لنشاط الجهاز في ذاكرة تخزين مؤقتة متجدّدة، والتي تحتفظ بأحداث تتراوح مدتها بين 10 و30 ثانية. إذا تم تفعيل تتبُّع الخطوات الطويلة، يتم حفظ نشاط الجهاز باستمرار في مساحة التخزين على الجهاز إلى أن تصل إلى الحدود التي ضبطتها.

8. أوقِف التتبُّع عن طريق إيقاف مفتاح التبديل تسجيل التتبُّع.

   يعرض النظام إشعارًا جديدًا يحتوي على الرسالة "جارٍ حفظ أثر الخطأ". عند اكتمال الحفظ، يغلق النظام الإشعار ويعرض إشعارًا ثالثًا، يؤكد أنه تم حفظ عملية التتبُّع وأنّك مستعد لمشاركة سجلّ تتبُّع النظام، كما هو موضّح في الشكل 4.

مشاركة تتبُّع للنظام

يساعدك تطبيق "تتبُّع النظام" على مشاركة نتائج تتبُّع النظام كجزء من عدة عمليات عمل مختلفة. على جهاز يعمل بالإصدار 10 من نظام التشغيل Android (المستوى 29 لواجهة برمجة التطبيقات) أو إصدار أحدث، يتم حفظ ملفات التتبّع باستخدام إضافة اسم الملف .perfetto-trace ويمكن فتحها في واجهة مستخدم Perfetto. على جهاز يعمل بإصدار سابق من Android، يتم حفظ ملفات التتبُّع باستخدام إضافة اسم الملف .ctrace التي تشير إلى تنسيق Systrace.

المشاركة كرسالة

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

بعد تسجيل تتبع للنظام، انقر على الإشعار الذي يظهر على الجهاز، مثل الإشعار الظاهر في الشكل 4. يظهر أداة اختيار الغرض من المنصة، ما يتيح لك مشاركة التتبّع باستخدام تطبيق المراسلة الذي تختاره.

المشاركة من تطبيق "الملفات"

على الأجهزة التي تعمل بالإصدار 10 من نظام التشغيل Android (المستوى 29 لواجهة برمجة التطبيقات) أو إصدار أحدث، يتم عرض عمليات التتبُّع في تطبيق Files. ويمكنك مشاركة عملية تتبُّع من هذا التطبيق.

تنزيل التقرير باستخدام ADB

يمكنك أيضًا استخراج سجلّ تتبُّع للنظام من جهاز باستخدام adb. يمكنك توصيل الجهاز المستخدم لتسجيل التتبع في جهاز التطوير، ثم تشغيل الأوامر التالية في نافذة طرفية:

cd /path-to-traces-on-my-dev-machine && \
  adb pull /data/local/traces/ .

التحويل بين تنسيقات التتبُّع

يمكنك تحويل ملفات تتبُّع Perfetto إلى تنسيق Systrace. راجع التحويل بين تنسيقات التتبع للحصول على مزيد من المعلومات.

إنشاء تقرير HTML

عند مشاركة عملية التتبُّع، يكون التقرير نفسه في ملف .perfetto-trace على الأجهزة التي تعمل بنظام التشغيل Android 10 أو الإصدارات الأحدث، أو ملف .ctrace لجميع الإصدارات الأخرى.

يمكنك إنشاء تقرير HTML من ملف التتبُّع باستخدام واجهة مستخدم مستندة إلى الويب أو من سطر الأوامر.

واجهة المستخدم المستندة إلى الويب

استخدِم واجهة مستخدم Perfetto لفتحملف التتبُّع وإنشاء التقرير.

بالنسبة إلى ملف Perfetto، انقر على فتح ملف التتبُّع. بالنسبة إلى ملف Systrace، انقر على فتح باستخدام واجهة المستخدم القديمة. تتميز واجهة المستخدم القديمة بالمظهر والأسلوب نفسهما المُستخدَمَين في تقرير Systrace.

سطر الأوامر

شغِّل الأوامر التالية في نافذة وحدة طرفية لإنشاء تقرير HTML من ملف التتبُّع:

cd /path-to-traces-on-my-dev-machine && \
  systrace --from-file trace-file-name{.ctrace | .perfetto-trace}

إذا لم يكن لديك برنامج سطر الأوامر systrace، يمكنك تنزيله من project Catapult على GitHub، أو مباشرةً من مشروع Android Open Source.