تصحيح أخطاء مستخدمي WorkManager باستخدام أداة فحص المهام في الخلفية

تساعدك أداة Background Task Inspector (أداة فحص المهام في الخلفية) في عرض المهام التي تعمل في الخلفية ومراقبتها وتصحيح أخطائها عند استخدام الإصدار 2.5.0 أو إصدار أحدث من WorkManager library.

البدء

لإدراج العاملين في Background Task Inspector (أداة فحص المهام في الخلفية)، عليك إجراء ما يلي:

  1. شغِّل تطبيقك على محاكي أو جهاز متصل يستخدم المستوى 26 من واجهة برمجة التطبيقات أو مستوى أعلى.

  2. اختَر عرض > أدوات Windows > فحص التطبيق من شريط القوائم.

  3. اختَر علامة التبويب Background Task Inspector (أداة فحص المهام في الخلفية).

  4. حدد عملية التطبيق قيد التشغيل من القائمة.

  5. يظهر العاملون في التطبيق قيد التشغيل حاليًا في جزء Background Task Inspector (أداة فحص المهام في الخلفية). انقر على العامل الذي تريد فحصه بشكل أكبر.

الاطّلاع على العمّال وفحصهم

عند نشر تطبيق باستخدام WorkManager 2.5.0 أو إصدار أحدث على جهاز يعمل بالمستوى 26 من واجهة برمجة التطبيقات أو مستوى أعلى، تعرض علامة التبويب Background Task Inspector (أداة فحص المهام في الخلفية) العاملين النشطين. تعرض أداة فحص المهام في الخلفية (على النحو الموضّح في القسم اللاحق في الشكل 3) اسم الفئة والحالة الحالية ووقت البدء وعمليات إعادة المحاولة لجميع المهام، سواء كانت قيد التشغيل أو فشلت أو اكتملت.

تفاصيل العمل

انقر على وظيفة من القائمة لفتح لوحة تفاصيل العمل التي تعرض معلومات تفصيلية عن العامل، كما هو موضّح في الشكل 1.

لقطة شاشة لتفاصيل العامل المحدد.
الشكل 1. لوحة تفاصيل العمل.
  • الوصف: يسرد هذا القسم اسم فئة العامل مع الحزمة المؤهلة بالكامل، بالإضافة إلى العلامة المعينة والمعرّف الفريد الفريد لعامل.
  • التنفيذ: يعرض هذا القسم القيود المفروضة على العامل (إن وُجدت) ووتيرة تشغيله وحالته، وكذلك الفئة التي تم إنشاؤها للعامل ووضعه في قائمة الانتظار.
  • استمرارية العمل: يعرض هذا القسم موقع العامل في سلسلة العمل. للتحقق من تفاصيل عامل آخر في سلسلة العمل، انقر فوق UUID الخاص به.
  • النتائج: يعرض هذا القسم وقت البدء وعدد إعادة المحاولة وبيانات المخرجات للعامل المحدّد.

إلغاء اشتراكات العاملين

لإيقاف عامل قيد التشغيل حاليًا أو إضافته إلى قائمة الانتظار، اختَر العامل وانقر على إلغاء العامل المحدّد من شريط الأدوات.

عرض عرض الرسم البياني

نظرًا لإمكانية ربط العمال معًا، قد يكون من المفيد أحيانًا تصور تبعيات العمال كرسم بياني.

للاطلاع على تمثيل مرئي لسلسلة عوامل، اختَر "عامل" من الجدول وانقر على إظهار عرض الرسم البياني من شريط الأدوات. يتم رسم العاملين فقط في الرسم البياني.

لقطة شاشة لعرض الرسم البياني
الشكل 2. عرض الرسم البياني

يتيح لك الرسم البياني رؤية العلاقات بين العاملين بسرعة ومراقبة تقدمهم في علاقات التسلسل المعقدة.

للرجوع إلى عرض القائمة، انقر على إظهار عرض القائمة .

عرض وفحص "الوظائف" و"المنبّهات" و"أنظمة التشغيل الآلي"

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

على غرار العاملين، يمكنك تحديد "Job" (وظيفة) أو "Aarm" (منبه) أو Wakelock لفحص معلوماتها التفصيلية في لوحة "Task Details" (تفاصيل المهمة).

للاطِّلاع على معلومات تفصيلية حول "مشغِّل" أو "مهمة" أو "منبه" أو "قفل نظام التشغيل"، اختر هذه المعلومات في لوحة تفاصيل المهمة على يسار الصفحة.

لقطة شاشة لنافذة "Background Task Inspector" (أداة فحص المهام في الخلفية)
الشكل 3. نافذة Background Task Inspector (أداة فحص المهام في الخلفية).

مراجع إضافية

لمعرفة المزيد حول "أداة فحص المهام في الخلفية"، راجع الموارد الإضافية التالية:

المستندات

الدروس التطبيقية حول الترميز

مشاركات المدونة