اشکال زدایی WorkManager

اگر متوجه شدید که کارگران شما اغلب کار می‌کنند یا اصلاً کار نمی‌کنند، در اینجا چند مرحله اشکال‌زدایی وجود دارد که می‌تواند به شما در کشف آنچه در حال وقوع است کمک کند.

ورود به سیستم را فعال کنید

برای تعیین اینکه چرا کارگران شما به درستی کار نمی کنند، دیدن گزارش های پرمخاطب WorkManager می تواند بسیار مفید باشد. برای فعال کردن ورود به سیستم، از مقداردهی اولیه استفاده کنید.

ابتدا، WorkManagerInitializer پیش‌فرض را در فایل AndroidManifest.xml خود با ایجاد یک ارائه‌دهنده WorkManager جدید با اعمال قانون manifest-merge remove غیرفعال کنید:

<provider
    android:name="androidx.work.impl.WorkManagerInitializer"
    android:authorities="${applicationId}.workmanager-init"
    tools:node="remove"/>

اکنون که راه‌اندازی اولیه WorkManager پیش‌فرض غیرفعال است، می‌توانید از مقداردهی اولیه برحسب تقاضا استفاده کنید. برای انجام این کار، کلاس android.app.Application باید یک پیاده سازی برای androidx.work.Configuration.Provider ارائه کند:

کاتلین 

class MyApplication() : Application(), Configuration.Provider {
    override fun getWorkManagerConfiguration() =
        Configuration.Builder()
            .setMinimumLoggingLevel(android.util.Log.DEBUG)
            .build()
}

جاوا 

public class MyApplication extends Application implements Configuration.Provider {
    @NonNull
    @Override
    public Configuration getWorkManagerConfiguration() {
        return new Configuration.Builder()
                .setMinimumLoggingLevel(android.util.Log.DEBUG)
                .build();
    }
}

هنگامی که پیکربندی WorkManager سفارشی را تعریف می کنید، WorkManager شما با فراخوانی WorkManager.getInstance(Context) به جای اینکه به طور خودکار هنگام راه اندازی برنامه کاربردی باشد، مقداردهی اولیه می شود. برای اطلاعات بیشتر، از جمله پشتیبانی از نسخه‌های WorkManager قبل از 2.1.0، به پیکربندی و راه‌اندازی Custom WorkManager مراجعه کنید.

با فعال کردن DEBUG logging، گزارش های بسیار بیشتری را با پیشوند log-tag WM- می بینید.

از adb shell dumpsys jobscheduler استفاده کنید

می‌توانید از adb برای دریافت اطلاعات بیشتر در مورد زمان‌بندی کار در Android نسخه ۶.۰ (سطح API ۲۳) یا بالاتر استفاده کنید. اگر تازه وارد adb هستید، برای جزئیات بیشتر به ابزارهای خط فرمان مراجعه کنید.

هنگامی که adb را نصب کردید، دستور زیر را اجرا کنید تا به لیست کارهایی که به بسته شما نسبت داده می شود نگاه کنید:

adb shell dumpsys jobscheduler

خروجی چیزی شبیه به این است:

JOB #u0a172/4: 6412553 com.google.android.youtube/androidx.work.impl.background.systemjob.SystemJobService
  u0a172 tag=*job*/com.google.android.youtube/androidx.work.impl.background.systemjob.SystemJobService
  Source: uid=u0a172 user=0 pkg=com.google.android.youtube
  JobInfo:
    Service: com.google.android.youtube/androidx.work.impl.background.systemjob.SystemJobService
    Requires: charging=false batteryNotLow=false deviceIdle=false
    Extras: mParcelledData.dataSize=180
    Network type: NetworkRequest [ NONE id=0, [ Capabilities: NOT_METERED&INTERNET&NOT_RESTRICTED&TRUSTED&VALIDATED Uid: 10172] ]
    Minimum latency: +1h29m59s687ms
    Backoff: policy=1 initial=+30s0ms
    Has early constraint
  Required constraints: TIMING_DELAY CONNECTIVITY [0x90000000]
  Satisfied constraints: DEVICE_NOT_DOZING BACKGROUND_NOT_RESTRICTED WITHIN_QUOTA [0x3400000]
  Unsatisfied constraints: TIMING_DELAY CONNECTIVITY [0x90000000]
  Tracking: CONNECTIVITY TIME QUOTA
  Implicit constraints:
    readyNotDozing: true
    readyNotRestrictedInBg: true
  Standby bucket: RARE
  Base heartbeat: 0
  Enqueue time: -51m29s853ms
  Run time: earliest=+38m29s834ms, latest=none, original latest=none
  Last run heartbeat: 0
  Ready: false (job=false user=true !pending=true !active=true !backingup=true comp=true)

هنگام استفاده از WorkManager، مؤلفه ای که مسئول مدیریت اجرای کارگر است SystemJobService در سطح API 23 یا بالاتر است. به دنبال مواردی از کارهایی باشید که به نام بسته و androidx.work.impl.background.systemjob.SystemJobService شما نسبت داده می شوند.

برای هر کار، خروجی از لیست دستورات، محدودیت‌های راضی و ناراضی مورد نیاز است . بررسی کنید که آیا محدودیت های کارگر شما به طور کامل برآورده شده است یا خیر.

