Standardmäßig konfiguriert sich WorkManager beim Start der App automatisch mit geeigneten Optionen, die für die meisten Apps geeignet sind. Wenn du mehr Kontrolle darüber benötigst, wie WorkManager die Arbeit verwaltet und plant, kannst du die WorkManager-Konfiguration anpassen, indem du WorkManager selbst initialisierst.
On-Demand-Initialisierung
Mit der On-Demand-Initialisierung können Sie WorkManager nur dann erstellen, wenn diese Komponente benötigt wird, und nicht bei jedem Start der App. Dadurch wird WorkManager aus dem kritischen Startpfad entfernt, was die Startleistung der App verbessert. So verwenden Sie die On-Demand-Initialisierung:
Standard-Initialisierer entfernen
Wenn Sie eine eigene Konfiguration bereitstellen möchten, müssen Sie zuerst den Standard-Initialisierer entfernen. Aktualisieren Sie dazu AndroidManifest.xml mit der Zusammenführungsregel tools:node="remove".
Seit WorkManager 2.6 wird App Startup intern in WorkManager verwendet.
Wenn Sie einen benutzerdefinierten Initialisierer bereitstellen möchten, müssen Sie den Knoten androidx.startup entfernen.
Wenn Sie App Startup in Ihrer App nicht verwenden, können Sie es vollständig entfernen.
<!-- If you want to disable android.startup completely. -->
<provider
android:name="androidx.startup.InitializationProvider"
android:authorities="${applicationId}.androidx-startup"
tools:node="remove">
</provider>
Andernfalls entfernen Sie nur den Knoten WorkManagerInitializer.
<provider
android:name="androidx.startup.InitializationProvider"
android:authorities="${applicationId}.androidx-startup"
android:exported="false"
tools:node="merge">
<!-- If you are using androidx.startup to initialize other components -->
<meta-data
android:name="androidx.work.WorkManagerInitializer"
android:value="androidx.startup"
tools:node="remove" />
</provider>
Wenn Sie eine WorkManager-Version vor 2.6 verwenden, entfernen Sie stattdessen workmanager-init:
<provider
android:name="androidx.work.impl.WorkManagerInitializer"
android:authorities="${applicationId}.workmanager-init"
tools:node="remove" />
Weitere Informationen zur Verwendung von Zusammenführungsregeln in Ihrem Manifest finden Sie in der Dokumentation zum Zusammenführen mehrerer Manifestdateien.
Configuration.Provider implementieren
Lassen Sie Ihre Application-Klasse die Schnittstelle Configuration.Provider implementieren und stellen Sie Ihre eigene Implementierung von Configuration.Provider.getWorkManagerConfiguration bereit. Wenn Sie WorkManager verwenden müssen, rufen Sie die Methode WorkManager.getInstance(Context) auf. WorkManager ruft die benutzerdefinierte getWorkManagerConfiguration-Methode Ihrer App auf, um die Configuration zu ermitteln. Sie müssen WorkManager.initialize nicht selbst aufrufen.
Hier ein Beispiel für eine benutzerdefinierte getWorkManagerConfiguration()-Implementierung:
Kotlin
class MyApplication() : Application(), Configuration.Provider {
override fun getWorkManagerConfiguration() =
Configuration.Builder()
.setMinimumLoggingLevel(android.util.Log.INFO)
.build()
}
Java
class MyApplication extends Application implements Configuration.Provider {
@Override
public Configuration getWorkManagerConfiguration() {
return new Configuration.Builder()
.setMinimumLoggingLevel(android.util.Log.INFO)
.build();
}
}
Benutzerdefinierte Initialisierung vor WorkManager 2.1.0
Für WorkManager-Versionen vor Version 2.1.0 gibt es zwei Initialisierungsoptionen. In den meisten Fällen reicht die Standardinitialisierung aus. Wenn Sie WorkManager genauer steuern möchten, können Sie eine eigene Konfiguration angeben.
Standardinitialisierung
WorkManager verwendet einen benutzerdefinierten ContentProvider, um sich beim Start der App zu initialisieren. Dieser Code befindet sich in der internen Klasse androidx.work.impl.WorkManagerInitializer und verwendet die Standard-Configuration. Der Standard-Initializer wird automatisch verwendet, sofern Sie ihn nicht explizit deaktivieren. Der Standard-Initialisierer ist für die meisten Apps geeignet.
Benutzerdefinierte Initialisierung
Wenn Sie den Initialisierungsprozess steuern möchten, müssen Sie den Standard-Initializer deaktivieren und dann eine eigene benutzerdefinierte Konfiguration definieren.
Nachdem der Standard-Initializer entfernt wurde, können Sie WorkManager manuell initialisieren:
Kotlin
// provide custom configuration
val myConfig = Configuration.Builder()
.setMinimumLoggingLevel(android.util.Log.INFO)
.build()
// initialize WorkManager
WorkManager.initialize(this, myConfig)
Java
// provide custom configuration
Configuration myConfig = new Configuration.Builder()
.setMinimumLoggingLevel(android.util.Log.INFO)
.build();
//initialize WorkManager
WorkManager.initialize(this, myConfig);
Die Initialisierung des WorkManager-Singletons muss entweder in Application.onCreate() oder in einem ContentProvider.onCreate() ausgeführt werden.
Eine vollständige Liste der verfügbaren Anpassungen finden Sie in der Referenzdokumentation zu Configuration.Builder().