Użytkownicy Kotlina mogą korzystać z WorkManagera, który zapewnia pierwszorzędne wsparcie korobocji. Aby rozpocząć, dodaj work-runtime-ktx
do pliku Gradle. Zamiast rozszerzać Worker
, rozszerz CoroutineWorker
, który ma zawieszoną wersję doWork()
. Jeśli na przykład chcesz utworzyć prosty element CoroutineWorker
do wykonywania operacji sieciowych, 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()
}
}
Pamiętaj, że CoroutineWorker.doWork()
to funkcja wstrzymywania. W przeciwieństwie do Worker
ten kod nie działa na Executor
określonym w Configuration
. Zamiast tego domyślnie ustawia się wartość Dispatchers.Default
. Możesz go dostosować, podając własny CoroutineContext
. W przykładzie powyżej prawdopodobnie chcesz wykonać te czynności w przypadku 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
automatycznie przetwarza przerwy, anulując współbieżność i rozsyłając sygnały anulowania. Nie musisz nic specjalnego robić, aby obsłużyć zatrzymanie pracy.
Uruchamianie CoroutineWorker w innym procesie
Pracownika możesz też powiązać z określonym procesem, używając funkcji RemoteCoroutineWorker
, która jest implementacją funkcji ListenableWorker
.
RemoteCoroutineWorker
łączy się z konkretnym procesem za pomocą 2 dodatkowych argumentów, które podajesz jako część danych wejściowych podczas tworzenia żądania pracy: ARGUMENT_CLASS_NAME
i ARGUMENT_PACKAGE_NAME
.
Ten przykład pokazuje, jak utworzyć żądanie dotyczące pracy, które jest powiązane z określonym 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żdej usługi 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>