Niestandardowa konfiguracja i inicjowanie menedżera WorkManager

Domyślnie WorkManager konfiguruje się automatycznie po uruchomieniu aplikacji, używając rozsądnych opcji, które są odpowiednie dla większości aplikacji. Jeśli potrzebujesz większej kontroli nad tym, jak WorkManager zarządza pracą i ją planuje, możesz dostosować konfigurację WorkManagera, inicjując go samodzielnie.

Inicjowanie na żądanie

Inicjowanie na żądanie umożliwia utworzenie WorkManagera tylko wtedy, gdy ten komponent jest potrzebny, a nie przy każdym uruchomieniu aplikacji. Dzięki temu WorkManager nie będzie znajdować się na krytycznej ścieżce uruchamiania, co poprawi wydajność uruchamiania aplikacji. Aby użyć inicjowania na żądanie:

Usuwanie domyślnego inicjatora

Aby podać własną konfigurację, musisz najpierw usunąć domyślny inicjator. Aby to zrobić, zaktualizuj AndroidManifest.xml za pomocą reguły scalania tools:node="remove".

Od wersji WorkManager 2.6 biblioteka App Startup jest używana wewnętrznie w WorkManagerze. Aby podać niestandardowy inicjator, musisz usunąć węzeł androidx.startup.

Jeśli nie używasz biblioteki App Startup w aplikacji, możesz ją całkowicie usunąć.

 <!-- If you want to disable android.startup completely. -->
 <provider
    android:name="androidx.startup.InitializationProvider"
    android:authorities="${applicationId}.androidx-startup"
    tools:node="remove">
 </provider>

W przeciwnym razie usuń tylko węzeł 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>

Jeśli używasz wersji WorkManager starszej niż 2.6, usuń workmanager-init:

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

Więcej informacji o używaniu reguł scalania w pliku manifestu znajdziesz w dokumentacji dotyczącej scalania wielu plików manifestu.

Implementacja Configuration.Provider

Zaimplementuj interfejs Configuration.Provider w klasie Application i podaj własną implementację metody Configuration.Provider.getWorkManagerConfiguration. Jeśli musisz użyć WorkManagera, wywołaj metodę WorkManager.getInstance(Context). WorkManager wywołuje niestandardową metodę getWorkManagerConfiguration aplikacji, aby wykryć jej Configuration. Nie musisz dzwonić do firmy WorkManager.initialize.

Oto przykład niestandardowej implementacji getWorkManagerConfiguration():

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();
    }
}

Niestandardowa inicjalizacja przed WorkManagerem 2.1.0

W przypadku wersji WorkManagera starszych niż 2.1.0 dostępne są 2 opcje inicjowania. W większości przypadków wystarczy domyślna inicjalizacja. Aby uzyskać dokładniejszą kontrolę nad biblioteką WorkManager, możesz określić własną konfigurację.

Inicjowanie domyślne

WorkManager używa niestandardowego elementu ContentProvider do inicjowania się podczas uruchamiania aplikacji. Ten kod znajduje się w klasie wewnętrznej androidx.work.impl.WorkManagerInitializer i używa domyślnego Configuration. Domyślny inicjator jest używany automatycznie, chyba że wyraźnie go wyłączysz. Domyślny inicjator jest odpowiedni dla większości aplikacji.

Inicjowanie niestandardowe

Jeśli chcesz kontrolować proces inicjowania, musisz wyłączyć domyślny inicjator, a następnie zdefiniować własną konfigurację niestandardową.

Po usunięciu domyślnego inicjatora możesz ręcznie zainicjować WorkManager:

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);

Upewnij się, że inicjowanie obiektu pojedynczego WorkManager jest uruchamiane w Application.onCreate() lub w ContentProvider.onCreate().

Pełną listę dostępnych opcji dostosowywania znajdziesz w dokumentacji referencyjnej Configuration.Builder().