Özel WorkManager Yapılandırması ve Başlatma

WorkManager, varsayılan olarak uygulamanız başlatıldığında çoğu uygulama için uygun olan makul seçenekleri kullanarak kendini otomatik olarak yapılandırır. WorkManager'ın işleri nasıl yönettiği ve planladığı konusunda daha fazla kontrole ihtiyacınız varsa WorkManager'ı kendiniz başlatarak WorkManager yapılandırmasını özelleştirebilirsiniz.

İsteğe Bağlı Başlatma

İsteğe bağlı başlatma, WorkManager'ı uygulamanın her başlatılışında değil, yalnızca ilgili bileşene ihtiyaç duyulduğunda oluşturmanıza olanak tanır. Böylece WorkManager, kritik başlatma yolunuzdan çıkarılır ve uygulama başlatma performansı artar. İsteğe bağlı başlatmayı kullanmak için:

Varsayılan başlatıcıyı kaldırma

Kendi yapılandırmanızı sağlamak için önce varsayılan başlatıcıyı kaldırmanız gerekir. Bunun için birleştirme kuralını tools:node="remove" kullanarak AndroidManifest.xml öğesini güncelleyin.

WorkManager 2.6'dan itibaren App Startup, WorkManager'da dahili olarak kullanılır. Özel bir başlatıcı sağlamak için androidx.startup düğümünü kaldırmanız gerekir.

Uygulamanızda App Startup'ı kullanmıyorsanız tamamen kaldırabilirsiniz.

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

Aksi takdirde yalnızca WorkManagerInitializer düğümünü kaldırın.

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

WorkManager'ın 2.6'dan eski bir sürümünü kullanırken bunun yerine workmanager-init öğesini kaldırın:

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

Manifestinizde birleştirme kurallarını kullanma hakkında daha fazla bilgi edinmek için birden çok manifest dosyasını birleştirme ile ilgili belgelere bakın.

Configuration.Provider'ı uygulama

Application sınıfınızın Configuration.Provider arayüzünü uygulamasını sağlayın ve kendi Configuration.Provider.getWorkManagerConfiguration uygulamanızı sağlayın. WorkManager'ı kullanmanız gerektiğinde WorkManager.getInstance(Context) yöntemini çağırdığınızdan emin olun. WorkManager, uygulamanızın Configuration değerini bulmak için uygulamanızın özel getWorkManagerConfiguration yöntemini çağırır. WorkManager.initialize adlı işletmeyi kendiniz aramanız gerekmez.

Özel getWorkManagerConfiguration() uygulamasına bir örnek:

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

WorkManager 2.1.0'dan önce özel başlatma

WorkManager'ın 2.1.0 sürümünden önceki sürümleri için iki başlatma seçeneği vardır. Çoğu durumda varsayılan başlatma yeterlidir. WorkManager'ı daha hassas bir şekilde kontrol etmek için kendi yapılandırmanızı belirtebilirsiniz.

Varsayılan başlatma

WorkManager, uygulamanız başlatıldığında kendini başlatmak için özel bir ContentProvider kullanır. Bu kod, dahili androidx.work.impl.WorkManagerInitializer sınıfında bulunur ve varsayılan Configuration'yi kullanır. Açıkça devre dışı bırakmadığınız sürece varsayılan başlatıcı otomatik olarak kullanılır. Varsayılan başlatıcı çoğu uygulama için uygundur.

Özel başlatma

Başlatma sürecini kontrol etmek istiyorsanız varsayılan başlatıcıyı devre dışı bırakmanız ve ardından kendi özel yapılandırmanızı tanımlamanız gerekir.

Varsayılan başlatıcı kaldırıldıktan sonra WorkManager'ı manuel olarak başlatabilirsiniz:

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

WorkManager singleton'ının başlatma işleminin Application.onCreate() veya ContentProvider.onCreate() içinde çalıştığından emin olun.

Kullanılabilir özelleştirmelerin tam listesi için Configuration.Builder() referans belgelerine bakın.