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>