viewModelScope: یہ کیا ہے، ViewModel سے منسلک ہونا اور Android میں کام

Android میں viewModelScope کیا ہے؟

viewModelScope ViewModel انٹرفیس پر ایک extension پراپرٹی ہے، جو lifecycle-viewmodel-ktx لائبریری (ورژن 2.1.0 سے) میں شامل کی گئی ہے۔ یہ ViewModel کے لائف سائیکل سے منسلک ایک تیار CoroutineScope فراہم کرتا ہے۔

// Internal structure (simplified)
val ViewModel.viewModelScope: CoroutineScope
    get() {
        val scope = this.getTag(JOB_KEY)
        if (scope != null) return scope
        return CoroutineScope(SupervisorJob() + Dispatchers.Main.immediate)
            .also { setTag(JOB_KEY, it) }
    }

scope پہلی رسائی پر سست (lazy) طریقے سے بنایا جاتا ہے اور setTag کے ذریعے کیش کیا جاتا ہے۔ یہ SupervisorJob استعمال کرتا ہے، جس کا مطلب ہے کہ ایک چائلڈ کوروٹین میں استثنا دوسروں کو منسوخ نہیں کرتا۔ ڈیفالٹ ڈسپیچر Dispatchers.Main.immediate ہے، جو پہلے سے Main پر ہونے کی صورت میں اضافی ڈسپیچنگ کے بغیر مین تھریڈ پر کوڈ انجام دیتا ہے۔

viewModelScope صفائی کا اطلاع کیسے حاصل کرتا ہے

جب ViewModel لائف سائیکل چھوڑتا ہے (Activity ختم ہوتی ہے یا Fragment ہٹا دیا جاتا ہے)، نظام clear() کو کال کرتا ہے، جو onCleared() کو متحرک کرتا ہے۔ اس کال بیک میں، viewModelScope اپنے Job کو منسوخ کرتا ہے، جو تمام فعال کوروٹین کو تکراری طور پر ختم کرتا ہے۔ یہ طریقہ کار Closeable انٹرفیس کے ذریعے نافذ کیا گیا ہے، جہاں scope کا Job خودکار بندش کے لیے ایک وسائل کے طور پر رجسٹر ہوتا ہے۔

viewModelScope کیسے کام کرتا ہے: ViewModel لائف سائیکل سے منسلک ہونا

viewModelScope کا ViewModel لائف سائیکل سے منسلک ہونے کا طریقہ کار ٹیگنگ اور onCleared کال بیک پر مبنی ہے۔ آئیے اسے مرحلہ وار دیکھتے ہیں۔

مرحلہ 1: پہلی رسائی پر scope کی تخلیق

جب ViewModel viewModelScope.launch { ... } انجام دیتا ہے، getter چیک کرتا ہے کہ JOB_KEY ٹیگ کے تحت پہلے سے کوئی scope محفوظ ہے یا نہیں۔ اگر scope موجود نہیں ہے، تو ایک نیا CoroutineScope(SupervisorJob() + Dispatchers.Main.immediate) انسٹنس بنایا جاتا ہے۔ scope اندرونی ٹیگ میپ کے ذریعے ViewModel کے اندر محفوظ کیا جاتا ہے۔

مرحلہ 2: کوروٹین کا لائف سائیکل

viewModelScope.launch یا viewModelScope.async کے ذریعے شروع کی گئی تمام کوروٹین scope کے SupervisorJob کی چائلڈ بن جاتی ہیں۔ وہ مین تھریڈ پر چلتی ہیں (جب تک withContext کے ذریعے کوئی مختلف ڈسپیچر متعین نہ کیا گیا ہو)۔ جب تک ViewModel زندہ ہے، کوروٹین فعال، معطل یا مکمل ہو سکتی ہیں۔

مرحلہ 3: onCleared پر منسوخی

جب نظام ViewModel کو ختم کرتا ہے، ViewModel.clear() کال کیا جاتا ہے۔ clear() کے اندر، درج ذیل ہوتا ہے:

• کسٹم صفائی منطق کے لیے onCleared() کال کیا جاتا ہے
• addCloseable کے ذریعے رجسٹر کردہ تمام Closeable وسائل بند کیے جاتے ہیں
• viewModelScope کا Job Cancelled حالت میں چلا جاتا ہے
• تمام چائلڈ کوروٹین تکراری طور پر منسوخ کی جاتی ہیں
• کوڑا کرکٹ جمع کرنے والے کے لیے scope کے حوالہ جات جاری کیے جاتے ہیں