خروجی همچنین شامل سابقه کار برای کارهای اخیراً اجرا شده است، بنابراین می توانید از آن برای بررسی اینکه آیا SystemJobService اخیراً فراخوانی شده است یا خیر استفاده کنید.

Job history:
     -1h35m26s440ms   START: #u0a107/9008 com.google.android.youtube/androidx.work.impl.background.systemjob.SystemJobService
     -1h35m26s362ms  STOP-P: #u0a107/9008 com.google.android.youtube/androidx.work.impl.background.systemjob.SystemJobService app called jobFinished

اطلاعات تشخیصی را از WorkManager 2.4.0+ درخواست کنید

در ساخت‌های اشکال‌زدایی برنامه خود، می‌توانید با استفاده از دستور زیر اطلاعات عیب‌یابی را از WorkManager 2.4.0 و بالاتر درخواست کنید:

adb shell am broadcast -a "androidx.work.diagnostics.REQUEST_DIAGNOSTICS" -p "<your_app_package_name>"

این اطلاعات در مورد:

  • درخواست های کاری که در 24 ساعت گذشته تکمیل شده اند.
  • درخواست های کاری که در حال حاضر در حال اجرا هستند.
  • درخواست های کاری که برنامه ریزی شده است.

در اینجا می تواند به نظر برسد (خروجی از طریق logcat قابل مشاهده است):

adb shell am broadcast -a "androidx.work.diagnostics.REQUEST_DIAGNOSTICS" -p "androidx.work.integration.testapp"

adb logcat
...
2020-02-13 14:21:37.990 29528-29660/androidx.work.integration.testapp I/WM-DiagnosticsWrkr: Recently completed work:
2020-02-13 14:21:38.083 29528-29660/androidx.work.integration.testapp I/WM-DiagnosticsWrkr: Id  Class Name   State  Unique Name Tags
    08be261c-2def-4bd6-a716-1e4410968dc4     androidx.work.impl.workers.DiagnosticsWorker    SUCCEEDED  null    androidx.work.impl.workers.DiagnosticsWorker
    48ce04f1-8df9-450b-96ec-6eceabb9c690     androidx.work.impl.workers.DiagnosticsWorker    SUCCEEDED  null    androidx.work.impl.workers.DiagnosticsWorker
    c46f4699-c384-440c-a10e-26d56ce02963     androidx.work.impl.workers.DiagnosticsWorker    SUCCEEDED  null    androidx.work.impl.workers.DiagnosticsWorker
    ce125372-046e-484e-949f-9abb35ce62c3     androidx.work.impl.workers.DiagnosticsWorker    SUCCEEDED  null    androidx.work.impl.workers.DiagnosticsWorker
    72887ddd-8ed1-4018-b798-fac218e95e16     androidx.work.impl.workers.DiagnosticsWorker    SUCCEEDED  null    androidx.work.impl.workers.DiagnosticsWorker
    dcff3d61-320d-4996-8644-5d97944bd09c     androidx.work.impl.workers.DiagnosticsWorker    SUCCEEDED  null    androidx.work.impl.workers.DiagnosticsWorker
    acab0bf7-6087-43ad-bdb5-be0df9195acb     androidx.work.impl.workers.DiagnosticsWorker    SUCCEEDED  null    androidx.work.impl.workers.DiagnosticsWorker
    23136bcd-01dd-46eb-b910-0fe8a140c2a4     androidx.work.integration.testapp.ToastWorker   SUCCEEDED  null    androidx.work.integration.testapp.ToastWorker
    245f4879-c6d2-4997-8130-e4e90e1cab4c     androidx.work.integration.testapp.ToastWorker   SUCCEEDED  null    androidx.work.integration.testapp.ToastWorker
    17d05835-bb61-429a-ad11-fe43fc320a54     androidx.work.integration.testapp.ToastWorker   SUCCEEDED  null    androidx.work.integration.testapp.ToastWorker
    e95f12be-4b0c-4e64-88da-8ee07a31e42f     androidx.work.integration.testapp.ToastWorker   SUCCEEDED  null    androidx.work.integration.testapp.ToastWorker
    431c3ec2-4a55-469b-b50b-4072d35f1232     androidx.work.integration.testapp.ToastWorker   SUCCEEDED  null    androidx.work.integration.testapp.ToastWorker
    883a388f-f911-4098-9143-37bd8fbc098a     androidx.work.integration.testapp.ToastWorker   SUCCEEDED  null    androidx.work.integration.testapp.ToastWorker
    b904163c-6822-4299-8d5a-78df49b7e53d     androidx.work.integration.testapp.ToastWorker   SUCCEEDED  null    androidx.work.integration.testapp.ToastWorker
    453fd7b9-2b16-45b9-abc5-3d2ce7b6a4ba     androidx.work.integration.testapp.ToastWorker   SUCCEEDED  null    androidx.work.integration.testapp.ToastWorker
2020-02-13 14:21:38.083 29528-29660/androidx.work.integration.testapp I/WM-DiagnosticsWrkr: Running work:
2020-02-13 14:21:38.089 29528-29660/androidx.work.integration.testapp I/WM-DiagnosticsWrkr: Id  Class Name   State  Unique Name Tags
    b87c8a4f-4ac6-4e25-ba3e-4cea53ce468a     androidx.work.impl.workers.DiagnosticsWorker    RUNNING    null    androidx.work.impl.workers.DiagnosticsWorker
...