WorkManager-Fehler beheben

Wenn Sie feststellen, dass Ihre Worker zu oft oder gar nicht ausgeführt werden, finden Sie hier einige die Ihnen helfen können, das Problem zu erkennen.

Protokollierung aktivieren

Um festzustellen, warum Ihre Worker nicht ordnungsgemäß ausgeführt werden, kann es hilfreich sein, ausführliche WorkManager-Protokolle ansehen Verwenden Sie zum Aktivieren der Protokollierung die Option Benutzerdefiniert Initialisierung

Deaktivieren Sie zuerst die Standard-WorkManagerInitializer in Ihrem AndroidManifest.xml-Datei, indem Sie einen neuen WorkManager-Anbieter mit der Die Regel für die Manifestzusammenführung remove wurde angewendet:

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

Da der WorkManager-Standardinitialisierer jetzt deaktiviert ist, können Sie On-Demand- Initialisierung Dazu muss die Klasse android.app.Application eine Implementierung bereitstellen, für 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();
    }
}

Wenn du eine benutzerdefinierte WorkManager-Konfiguration definierst, wird dein WorkManager initialisiert wird, wenn Sie WorkManager.getInstance(Context) anstatt beim Start der Anwendung. Siehe Custom WorkManager Konfiguration und Initialisierung finden Sie weitere Informationen, einschließlich der Unterstützung von WorkManager-Versionen vor 2.1.0

Wenn das DEBUG-Logging aktiviert ist, deutlich mehr Logs mit dem Log-Tag-Präfix WM- angezeigt.

ADB Shell-Dumpsys-Jobplaner verwenden

Mithilfe von adb können Sie weitere Informationen zur Auftragsplanung unter Android 6.0 abrufen. (API-Level 23) oder höher. Wenn Sie neu bei adb sind, lesen Sie den Abschnitt Befehlszeile finden Sie weitere Informationen.

Nachdem Sie adb installiert haben, führen Sie den folgenden Befehl aus, um die Liste der Jobs, die Ihrem 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: Komponente für die Verwaltung der Worker-Ausführung ist SystemJobService auf API-Level 23 oder höher. Nach Instanzen von Jobs suchen die Ihrem Paketnamen zugeordnet sind, androidx.work.impl.background.systemjob.SystemJobService

Für jeden Job listet die Ausgabe der Befehle required, allowed, und unerfüllte Einschränkungen. Prüfen Sie, ob die Einschränkungen des Workers voll und ganz zufrieden sind.

Die Ausgabe enthält auch den Jobverlauf für kürzlich ausgeführte Jobs, sodass Sie Damit wird geprüft, 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

Diagnoseinformationen von WorkManager 2.4.0+ anfordern

Bei Debugging-Builds Ihrer App können Sie Diagnoseinformationen hier anfordern: WorkManager 2.4.0 und höher mit dem folgenden Befehl:

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

Sie erhalten Informationen zu folgenden Themen:

  • Arbeitsanfragen, die in den letzten 24 Stunden abgeschlossen wurden.
  • Derzeit ausgeführte Arbeitsanfragen.
  • Geplante Arbeitsanfragen.

Das könnte so 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
...