viewModelScope: bu nədir, ViewModel-ə bağlanması və Android-də işi

Android-də viewModelScope nədir?

viewModelScope — bu, lifecycle-viewmodel-ktx kitabxanasında (2.1.0 versiyasından) əlavə edilmiş ViewModel interfeysinə extension-xüsusiyyətdir. O, ViewModel-in həyat dövrünə bağlanmış hazır CoroutineScope təmin edir.

// Daxili struktur (sadələşdirilmiş)
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 ilk müraciətdə tənbəl (lazy) şəkildə yaradılır və setTag vasitəsilə keşlənir. SupervisorJob istifadə olunur, yəni bir uşaq korutindəki istisna qalanlarını ləğv etmir. Defolt dispatcher Dispatchers.Main.immediate-dir, o, əgər çağırış artıq Main-dədirsə, əlavə dispetçerizasiya olmadan kodu əsas axında yerinə yetirir.

viewModelScope təmizlənmə barədə bildirişi necə alır

ViewModel həyat dövrünü tərk etdikdə (Activity tamamlandıqda və ya Fragment silindikdə), sistem clear() çağırır, o da onCleared()-ı işə salır. Bu callback-də viewModelScope öz Job-unu ləğv edir, bu da rekursiv olaraq bütün aktiv korutinləri bitirir. Mexanizm Closeable interfeysi vasitəsilə həyata keçirilir, burada scope-un Job-ı avtomatik bağlanma üçün resurs kimi qeydiyyatdan keçirilir.

viewModelScope necə işləyir: ViewModel-in həyat dövrünə bağlanması

viewModelScope-un ViewModel-in həyat dövrünə bağlanma mexanizmi teqləmə və onCleared callback-inə əsaslanır. Bunun addım-addım necə işlədiyinə baxaq.

Addım 1: İlk müraciətdə scope-un yaradılması

ViewModel viewModelScope.launch { ... } yerinə yetirdikdə, getter JOB_KEY teqi altında saxlanılmış scope-un olub-olmadığını yoxlayır. Scope hələ yaradılmayıbsa — CoroutineScope(SupervisorJob() + Dispatchers.Main.immediate)-nin yeni nüsxəsi yaradılır. Scope daxili teq map-i vasitəsilə ViewModel daxilində saxlanılır.

Addım 2: Korutinlərin həyat dövrü

viewModelScope.launch və ya viewModelScope.async vasitəsilə işə salınmış bütün korutinlər SupervisorJob scope-na uşaq olurlar. Onlar əsas axında işləyirlər (əgər withContext vasitəsilə başqa dispatcher göstərilməyibsə). ViewModel yaşadığı müddətcə — korutinlər aktiv, dayandırılmış və ya bitmiş ola bilər.

Addım 3: onCleared zamanı ləğv

Sistem ViewModel-i məhv etdikdə, ViewModel.clear() çağırılır. clear() daxilində aşağıdakılar baş verir:

• İstifadəçi məntiqi üçün onCleared() çağırışı
• addCloseable vasitəsilə qeydiyyatdan keçmiş bütün Closeable resurslarının bağlanması
• viewModelScope Job-ı Cancelled vəziyyətinə keçir
• Bütün uşaq korutinlər rekursiv ləğv edilir
• Zibil yığan üçün scope-a istinadların azad edilməsi

Ekran rotasiyasına davamlılıq

Ekran çevrildikdə Activity yenidən yaradılır, lakin ViewModel saxlanılır (ViewModelStoreOwner sayəsində). Bu o deməkdir ki, viewModelScope aktiv qalır və korutinlər kəsintisiz işləməyə davam edir. Activity yenidən yaradıldıqdan sonra eyni ViewModel (və eyni scope) təkrar istifadə olunur — məlumat yüklənməsi yenidən başlamır.

MVVM arxitekturasında viewModelScope

MVVM (Model-View-ViewModel) — Google tərəfindən Android proqramları üçün tövsiyə olunan arxitekturadır. viewModelScope burada asinxron əməliyyatların icraçısı kimi mərkəzi yer tutur.

viewModelScope-un arxitektura qatlarında rolu

ViewModel viewModelScope vasitəsilə korutinləri işə salır, onların daxilində Repository-nin suspend-funksiyalarını çağırır. Nəticə UI qatı tərəfindən müşahidə olunan StateFlow-a çevrilir. Bu sxem məsuliyyətlərin aydın bölünməsini və hər bir qatın müstəqil sınaqdan keçirilməsini təmin edir.

Niyə viewModelScope ViewModel-də, Fragment-də yox

