פרוטוקול Threading ב-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 מטפל בהפסקות באופן אוטומטי על ידי ביטול ה-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>