کارگران WorkManager خود را با Background Task Inspector اشکال زدایی کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Background Task Inspector به شما کمک می کند تا هنگام استفاده از WorkManager library 2.5.0 یا بالاتر، کارگران پس زمینه برنامه خود را تجسم، نظارت و اشکال زدایی کنید.
شروع کنید
برای فهرست کردن کارگران در Background Task Inspector، موارد زیر را انجام دهید:
View > Tool Windows > App Inspection را از نوار منو انتخاب کنید.
تب Background Task Inspector را انتخاب کنید.
فرآیند اجرای برنامه را از منو انتخاب کنید.
کارگران در برنامه فعلی در حال اجرا در صفحه Background Task Inspector ظاهر می شوند. روی کارگری که می خواهید بیشتر بازرسی کنید کلیک کنید.
کارگران را مشاهده و بازرسی کنید
وقتی برنامه‌ای را با استفاده از WorkManager 2.5.0 یا بالاتر روی دستگاهی با API سطح 26 یا بالاتر اجرا می‌کنید، برگه Background Task Inspector کارگران فعال را نشان می‌دهد. Background Task Inspector (در بخش بعدی به عنوان شکل 3 نشان داده شده است) نام کلاس، وضعیت فعلی، زمان شروع، و تلاش های مجدد همه کارها را، چه در حال اجرا، چه ناموفق یا تکمیل شده، فهرست می کند.
جزئیات کار
روی یک کار از لیست کلیک کنید تا پانل جزئیات کار باز شود، که اطلاعات دقیق مربوط به کارگر را مانند شکل 1 نشان می دهد.
شکل 1. پانل جزئیات کار .
توضیحات : این بخش نام کلاس کارگر را همراه با بسته کاملاً واجد شرایط و همچنین برچسب اختصاص داده شده و UUID کارگر فهرست می کند.
Execution : این بخش محدودیت های کارگر (در صورت وجود)، فرکانس در حال اجرا و وضعیت را نشان می دهد و همچنین اینکه کدام کلاس کارگر را ایجاد کرده و در صف قرار داده است.
WorkContinuation : این بخش جایی که کارگر در زنجیره کار است را نشان می دهد. برای بررسی جزئیات کارگر دیگری در زنجیره کاری، روی UUID آن کلیک کنید.
نتایج : این بخش زمان شروع، تعداد تلاش مجدد و داده های خروجی کارگر انتخاب شده را نمایش می دهد.
کارگران را لغو کنید
برای متوقف کردن یک کارگر در حال اجرا یا در نوبت، کارگر را انتخاب کنید و روی Cancel Selected Worker کلیک کنیداز نوار ابزار
مشاهده نمودار
از آنجایی که کارگران می توانند به هم زنجیر شوند، گاهی اوقات تجسم وابستگی کارگران به عنوان یک نمودار مفید است.
برای مشاهده نمایش تصویری یک زنجیره کارگر، یک کارگر را از جدول انتخاب کنید و روی Show Graph View کلیک کنید از نوار ابزار فقط کارگران در نمودار رسم می شوند.
شکل 2. نمای نمودار.
این نمودار به شما امکان می دهد به سرعت روابط بین کارگران را مشاهده کنید و پیشرفت آنها را در روابط زنجیره ای پیچیده نظارت کنید.
برای بازگشت به نمای لیست، روی Show List View کلیک کنید .
Jobs، Alarms و Wakelocks را مشاهده و بررسی کنید
Background Task Inspector همچنین به شما امکان می دهد تا Jobs، Alarms و Wakelocks برنامه خود را بررسی کنید. هر نوع کار ناهمزمان تحت عنوان مناسب در برگه بازرس ظاهر می شود و به شما امکان می دهد وضعیت و پیشرفت آن را به راحتی نظارت کنید.
مشابه کارگران، می‌توانید یک Job، Alarm یا Wakelock را انتخاب کنید تا اطلاعات دقیق آن را در پانل Task Details بررسی کنید.
برای مشاهده اطلاعات دقیق برای Worker، Job، Alarm یا Wakelock، آن را در پانل Task Details در سمت راست انتخاب کنید.
شکل 3. پنجره Background Task Inspector.
منابع اضافی
برای کسب اطلاعات بیشتر در مورد Background Task Inspector، به منابع اضافی زیر مراجعه کنید:
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-29 بهوقت ساعت هماهنگ جهانی."],[],[],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)"]]
از نوار ابزار
از نوار ابزار فقط کارگران در نمودار رسم می شوند. 
.