launch — الجوهر، تشغيل الكوروتينات بنمط fire-and-forget وكيف يعمل

ما هو launch في Kotlin Coroutines؟

launch — دالة امتداد في Kotlin، متاحة عبر استيراد kotlinx.coroutines، تنشئ كوروتين جديداً في CoroutineScope معين. على عكس الدوال العادية، الكود داخل launch يُنفذ بشكل متزامن — يمكن أن يتوقف الكوروتين دون حظر الخيط ويستأنف لاحقاً.

منشئ launch هو لبنة أساسية في نموذج الكوروتينات في Kotlin. لا يُرجع قيمة محسوبة لكنه يُرجع كائن Job يسمح بالتحكم في تنفيذ الكوروتين. جميع الكوروتينات التابعة التي تُطلق عبر launch داخل كوروتين آخر تكون مرتبطة بالأب.

صيغة وبارامترات launch

يُعرف منشئ launch كدالة inline بعدة بارامترات: CoroutineScope و CoroutineContext و CoroutineStart و suspend block. البارامترات لها قيم افتراضية، مما يجعل launch ملائماً للسيناريوهات النموذجية.

public fun CoroutineScope.launch(
    context: CoroutineContext = EmptyCoroutineContext,
    start: CoroutineStart = CoroutineStart.DEFAULT,
    block: suspend CoroutineScope.() -> Unit
): Job

البارامتر context يقبل CoroutineContext الذي يجمع بين dispatcher ومعالج استثناءات وعنصر مسمى. غالباً ما يتم تمرير Dispatchers.IO أو Dispatchers.Main أو SupervisorJob لعزل الأخطاء.

Job وإدارة دورة الحياة

Job — الكائن المُعاد الذي يمثل دورة حياة الكوروتين. يمكن أن يكون Job في الحالات: New, Active, Completing, Completed, Cancelling, Cancelled. تعكس كل حالة حالة التنفيذ وتسمح بالتفاعل مع التغييرات.

val job = CoroutineScope(Dispatchers.IO).launch {
    repeat(10) { i ->
        delay(1000L)
        println("التقدم: $i")
    }
}

println("الوظيفة نشطة: ${job.isActive}")
delay(2500L)
job.cancel()
println("الوظيفة ملغاة: ${job.isCancelled}")

يدعم Job التسلسل الهرمي: إذا تم إلغاء الكوروتين الأب، يتم إلغاء جميع الكوروتينات التابعة تلقائياً. SupervisorJob يغير هذا السلوك — الكوروتينات التابعة لا تُلغى عندما يفشل أحدها.

التزامن المهيكل في launch

التزامن المهيكل يعني أن كل كوروتين يُطلق داخل CoroutineScope محدد، ولا يكتمل النطاق حتى تنهي جميع الكوروتينات التابعة عملها. launch يدعم هذا المبدأ بالكامل — الكوروتينات التي تُطلق داخل كوروتين آخر هي تابعة له.

استدعاءات launch المتداخلة

مع استدعاءات launch المتداخلة، يتشكل شجرة من الكوروتينات. ينتظر الكوروتين الأب اكتمال جميع الكوروتينات التابعة، مما يضمن ترتيب تنفيذ يمكن التنبؤ به ويبسط إدارة الموارد.

fun main() = runBlocking {
    launch {
        launch {
            delay(1000L)
            println("اكتمل الطفل 1")
        }
        launch {
            delay(500L)
            println("اكتمل الطفل 2")
        }
        println("جميع الأطفال يكتملون قبل هذا السطر")
    }
}

يختلف هذا السلوك عن التزامن القائم على الخيوط، حيث الخيوط التابعة غير مرتبطة بالأب. في الكوروتينات، الأب لا يكتمل حتى تنهي جميع الكوروتينات التابعة عملها.

معالجة الاستثناءات في launch

معالجة الاستثناءات في launch تعتمد على نوع Job. بالنسبة لـ Job العادي، تنتشر الاستثناءات إلى الكوروتين الأب وتلغيه. بالنسبة لـ SupervisorJob أو SupervisorScope، يتم عزل الاستثناءات — خطأ في كوروتين تابع لا يؤثر على الآخرين.

val scope = CoroutineScope(SupervisorJob() + Dispatchers.IO)
scope.launch {
    try {
        riskyOperation()
    } catch (e: Exception) {
        println("تم الالتقاط: ${e.message}")
    }
}
scope.launch {
    println("هذا لا يزال يعمل بفضل SupervisorJob")
}

لمعالجة الاستثناءات غير الملتقطة بشكل عام، يُستخدم CoroutineExceptionHandler. يلتقط الاستثناءات التي لم تتم معالجتها داخل الكوروتين ويسمح بتسجيل الخطأ دون تعطل التطبيق.

أمثلة استخدام launch في Android

في Android، يُستخدم launch في كل مكان: من ViewModel إلى WorkManager. النمط الرئيسي هو استخدام lifecycleScope في Fragment و viewModelScope في ViewModel للإلغاء التلقائي للكوروتينات عند انتهاء دورة حياة المكون.

class ProfileViewModel : ViewModel() {
    private val repository = UserRepository()

    fun loadProfile(userId: String) {
        viewModelScope.launch(Dispatchers.IO) {
            val profile = repository.fetchProfile(userId)
            withContext(Dispatchers.Main) {
                _profileState.update { it.copy(profile = profile) }
            }
        }
    }
}

viewModelScope يلغي الكوروتينات تلقائياً عند تدمير ViewModel. هذا يزيل التسريبات ويضمن أن العمليات الخلفية لا تستمر بعد فقدان السياق. بالإضافة، يمكن استخدام withContext للتبديل بين dispatchers.