گھومنے کی برداشت

جب اسکرین گھمائی جاتی ہے، Activity دوبارہ بنائی جاتی ہے، لیکن ViewModel باقی رہتی ہے (ViewModelStoreOwner کی بدولت)۔ اس کا مطلب ہے کہ viewModelScope فعال رہتا ہے اور کوروٹین بغیر کسی رکاوٹ کے چلتی رہتی ہیں۔ Activity کے دوبارہ بننے کے بعد، وہی ViewModel (اور وہی scope) دوبارہ استعمال کیا جاتا ہے — ڈیٹا لوڈنگ شروع سے شروع نہیں ہوتی۔

MVVM آرکیٹیکچر میں viewModelScope

MVVM (Model-View-ViewModel) Android ایپلی کیشنز کے لیے Google کی تجویز کردہ آرکیٹیکچر ہے۔ viewModelScope اس میں غیر متزامن کارروائیوں کے عمل درآمد کنندہ کے طور پر مرکزی مقام رکھتا ہے۔

آرکیٹیکچر کی تہوں میں viewModelScope کا کردار

ViewModel viewModelScope کے ذریعے کوروٹین شروع کرتا ہے، جن کے اندر یہ Repository کے suspend فنکشن کو کال کرتا ہے۔ نتیجہ StateFlow میں تبدیل ہوتا ہے، جسے UI تہہ دیکھتی ہے۔ یہ ڈیزائن واضح ذمہ داری کی علیحدگی اور ہر تہہ کی آزاد جانچ پڑتال کو یقینی بناتا ہے۔

ViewModel میں viewModelScope کیوں، Fragment میں کیوں نہیں

اگر کوروٹین Fragment سے شروع کی جاتیں، تو اسکرین گھمانے پر Fragment کی تباہی کے ساتھ وہ منسوخ ہو جاتیں۔ ViewModel گھومنے کے بعد باقی رہتی ہے، لہذا اس کے scope میں شروع کی گئی کوروٹین چلتی رہتی ہیں۔ ڈیٹا لوڈ کرتے وقت lifecycleScope کے مقابلے میں viewModelScope کا یہ اہم فائدہ ہے۔

viewModelScope استعمال کی مثالیں

آئیے Kotlin میں Android ایپلی کیشن میں viewModelScope استعمال کرنے کے تین عملی منظرنامے دیکھتے ہیں۔

مثال 1: ViewModel بنانے پر ڈیٹا لوڈ کرنا

class ProfileViewModel(
    private val repo: ProfileRepository
) : ViewModel() {

    private val _profile = MutableStateFlow<Profile?>(null)
    val profile: StateFlow<Profile?> = _profile

    init {
        loadProfile()
    }

    private fun loadProfile() {
        viewModelScope.launch {
            val result = repo.getProfile()
            _profile.value = result
        }
    }
}

init بلاک میں، پروفائل لوڈنگ فوری طور پر شروع ہوتی ہے۔ کوروٹین ڈیفالٹ طور پر مین تھریڈ پر چلتی ہے۔ ذخیرہ اپنے suspend فنکشن کے اندر نیٹ ورک کی درخواست کے لیے withContext(Dispatchers.IO) استعمال کرتا ہے، لہذا ViewModel کو تھریڈ تبدیل کرنے کی فکر نہیں کرنی پڑتی۔

مثال 2: sealed class کے ذریعے غلطی کا انتظام

sealed class UiState {
    object Loading : UiState()
    data class Success(val data: List<Item>) : UiState()
    data class Error(val message: String) : UiState()
}

fun fetchItems() {
    _state.value = UiState.Loading
    viewModelScope.launch {
        try {
            val items = repo.getItems()
            _state.value = UiState.Success(items)
        } catch (e: Exception) {
            _state.value = UiState.Error(e.message ?: "Unknown error")
        }
    }
}

UI حالت کو sealed class UiState کے ذریعے بیان کیا گیا ہے۔ ViewModel ہر تبدیلی پر حالت کو اپ ڈیٹ کرتا ہے۔ Fragment StateFlow کو سبسکرائب کرتا ہے اور صرف موجودہ حالت پر رد عمل ظاہر کرتا ہے، پچھلے گھماؤ کی پرانی کالوں کو نظر انداز کرتا ہے۔

