إذا لاحظت أنّ العاملين لديك يعملون بشكل كبير جدًا أو لا يعمل على الإطلاق، إليك بعض خطوات لتصحيح الأخطاء يمكن أن تساعدك في اكتشاف ما يحدث.
تمكين التسجيل
لتحديد سبب عدم عمل العمال بشكل صحيح، قد يكون من المفيد جدًا راجِع سجلات verbose WorkManager. لتمكين التسجيل، استخدم الأولية.
أولاً، أوقِف خيار "WorkManagerInitializer
" التلقائي في AndroidManifest.xml
من خلال إنشاء موفّر WorkManager جديد باستخدام تم تطبيق قاعدة دمج البيان remove
:
<provider android:name="androidx.work.impl.WorkManagerInitializer" android:authorities="${applicationId}.workmanager-init" tools:node="remove"/>
الآن وبعد أن تم إيقاف مهيئ WorkManager الافتراضي، يمكنك استخدام الخيار عند الطلب الأولية. لإجراء ذلك، يجب أن توفّر الفئة android.app.Application
طريقة تنفيذ. لـ androidx.work.Configuration.Provider
:
Kotlin
class MyApplication() : Application(), Configuration.Provider { override fun getWorkManagerConfiguration() = Configuration.Builder() .setMinimumLoggingLevel(android.util.Log.DEBUG) .build() }
Java
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
عند تفعيل تسجيل DEBUG
، يمكنك ترى الكثير من السجلات باستخدام بادئة علامة السجل WM-
.
استخدام أداة جدولة المهام في adb Shell dumpsys
يمكنك استخدام adb
للحصول على مزيد من المعلومات حول جدولة المهام في Android 6.0. (المستوى 23 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث إذا كنت مستخدمًا جديدًا لـ 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
في المستوى 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 ...