تصحيح أخطاء مستخدمي WorkManager باستخدام أداة فحص المهام في الخلفية
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يساعدك "أداة فحص المهام في الخلفية" في
عرض مهام الخلفية في تطبيقك ومراقبتها وتصحيح أخطاءها عند استخدام مكتبة WorkManager 2.5.0 أو إصدار أحدث.
البدء
لإدراج العمال في "أداة فحص المهام في الخلفية"، اتّبِع الخطوات التالية:
تشغيل تطبيقك على محاكي أو جهاز متصل يشغل واجهة برمجة تطبيقات
المستوى 26 أو أعلى.
حدّد عرض > نوافذ الأدوات > فحص التطبيق من شريط القوائم.
اختَر علامة التبويب أداة فحص المهام في الخلفية.
اختَر عملية التطبيق التي تعمل من القائمة.
يظهر العاملون في التطبيق قيد التشغيل حاليًا في مهمة في الخلفية.
أداة الفحص انقر على العامل الذي تريد فحصه بشكل أكبر.
عرض العمال وفحصهم
عند نشر تطبيق باستخدام الإصدار 2.5.0 من WorkManager أو إصدار أحدث على جهاز قيد التشغيل
المستوى 26 من واجهة برمجة التطبيقات أو المستويات الأعلى، تعرض علامة التبويب أداة فحص المهام في الخلفية واجهة برمجة تطبيقات نشطة
العمال. أداة فحص المهام في الخلفية (كما هو موضّح في علامة
القسم لاحقًا في شكل 3)
تسرد اسم الفئة والحالة الحالية ووقت البدء وتكرارات جميع الوظائف،
سواء كانت قيد التشغيل أو فاشلة أو مكتملة.
تفاصيل العمل
انقر على مهمة من القائمة لفتح لوحة تفاصيل العمل.
الذي يعرض معلومات مفصلة عن العامل، كما هو موضح في الشكل 1.
الشكل 1. لوحة تفاصيل العمل
الوصف: يسرد هذا القسم اسم فئة العامل، مع
الحزمة المؤهلة بالكامل، بالإضافة إلى العلامة المخصصة والمعرّف الفريد العالمي (UUID)
عامل.
التنفيذ: يعرض هذا القسم قيود العامل (إن توفّرت)، ووتيرة تنفيذه، وحالته، بالإضافة إلى الصف الذي أنشأ العامل ووضعه في "قائمة الانتظار".
WorkContinuation: يعرض هذا القسم مكان العامل في سلسلة العمل
. للاطّلاع على تفاصيل عامل آخر في سلسلة العمل، انقر على
معرّف UUID الخاص به.
النتائج: يعرِض هذا القسم وقت البدء وعدد عمليات إعادة المحاولة ومخرجات
بيانات العامل المحدّد.
إلغاء الموظفين
لإيقاف عامل حالي أو عامل في قائمة الانتظار، اختَر العامل وانقر على إلغاء العامل المحدّد
من شريط الأدوات.
عرض الرسم البياني
بما أنّه يمكن ربط العمال معًا، من المفيد أحيانًا تمثيل
تبعيات العمال في شكل رسم بياني.
للاطّلاع على تمثيل مرئي لسلسلة
العاملين، اختَر عاملاً من الجدول وانقر على عرض الرسم البياني من شريط الأدوات. يتمّ رسم العمال فقط في الرسم البياني.
الشكل 2. عرض الرسم البياني
يتيح لك الرسم البياني الاطّلاع سريعًا على العلاقات بين العاملين ومراقبة
تقدمهم في علاقات التسلسل المعقدة.
للرجوع إلى العرض على شكل قائمة، انقر على عرض القائمة.
عَرْض الوظائف والمنبّهات ومؤشرات التنشيط وفحصها
تتيح لك أداة فحص المهام في الخلفية أيضًا فحص مهام تطبيقك وعمليات التنبيه
وعمليات قفل التنشيط. يظهر كل نوع من المهام غير المتزامنة ضمن العنوان المناسب
في علامة التبويب "المدقق"، ما يتيح لك مراقبة حالتها ومقدار
تقدّمها بسهولة.
على غرار عناصر العمل، يمكنك اختيار "عمل" أو "إنذار" أو "قفل التنشيط" لفحص معلوماته التفصيلية في لوحة "تفاصيل المهام".
لعرض معلومات تفصيلية عن عامل أو وظيفة أو منبّه أو قفل تنشيط،
اختَره في لوحة تفاصيل المهام على يسار الصفحة.
الشكل 3. نافذة "أداة فحص المهام في الخلفية"
مصادر إضافية
لمعرفة المزيد حول Background Task Inspector (أداة فحص المهام في الخلفية)، راجع العناصر الإضافية التالية
الموارد:
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Debug your WorkManager workers with Background Task Inspector\n\nThe Background Task Inspector helps\nyou visualize, monitor, and debug your app's background workers when using\n[WorkManager library](/jetpack/androidx/releases/work) 2.5.0 or higher.\n\nGet started\n-----------\n\nTo list workers in the Background Task Inspector, do the following:\n\n1. [Run your app](/studio/run) on an emulator or connected device running API\n level 26 or higher.\n\n2. Select **View \\\u003e Tool Windows \\\u003e App Inspection** from the menu bar.\n\n3. Select the **Background Task Inspector** tab.\n\n4. Select the running app process from the menu.\n\n5. The workers in the currently running app appear in the **Background Task\n Inspector** pane. Click on the worker that you want to inspect further.\n\nView and inspect workers\n------------------------\n\nWhen you deploy an app using WorkManager 2.5.0 or higher on a device running\nAPI level 26 or higher, the **Background Task Inspector** tab shows active\nworkers. The **Background Task Inspector** (shown in a\n[later section](/studio/inspect/task#inspect-jobs-alarms-wakelocks) as figure 3)\nlists the class name, current status, start time, and retries of all jobs,\nwhether they are running, failed, or completed.\n\n### Work Details\n\nClick a job from the list to open the **Work Details** panel,\nwhich displays detailed information about the worker, as shown in figure 1.\n**Figure 1.** **Work Details** panel.\n\n- **Description**: This section lists the worker class name, with the fully qualified package, as well as the assigned tag and the UUID of the worker.\n- **Execution**: This section shows the worker's constraints (if any), running frequency, and state, as well as which class created and queued the worker.\n- **WorkContinuation**: This section displays where the worker is in the work chain. To check the details of another worker in the work chain, click its UUID.\n- **Results**: This section displays the start time, retry count, and the output data of the selected worker.\n\n### Cancel workers\n\nTo stop a currently running or enqueued worker, select the worker and click\n**Cancel Selected Worker**\nfrom the toolbar.\n\n### View Graph View\n\nBecause workers can be chained together, it's sometimes useful to visualize\nworker dependencies as a graph.\n\nTo see a visual representation of a worker\nchain, select a worker from the table and click **Show Graph View** from the toolbar. Only workers are drawn in the graph.\n**Figure 2.** Graph View.\n\nThe graph lets you quickly see relationships between workers and monitor\ntheir progress in complex chaining relationships.\n\nTo return to the list view, click **Show List View** .\n\nView and inspect Jobs, Alarms, and Wakelocks\n--------------------------------------------\n\nThe Background Task Inspector also lets you inspect your app's Jobs, Alarms,\nand Wakelocks. Each type of asynchronous task appears under the appropriate\nheading in the inspector tab, letting you easily monitor its status and\nprogress.\n\nSimilar to workers, you can select a Job, Alarm, or Wakelock to\ninspect its detailed information in the Task Details panel.\n\nTo view detailed information for a Worker, Job, Alarm, or Wakelock,\nselect it in the **Task Details** panel on the right.\n**Figure 3.** The Background Task Inspector window. **Note:** This functionality has been migrated from the **Energy profiler** . Use the **Background Task Inspector** to inspect all of your app's asynchronous tasks.\n\nAdditional resources\n--------------------\n\nTo learn more about the Background Task Inspector, see the following additional\nresources:\n\n### Documentation\n\n- [Schedule tasks with WorkManager](/topic/libraries/architecture/workmanager)\n\n### Codelabs\n\n- [Background work with WorkManager](https://developer.android.com/codelabs/android-workmanager)\n- [Advanced WorkManager](https://developer.android.com/codelabs/android-adv-workmanager)\n\n### Blog posts\n\n- [Background Task Inspector](https://medium.com/androiddevelopers/background-task-inspector-30c8706f0380)"]]
من شريط الأدوات.
من شريط الأدوات. يتمّ رسم العمال فقط في الرسم البياني.
.