Wenn Sie feststellen, dass Ihre Worker zu oft oder überhaupt nicht ausgeführt werden, können Sie mit den folgenden Schritten zur Fehlerbehebung herausfinden, was passiert.
Protokollierung aktivieren
Anhand der ausführlichen WorkManager-Logs können Sie feststellen, warum Ihre Worker nicht ordnungsgemäß ausgeführt werden. Verwenden Sie die benutzerdefinierte Initialisierung, um das Logging zu aktivieren.
Deaktivieren Sie zuerst die standardmäßige WorkManagerInitializer
in der Datei AndroidManifest.xml
. Erstellen Sie dazu einen neuen WorkManager-Anbieter mit der Regel für die Zusammenführung von Manifesten remove
:
<provider
android:name="androidx.work.impl.WorkManagerInitializer"
android:authorities="${applicationId}.workmanager-init"
tools:node="remove"/>
Nachdem der standardmäßige WorkManager-Initialisierer deaktiviert ist, können Sie die On-Demand-Initialisierung verwenden.
Dazu muss die Klasse android.app.Application
eine Implementierung für androidx.work.Configuration.Provider
bereitstellen:
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(); } }
Wenn Sie eine benutzerdefinierte WorkManager-Konfiguration definieren, wird der WorkManager beim Aufrufen von WorkManager.getInstance(Context)
anstatt automatisch beim Start der Anwendung initialisiert. Weitere Informationen, einschließlich Unterstützung von WorkManager-Versionen vor 2.1.0, finden Sie unter Benutzerdefinierte WorkManager-Konfiguration und Initialisierung.
Wenn das DEBUG
-Logging aktiviert ist, sehen Sie viel mehr Logs mit dem Log-Tag-Präfix WM-
.
ADB Shell-Dumpsys-Jobplaner verwenden
Unter Android 6.0 (API-Level 23) und höher können Sie adb
verwenden, um weitere Informationen zur Jobplanung unter Android 6.0 (API-Level 23) abzurufen. Wenn Sie mit adb
noch nicht vertraut sind, finden Sie unter Befehlszeilentools weitere Informationen.
Nachdem Sie adb
installiert haben, führen Sie den folgenden Befehl aus, um sich die Liste der Jobs anzusehen, die dem Paket zugeordnet sind:
adb shell dumpsys jobscheduler
Die Ausgabe sieht in etwa so aus:
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)
Bei Verwendung von WorkManager ist die für die Verwaltung der Worker-Ausführung zuständige Komponente SystemJobService
auf API-Ebene 23 oder höher. Suchen Sie nach Instanzen von Jobs, die Ihrem Paketnamen und androidx.work.impl.background.systemjob.SystemJobService
zugeordnet sind.
Für jeden Job werden in der Ausgabe des Befehls die Einschränkungen required, zufrieden und unzufrieden aufgelistet. Prüfen Sie, ob die Einschränkungen des Workers vollständig erfüllt sind.
Die Ausgabe enthält auch den Jobverlauf für kürzlich ausgeführte Jobs, sodass Sie damit prüfen können, ob SystemJobService
kürzlich aufgerufen wurde.
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
Diagnosedaten von WorkManager 2.4.0 oder höher anfordern
Bei Debug-Builds Ihrer Anwendung können Sie mit dem folgenden Befehl Diagnoseinformationen von WorkManager 2.4.0 und höher anfordern:
adb shell am broadcast -a "androidx.work.diagnostics.REQUEST_DIAGNOSTICS" -p "<your_app_package_name>"
Hier finden Sie Informationen zu folgenden Themen:
- Arbeitsanfragen, die in den letzten 24 Stunden abgeschlossen wurden.
- Derzeit ausgeführte Arbeitsanfragen.
- Geplante Arbeitsanfragen.
So könnte es aussehen (die Ausgabe ist über logcat
sichtbar):
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
...