مثال 3: نئی درخواست پر پچھلے کوروٹین کو منسوخ کرنا

private var searchJob: Job? = null

fun search(query: String) {
    searchJob?.cancel()
    searchJob = viewModelScope.launch {
        delay(300)
        val results = repo.search(query)
        _searchResults.value = results
    }
}

ہر نئی تلاش کی استفسار پر، پچھلا کوروٹین منسوخ ہو جاتا ہے۔ delay(300) ڈیباؤنس کو نافذ کرتا ہے — تلاش صرف 300 ms کی غیرفعالیت کے بعد انجام دی جاتی ہے۔ یہ سرور کے بوجھ کو کم کرتا ہے اور پرانے نتائج کو روکتا ہے۔

viewModelScope بمقابلہ lifecycleScope: کب کیا انتخاب کریں

دونوں scope AndroidX Lifecycle لائبریری کے ذریعے فراہم کیے گئے ہیں، لیکن مختلف لائف سائیکل سے منسلک ہیں۔ انتخاب کام کی قسم پر منحصر ہے۔

Scope کا موازنہ

Google کی سفارشات

Google تمام ڈیٹا لوڈنگ اور پروسیسنگ کے کاموں کے لیے viewModelScope استعمال کرنے کی سفارش کرتا ہے۔ lifecycleScope کو UI لائف سائیکل کے کسی مخصوص لمحے سے منسلک کارروائیوں کے لیے استعمال کیا جانا چاہیے — مثال کے طور پر، پہلی اسکرین ظاہری شکل پر اینیمیشن شروع کرنا یا لوکیشن اپ ڈیٹس کو سبسکرائب کرنا جو اسکرین چھوڑنے پر رک جانا چاہیے۔

viewModelScope کے ساتھ کام کرتے وقت عام غلطیاں

اچھی طرح سے دستاویز شدہ Android API میں بھی، ڈویلپر عام غلطیاں کرتے ہیں۔ آئیے چار سب سے عام مسائل کو دیکھتے ہیں۔

غلطی 1: scope منسوخی کے بعد UI کو اپ ڈیٹ کرنا

سب سے خطرناک غلطی ViewModel کے صاف ہونے کے بعد StateFlow یا LiveData کو اپ ڈیٹ کرنے کی کوشش کرنا ہے۔ اگرچہ viewModelScope onCleared() پر منسوخ ہو جاتا ہے، ایک کوروٹین اصل منسوخی مؤثر ہونے سے پہلے کوڈ انجام دے سکتا ہے۔ جانچ کے لیے isActive استعمال کریں یا کیچ بلاک کی تکمیل پر بھروسہ کریں۔

غلطی 2: SupervisorJob پر غور کیے بغیر کوروٹین شروع کرنا

viewModelScope اندرونی طور پر SupervisorJob استعمال کرتا ہے، جو کوروٹین کے درمیان غلطیوں کو الگ کرتا ہے۔ تاہم، اگر آپ viewModelScope.launch کے اندر اپنے Job() کے ساتھ کوروٹین شروع کرتے ہیں، تو وہ کوروٹین SupervisorJob کی چائلڈ بن جاتی ہے لیکن دوسرے کوروٹین میں غلطیوں کی وجہ سے منسوخی سے محفوظ نہیں رہے گی۔

غلطی 3: ایک scope میں بہت زیادہ کوروٹین

اگرچہ viewModelScope کی کوئی سخت حد نہیں ہے، ہزاروں فعال کوروٹین سسٹم کو سست کر سکتے ہیں۔ لمبی ڈیٹا فہرستوں کے لیے، ہر آئٹم کے لیے علیحدہ کوروٹین بنانے کے بجائے Flow کو collectLatest کے ساتھ استعمال کریں۔

غلطی 4: viewModelScope کی بجائے GlobalScope کا استعمال

اگر viewModelScope کی بجائے غلطی سے GlobalScope درآمد کیا جاتا ہے، تو ViewModel کے صاف ہونے پر کوروٹین منسوخ نہیں ہوگا۔ یہ میموری لیک اور ممکنہ کریش کا باعث بنتا ہے۔ ہمیشہ یقینی بنائیں کہ کوروٹین viewModelScope کے ذریعے شروع کی گئی ہیں، خاص طور پر Fragment ذیلی طبقات میں۔