Потоки в CoroutineWorker

Для пользователей Kotlin WorkManager предоставляет первоклассную поддержку сопрограмм. Для начала добавьте work-runtime-ktx в файл gradle. Вместо Worker следует расширить CoroutineWorker, у которого есть приостанавливаемая версия doWork(). Например, если вы хотите создать простой CoroutineWorker для выполнения некоторых сетевых операций, сделайте следующее:

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() – это приостанавливаемая функция. В отличие от Worker, этот код не выполняется на Executor, указанном в Configuration. Вместо этого по умолчанию используется Dispatchers.Default. Вы можете настроить это, указав собственный CoroutineContext. В приведенном выше примере вы, вероятно, захотите выполнить эту работу на Dispatchers.IO следующим образом:

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 автоматически обрабатывает остановки, отменяя сопрограмму и распространяя сигналы отмены. Вам не нужно предпринимать никаких специальных действий, чтобы справиться с приостановкой работы.

Запуск CoroutineWorker в другом процессе

Вы также можете привязать исполнителя к определенному процессу с помощью RemoteCoroutineWorker, реализации ListenableWorker.

RemoteCoroutineWorker привязывается к определенному процессу с двумя дополнительными аргументами, которые вы указываете в составе входных данных при создании запроса на работу: ARGUMENT_CLASS_NAME и ARGUMENT_PACKAGE_NAME.

В следующем примере показано, как создать запрос на работу, привязанный к определенному процессу:

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

Для каждого RemoteWorkerService также необходимо добавить определение сервиса в файл 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>