Threading di CoroutineWorker

Untuk pengguna Kotlin, WorkManager menyediakan dukungan bawaan untuk coroutine. Untuk memulai, sertakan work-runtime-ktx dalam file Gradle Anda. Daripada memperluas Worker, perluas CoroutineWorker, yang memiliki versi penangguhan doWork. Misalnya, untuk membuat CoroutineWorker sederhana yang melakukan operasi jaringan, lakukan hal berikut:

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

Perhatikan bahwa CoroutineWorker.doWork() adalah fungsi penangguhan. Tidak seperti Worker, kode ini tidak berjalan di Executor yang ditentukan dalam Configuration Anda. Sebagai gantinya, kode ini akan didefaultkan ke Dispatchers.Default. Anda dapat menyesuaikannya dengan menyediakan CoroutineContext Anda sendiri. Pada contoh sebelumnya, Anda mungkin ingin melakukan pekerjaan ini di Dispatchers.IO, sebagai berikut:

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 otomatis menangani penghentian dengan membatalkan coroutine dan menyebarkan sinyal pembatalan. Anda tidak perlu melakukan hal khusus untuk menangani penghentian pekerjaan.

Menjalankan CoroutineWorker dalam proses yang berbeda

Anda juga dapat mengikat worker ke proses tertentu menggunakan RemoteCoroutineWorker, yang merupakan implementasi dari ListenableWorker.

RemoteCoroutineWorker terikat ke proses tertentu dengan dua argumen tambahan yang Anda berikan sebagai bagian dari data input saat membuat permintaan pekerjaan: ARGUMENT_CLASS_NAME dan ARGUMENT_PACKAGE_NAME.

Contoh berikut menunjukkan pembuatan permintaan pekerjaan yang terikat dengan proses tertentu:

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

Untuk setiap RemoteWorkerService, Anda juga perlu menambahkan definisi layanan di file AndroidManifest.xml:

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