Tworzenie wątków w CoroutineWorker

W przypadku użytkowników języka Kotlin WorkManager zapewnia wbudowaną obsługę współprogramów. Aby rozpocząć, dodaj work-runtime-ktx do pliku Gradle. Zamiast rozszerzać klasę Worker, rozszerz klasę CoroutineWorker, która ma zawieszoną wersję doWork. Aby na przykład utworzyć prostą aplikację CoroutineWorker, która wykonuje operacje sieciowe, wykonaj te czynności:

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

Zwróć uwagę, że CoroutineWorker.doWork() to funkcja zawieszająca. W przeciwieństwie do Worker ten kod nie działa na Executor określonym w Configuration. Zamiast tego domyślnie używana jest wartość Dispatchers.Default. Możesz to dostosować, podając własny CoroutineContext. W poprzednim przykładzie prawdopodobnie chcesz wykonać tę pracę na Dispatchers.IO w ten sposób:

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 automatycznie obsługuje zatrzymania, anulując współprogram i rozpowszechniając sygnały anulowania. Nie musisz robić niczego szczególnego, aby poradzić sobie z przerwami w pracy.

Uruchamianie CoroutineWorker w innym procesie

Możesz też powiązać proces roboczy z konkretnym procesem, używając RemoteCoroutineWorker, czyli implementacji ListenableWorker.

RemoteCoroutineWorker wiąże się z konkretnym procesem za pomocą 2 dodatkowych argumentów, które podajesz jako część danych wejściowych podczas tworzenia żądania zadania: ARGUMENT_CLASS_NAME i ARGUMENT_PACKAGE_NAME.

Poniższy przykład pokazuje, jak utworzyć żądanie pracy powiązane z konkretnym procesem:

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

W przypadku każdego elementu RemoteWorkerService musisz też dodać definicję usługi w pliku 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>