lifecycleScope — bu nədir, Lifecycle-ə bağlanma və Android-də işləmə

Android-də lifecycleScope nədir?

lifecycleScope — LifecycleOwner (Activity, Fragment, Service) interfeysinə genişləndirmə xüsusiyyətidir, komponentin tam həyat dövrünə bağlanmış hazır CoroutineScope təmin edir. LifecycleOwner DESTROYED vəziyyətinə çatdıqda, lifecycleScope bütün aktiv korutinləri avtomatik ləğv edir.

// Fragment və ya Activity-də
lifecycleScope.launch {
    delay(1000)
    showSnackbar("Salam!")
}

viewModelScope-dən fərqli olaraq, lifecycleScope hər LifecycleOwner məhv olduqda — ekran rotasiyası da daxil olmaqla — ləğv olunur. Bu onu yalnız konkret ekran görünən olduqda yaşamalı olan əməliyyatlar üçün ideal edir.

lifecycleScope harada mövcuddur

lifecycleScope LifecycleOwner olan hər yerdə mövcuddur:

• Activity — AppCompatActivity LifecycleOwner-dən miras alır
• Fragment — Fragment LifecycleOwner-dən miras alır
• LifecycleService — həyat dövrü olan xidmət
• ProcessLifecycleOwner — bütün tətbiqin həyat dövrü
• Xüsusi LifecycleOwner — LifecycleOwner-i tətbiq edən istənilən obyektlər

lifecycleScope necə işləyir: Lifecycle və avtomatik ləğv

Avtomatik ləğv mexanizmi Lifecycle hadisələrinə abunəlik əsasında qurulub. Lifecycle CREATED-dən DESTROYED-ə düşdükdə, scope ləğv olunur.

Lifecycle vəziyyətləri

lifecycleScope-un daxili quruluşu

lifecycleScope CoroutineScope(SupervisorJob() + Dispatchers.Main.immediate) kimi yaradılır və Lifecycle daxilində saxlanılır. Lifecycle DESTROYED vəziyyətinə keçdikdə scope.cancel() çağırılır. Mexanizm scope-a ilk müraciətdə həyat dövrü hadisələrinə abunə olan LifecycleEventObserver vasitəsilə həyata keçirilir.

Rotasiya zamanı davranış

Ekran döndərildikdə Activity məhv olur (onDestroy) və yenidən yaradılır. lifecycleScope köhnə Activity ilə birlikdə ləğv olunur və yeni Activity üçün yeni scope nümunəsi yaradılır. Bu, rotasiya zamanı qorunan viewModelScope-dən prinsipial fərqdir.

lifecycleScope API: launch, launchWhen və repeatOnLifecycle

Lifecycle kitabxanası lifecycleScope vasitəsilə korutinləri işə salmağın bir neçə yolunu təmin edir. Köhnəlmiş metodlardan müasir olanlara API təkamülünü nəzərdən keçirək.

lifecycleScope.launch — əsas işə salma

Ən sadə yol — lifecycleScope.launch { ... }. Korutin dərhal işə düşür və DESTROYED zamanı ləğv olunur. Lakin UI görünməz olsa belə kod icra edə bilər (məsələn, onStop-dan sonra fon). Bu həmişə arzuolunan deyil.

Köhnəlmiş: launchWhenCreated / launchWhenStarted / launchWhenResumed

Bu metodlar Lifecycle göstərilən vəziyyətdən aşağı düşdükdə korutinin icrasını dayandırır və qayıtdıqda bərpa edirdi. Lakin onlar lifecycle-runtime-ktx 2.6.0-da @Deprecated olaraq qeyd edildi, çünki:

• Korutini ləğv etmirdi — yalnız dayandırırdı
• Yaddaş istehlak edən asılı korutinlərin yığılmasına səbəb olurdu
• Sürətli vəziyyət dəyişmələrində race condition yaradırdı

Müasir API: repeatOnLifecycle

repeatOnLifecycle — Google tərəfindən tövsiyə olunan, həyat dövrü ilə sinxronlaşdırılmış korutinləri işə salma üsuludur. Lifecycle müəyyən edilmiş vəziyyətə çatdıqda korutini ləğv edir və yenidən başladır.

lifecycleScope.launch {
    repeatOnLifecycle(Lifecycle.State.STARTED) {
        viewModel.uiState.collect { state ->
            updateUI(state)
        }
    }
}

repeatOnLifecycle-ə ötürülən korutin Lifecycle STARTED-ə çatdıqda işə düşür və STARTED-dən aşağı düşdükdə ləğv olunur. STARTED-ə qayıtdıqda korutin yenidən başlayır. Bu təhlükəsiz və səmərəlidir — heç bir korutin fasilədə asılı qalmır.

flowWithLifecycle — Flow üçün

Flow-dan həyat dövrü nəzərə alınmaqla məlumat toplamaq üçün flowWithLifecycle operatoru mövcuddur. Lifecycle vəziyyəti dəyişdikdə toplamanı avtomatik dayandırır və bərpa edir:

viewModel.uiState
    .flowWithLifecycle(lifecycle, Lifecycle.State.STARTED)
    .onEach { state -> updateUI(state) }
    .launchIn(lifecycleScope)

flowWithLifecycle operatoru — UI qatında Flow-a təhlükəsiz abunə olmağın ən qısa yoludur.

lifecycleScope istifadə nümunələri

