WorkManager, Kotlin kullanıcıları için eş yordamlara yönelik yerleşik destek sunar. Başlamak için work-runtime-ktx öğesini Gradle dosyanıza ekleyin. Worker sınıfını genişletmek yerine, doWork sınıfının askıya alma sürümüne sahip olan CoroutineWorker sınıfını genişletin. Örneğin, ağ işlemleri gerçekleştiren basit bir CoroutineWorker oluşturmak için aşağıdakileri yapın:
class CoroutineDownloadWorker(
context: Context,
params: WorkerParameters
) : CoroutineWorker(context, params) {
override suspend fun doWork(): Result {
val data = downloadSynchronously("https://www.google.com")
saveData(data)
return Result.success()
}
}
CoroutineWorker.doWork() işlevinin askıya alma işlevi olduğunu unutmayın. Worker aksine bu kod, Configuration içinde belirtilen Executor üzerinde çalışmaz. Bunun yerine varsayılan olarak Dispatchers.Default kullanılır. Kendi CoroutineContext değerinizi sağlayarak bunu özelleştirebilirsiniz. Önceki örnekte, bu çalışmayı Dispatchers.IO üzerinde aşağıdaki gibi yapmak isteyebilirsiniz:
class CoroutineDownloadWorker(
context: Context,
params: WorkerParameters
) : CoroutineWorker(context, params) {
override suspend fun doWork(): Result {
withContext(Dispatchers.IO) {
val data = downloadSynchronously("https://www.google.com")
saveData(data)
return Result.success()
}
}
}
CoroutineWorker, eş yordamı iptal ederek ve iptal sinyallerini yayarak duraklamaları otomatik olarak yönetir. İş durdurma durumlarını yönetmek için özel bir işlem yapmanız gerekmez.
Farklı bir işlemde CoroutineWorker çalıştırma
Ayrıca, ListenableWorker'ün bir uygulaması olan RemoteCoroutineWorker'yi kullanarak bir çalışanı belirli bir işleme bağlayabilirsiniz.
RemoteCoroutineWorker, iş isteğini oluştururken giriş verilerinin bir parçası olarak sağladığınız iki ek bağımsız değişkenle belirli bir işleme bağlanır: ARGUMENT_CLASS_NAME ve ARGUMENT_PACKAGE_NAME.
Aşağıdaki örnekte, belirli bir sürece bağlı bir iş isteğinin nasıl oluşturulacağı gösterilmektedir:
Kotlin
val PACKAGE_NAME = "com.example.background.multiprocess"
val serviceName = RemoteWorkerService::class.java.name
val componentName = ComponentName(PACKAGE_NAME, serviceName)
val data: Data = Data.Builder()
.putString(ARGUMENT_PACKAGE_NAME, componentName.packageName)
.putString(ARGUMENT_CLASS_NAME, componentName.className)
.build()
return OneTimeWorkRequest.Builder(ExampleRemoteCoroutineWorker::class.java)
.setInputData(data)
.build()
Java
String PACKAGE_NAME = "com.example.background.multiprocess";
String serviceName = RemoteWorkerService.class.getName();
ComponentName componentName = new ComponentName(PACKAGE_NAME, serviceName);
Data data = new Data.Builder()
.putString(ARGUMENT_PACKAGE_NAME, componentName.getPackageName())
.putString(ARGUMENT_CLASS_NAME, componentName.getClassName())
.build();
return new OneTimeWorkRequest.Builder(ExampleRemoteCoroutineWorker.class)
.setInputData(data)
.build();
Her RemoteWorkerService için AndroidManifest.xml dosyanıza bir hizmet tanımı da eklemeniz gerekir:
<manifest ... >
<service
android:name="androidx.work.multiprocess.RemoteWorkerService"
android:exported="false"
android:process=":worker1" />
<service
android:name=".RemoteWorkerService2"
android:exported="false"
android:process=":worker2" />
...
</manifest>