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

تتضمّن الأجهزة التي تعمل بنظام التشغيل Android 9 (مستوى واجهة برمجة التطبيقات 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. مفتاح التبديل تسجيل التتبُّع في إعدادات "تتبُّع النظام"

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

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

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

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

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

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

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

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

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

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

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

تنزيل التقرير باستخدام 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، يمكنك تنزيله من مشروع Catapult على GitHub أو مباشرةً من مشروع Android المفتوح المصدر.