Kotlin ilə Android tətbiqində lifecycleScope-un üç real ssenarisini nəzərdən keçirək.

Nümunə 1: Yer məlumatı yeniləmələrinə yalnız ekran görünən olduqda abunə olmaq

class MapFragment : Fragment() {

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)

        lifecycleScope.launch {
            repeatOnLifecycle(Lifecycle.State.STARTED) {
                locationProvider.observeLocation().collect { loc ->
                    updateMapMarker(loc)
                }
            }
        }
    }
}

Korutin fraqment görünən olduqda (STARTED) başlayır və ekrandan çıxdıqda (STOPPED) ləğv olunur. İstifadəçi başqa tətbiqə keçərsə, yer yeniləmələri batareya sərf etmir.

Nümunə 2: Fraqment başlayanda animasiyanın işə salınması

lifecycleScope.launch {
    repeatOnLifecycle(Lifecycle.State.RESUMED) {
        animateFadeIn(titleView)
        delay(200)
        animateSlideUp(contentView)
    }
}

Animasiya yalnız fraqment ön planda olduqda (RESUMED) işə düşür. İstifadəçi animasiya zamanı tətbiqi bağlasa, korutin ləğv olunur və qayıtdıqda animasiya yenidən başlayır.

Nümunə 3: Görünən ekranda dövri məlumat sinxronizasiyası

lifecycleScope.launch {
    repeatOnLifecycle(Lifecycle.State.STARTED) {
        while (isActive) {
            syncData()
            delay(30_000L)
        }
    }
}

Məlumat hər 30 saniyədən bir sinxronlaşdırılır, ancaq ekran görünən olduqda. isActive korutinin ləğv edilib-edilmədiyini yoxlayır, bu da ekrandan çıxarkən dövrədən təhlükəsiz çıxışı təmin edir.

lifecycleScope vs viewModelScope: tətbiq ssenariləri

Hər iki scope həyat dövrünə bağlıdır, lakin müxtəlif aspektlərinə. Fərqi başa düşmək Android tətbiqlərinin düzgün arxitekturası üçün kritik əhəmiyyət daşıyır.

Əsas fərq

viewModelScope ekran rotasiyasından sağ çıxan ViewModel-ə bağlıdır. lifecycleScope rotasiya zamanı məhv olan və yenidən yaradılan LifecycleOwner-ə (Activity/Fragment) bağlıdır. Bu onların tətbiq ssenarilərini müəyyən edir.

Nə vaxt lifecycleScope istifadə etməli

• Sistem hadisələrinə abunəlik (yer, sensorlar, kamera)
• Konkret ekrana bağlı animasiyalar və UI effektləri
• Ekran görünməsi nəzərə alınmaqla məlumatın hissə-hissə yüklənməsi
• Ekrandan çıxışda dayandırılmalı olan əməliyyatlar

Nə vaxt viewModelScope istifadə etməli

• Repozitordan məlumat yükləmə
• Rotasiyadan sağ çıxmalı olan biznes məntiqi
• Məlumatın keşlənməsi və emalı
• Nəticəsi rotasiyadan sonra lazım olan istənilən əməliyyatlar

Birlikdə istifadə

Praktikada hər iki scope-un kombinasiyası tez-tez rast gəlinir: viewModelScope məlumat yükləyir və vəziyyəti idarə edir, lifecycleScope ViewModel-dən Flow-a ekranın həyat dövrü nəzərə alınmaqla abunə olur. Bu məsuliyyət bölgüsü müasir Android inkişafında best practice hesab olunur.

lifecycleScope ilə işdə tipik səhvlər

Proqramçıların lifecycleScope istifadə edərkən buraxdıqları dörd ən çox yayılmış səhvi nəzərdən keçirək.

Səhv 1: Məlumat yükləmək üçün viewModelScope əvəzinə lifecycleScope istifadə etmək

Məlumat yükləməni lifecycleScope.launch-da işə salsanız, ekran rotasiyası zamanı korutin ləğv olunacaq və məlumatı yenidən yükləmək lazım gələcək. Uzunmüddətli əməliyyatlar üçün viewModelScope istifadə edin. lifecycleScope — yalnız UI ilə bağlı tapşırıqlar üçün.

Səhv 2: repeatOnLifecycle olmadan Flow toplamaq

lifecycleScope.launch daxilində birbaşa viewModel.someFlow.collect { ... } çağırışı ekran görünməz olsa belə məlumat toplamağa davam edir. Bu, fonda UI yeniləmələrinə və lazımsız yükə səbəb ola bilər. Həmişə repeatOnLifecycle və ya flowWithLifecycle istifadə edin.

Səhv 3: Ekrandan çıxışda ləğvi unutmaq

lifecycleScope DESTROYED zamanı ləğv olunsa da, dayandırma nöqtəsindən (suspend) sonrakı kod qəfil ləğvdə icra olunmaya bilər. NonCancellable istifadə etmədikcə, suspend çağırışından sonrakı kodun icrasına güvənməyin.

Səhv 4: repeatOnLifecycle əvəzinə köhnəlmiş launchWhenStarted istifadə etmək

launchWhenStarted və onun analoqları korutini ləğv etmir, yalnız dayandırır. Ekran dəfələrlə ön və fon plan arasında keçid edərsə, korutin təxirə salınmış çağırışları yığır. repeatOnLifecycle-ə keçin — bu, Lifecycle ilə sinxronizasiyanın yeganə düzgün yoludur.