Əgər korutinlər Fragment-dən işə salınsaydı, ekran çevrildikdə onlar Fragment-in məhv edilməsi ilə birlikdə ləğv olunardı. ViewModel rotasiyadan sağ çıxır, buna görə də onun scope-da işə salınmış korutinlər işləməyə davam edir. Bu, məlumat yükləmə zamanı viewModelScope-un lifecycleScope qarşısında əsas üstünlüyüdür.

viewModelScope istifadə nümunələri

Kotlin dilində Android proqramında viewModelScope-dan istifadənin üç praktik ssenarisini nəzərdən keçirək.

Nümunə 1: ViewModel yaradılarkən məlumatların yüklənməsi

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 blokunda dərhal profil yüklənməsi başlayır. Korutina defolt olaraq əsas axında işləyir. Repozitori öz suspend-funksiyası daxilində şəbəkə sorğusu üçün withContext(Dispatchers.IO) istifadə edir, buna görə ViewModel axınların dəyişdirilməsi ilə məşğul olmur.

Nümunə 2: Səhvlərin sealed class vasitəsilə işlənməsi

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 vəziyyəti sealed class UiState vasitəsilə təsvir olunur. ViewModel hər dəyişiklikdə state-i yeniləyir. Fragment StateFlow-a abunə olub yalnız aktual vəziyyətə reaksiya verir, təkrar rotasiyalarda köhnəlmiş çağırışları nəzərə almır.

Nümunə 3: Yeni sorğuda əvvəlki korutinanın ləğvi

private var searchJob: Job? = null

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

Hər yeni axtarış sorğusunda əvvəlki korutina ləğv edilir. delay(300) debounce-u həyata keçirir — axtarış yalnız daxil etmədə 300 ms fasilədən sonra yerinə yetirilir. Bu, server yükünü azaldır və köhnəlmiş nəticələrin qarşısını alır.

viewModelScope vs lifecycleScope: nə vaxt hansı seçilməlidir

Hər iki scope AndroidX Lifecycle kitabxanası tərəfindən təmin edilir, lakin müxtəlif həyat dövrlərinə bağlıdır. Onların arasında seçim tapşırığın növündən asılıdır.

Scope-ların müqayisəsi

Google tövsiyələri

Google məlumatların yüklənməsi və işlənməsi ilə bağlı bütün tapşırıqlar üçün viewModelScope-dan istifadə etməyi tövsiyə edir. lifecycleScope UI-nin konkret anına bağlı əməliyyatlar üçün tətbiq edilməlidir — məsələn, ekranın ilk görünməsi zamanı animasiyanın başladılması və ya ekrandan çıxışda dayandırılmalı olan Location yeniləmələrinə abunəlik.

viewModelScope ilə işləyərkən tipik səhvlər

Hətta Android-in yaxşı sənədləşdirilmiş API-lərində belə tərtibatçılar xarakterik səhvlərə yol verirlər. Dörd ən çox rast gəlinən problemi nəzərdən keçirək.

Səhv 1: Scope ləğv edildikdən sonra UI-nin yenilənməsi

Ən məkrli səhv — ViewModel təmizləndikdən sonra StateFlow və ya LiveData-nı yeniləməyə cəhd etməkdir. viewModelScope onCleared() zamanı ləğv edilsə də, korutina faktiki ləğv anına qədər kodu yerinə yetirə bilər. Yoxlamaq üçün isActive istifadə edin və ya catch blokunun tamamlanmasına güvənin.

Səhv 2: SupervisorJob nəzərə alınmadan korutinlərin işə salınması

viewModelScope daxildə SupervisorJob istifadə edir ki, bu da səhvləri korutinlər arasında izolyasiya edir. Amma viewModelScope.launch daxilində öz Job() ilə korutina işə salsanız, həmin korutina SupervisorJob-a uşaq olacaq, lakin digər korutinlərdəki səhvlər zamanı ləğvdən qorunmayacaq.

Səhv 3: Bir scope-da çox sayda korutina

viewModelScope-un sərt limiti olmasa da, minlərlə aktiv korutina sistemi ləngidə bilər. Uzun məlumat siyahıları üçün hər element üçün ayrıca korutina yaratmaq əvəzinə Flow ilə collectLatest istifadə edin.

Səhv 4: viewModelScope əvəzinə GlobalScope istifadəsi

Təsadüfən viewModelScope əvəzinə GlobalScope idxal etsəniz, korutina ViewModel təmizlənərkən ləğv edilməyəcək. Bu, yaddaş sızmasına və potensial crash-a səbəb olacaq. Həmişə korutinlərin viewModelScope vasitəsilə işə salındığını yoxlayın, xüsusilə varis fragmentlərdə.