למשתמשי 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 מטפל בהפסקות באופן אוטומטי על ידי ביטול ה-coroutine והפצת אותות הביטול. לא צריך לעשות שום דבר מיוחד כדי לטפל בהפסקות עבודה.
הפעלת CoroutineWorker בתהליך אחר
אפשר גם לקשר worker לתהליך ספציפי באמצעות 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>