Android-da Back Press Handling: mahiyyəti, mexanizmləri və tətbiqi

Back Press Handling nədir

Back Press Handling — Android-in sistem mexanizmidir ki, istifadəçi hardware və ya proqram “Geri” düyməsini basdıqda nə baş verdiyini müəyyən edir. Kontekstdən asılı olaraq basma: cari ekranı bağlayıb əvvəlkiyə qayıda bilər, klaviaturanı gizlədə bilər, Drawer və ya Bottom Sheet-i bağlaya bilər, istifadəçi kök ekrandadırsa tətbiqdən çıxa bilər.

“Geri” düyməsinin davranışı Android-in hər versiyası ilə təkamül etmişdir. Android 10-da naviqasiya jestləri meydana çıxdı, Android 11-də — OnBackPressedDispatcher standart API olaraq, Android 13-də isə təkmilləşdirilmiş predictive back gesture dəstəyi, burada sistem hərəkətin faktiki yerinə yetirilməsindən əvvəl keçid animasiyasını göstərir. Google ardıcıl olaraq bütün cihazlarda Back Press-in proqnozlaşdırıla bilən və ardıcıl davranışına doğru hərəkət edir.

“Geri” düyməsinin düzgün işlənməsi — Android tətbiqində UX-in kritik elementidir. İstifadəçi gözləyir ki, “Geri” basması onu naviqasiya yığınında əvvəlki ekrana qaytarsın, tətbiqi gözlənilmədən bağlamasın. Bu gözləntinin pozulması Google Play-də mənfi rəylərin və aşağı reytinqlərin əsas səbəblərindən biridir.

Back Press API-nin təkamülü: onBackPressed-dən OnBackPressedDispatcher-ə

Back Press API-nin tarixi Android-də platformanın ümumi təkamülünü əks etdirir: Activity-də sadə metoddan lifecycle və Compose dəstəyi ilə çevik callback sisteminə qədər. Gəlin üç inkişaf mərhələsinə baxaq.

onBackPressed dövrü (API Level 1–30)

İlk Android API-dən etibarən “Geri” düyməsi Activity sinfinin onBackPressed metodunda işlənirdi. Tərtibatçı bu metodu override edir və öz məntiqini yazırdı. Problem onda idi ki, Fragment və View basmanı tuta bilmirdi — bütün idarəetmə Activity vasitəsilə gedirdi. Bu, şişmiş Activity-lərə və basmanı kimin işləməli olduğunu müəyyən etmək üçün mürəkkəb if-else zəncirinə gətirib çıxarırdı.

OnBackPressedDispatcher-in meydana çıxması (Activity 1.0.0)

Activity 1.0.0 (AndroidX) ilə Google OnBackPressedDispatcher-i təqdim etdi. Bu, istənilən komponentdən — Activity, Fragment, Dialog, fərdi View-dən callback qəbul edən mərkəzi dispetçerdir. Callback-lər priority vasitəsilə sıra göstərilməklə qeydiyyatdan keçirilir və dinamik olaraq əlavə edilə və ya silinə bilər. OnBackPressedDispatcher köhnə onBackPressed-dən daha əvvəl çağırılır ki, bu da basmanı Activity-nin işləməsindən əvvəl tutmağa imkan verir.

Predictive Back Gesture (Android 13+)

Android 13 predictive back gesture-i təqdim etdi — istifadəçi jesti tamamlamamış “Geri” basmasının hara aparacağını göstərən sistem animasiyası. Bu animasiyanı dəstəkləmək üçün tərtibatçılar OnBackPressedDispatcher-dən istifadə etməli və isEnabled xassəsi vasitəsilə callback-in sistem animasiyasını dəstəklədiyini göstərməlidirlər. Callback predictive animation-ı dəstəkləmirsə, sistem tətbiq kontekstinə uyğun olmayan standart animasiyanı göstərir.

OnBackPressedDispatcher — arxitektura və callback zənciri

OnBackPressedDispatcher — yeni Back Press API-nin özəyidir. O, callback zəncirini idarə edir, hadisəni işləyən ilk callback-ə qədər onları ardıcıl çağırır. Heç bir callback basmanı işləməzsə, dispetçer standart hərəkəti yerinə yetirir — Activity üçün finish() və ya Navigation Component üçün popBackStack().

Callback-in prioritetlə qeydiyyatı

Callback addCallback vasitəsilə LifecycleOwner və OnBackPressedCallback obyekti göstərilməklə qeydiyyatdan keçirilir. Callback isEnabled xassəsini ehtiva edir — false olarsa, callback buraxılır. priority üçün 0 (ən aşağı) ilə Integer.MAX_VALUE arasında dəyər ötürülə bilər. Fragment Activity Result API bu mexanizmdən həyat dövrünə bağlı callback-lərin avtomatik qeydiyyatı üçün istifadə edir.

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    val callback = object : OnBackPressedCallback(enabled = true) {
        override fun handleOnBackPressed() {
            if (isDrawerOpen) { closeDrawer() }
            else { isEnabled = false; onBackPressed() }
        }
    }
    onBackPressedDispatcher.addCallback(this, callback)
}

Lifecycle-aware təmizləmə

Callback avtomatik silinir, LifecycleOwner DESTROYED vəziyyətinə keçdikdə. Bu, ekranın fırlanması zamanı callback sızmalarının köhnə problemini həll edir. Callback Fragment-ə əlavə olunubsa, Fragment məhv edildikdə silinəcəyinə zəmanət verilir. Callback-in müvəqqəti söndürülməsi üçün isEnabled xassəsindən istifadə olunur — silmədən və yenidən qeydiyyatdan keçirmədən dəyişmək olar.

Çağırış zənciri

Çağırış sırası əlavə edilmə sırasının tərsidir: ən son əlavə edilən callback ilk növbədə idarəetməni alır. Bu məntiqlidir, çünki ən iç-içə olan UI elementi (məsələn, Fragment daxilində Bottom Sheet) basmanı valideyn Fragment-dən əvvəl işləməlidir. Ən dərin callback basmanı işləmirsə (isEnabled = false), idarəetmə zəncirdə növbətiyə ötürülür.

Fragment və dialoqlarda Back Press

Fragment API requireActivity().onBackPressedDispatcher metodu vasitəsilə OnBackPressedDispatcher ilə öz inteqrasiyasını təmin edir. Fragment 1.2.0-dan başlayaraq, hər bir Fragment öz callback-ni qeydiyyatdan keçirə bilər ki, bu da avtomatik olaraq Fragment-in həyat dövrünə bağlanır və məhv edildikdə silinir.

Fragment-də callback

Fragment-də callback-in qeydiyyatı onCreate, onViewCreated və ya hətta View-in özündə aparılır — yalnız LifecycleOwner-in (Fragment) aktiv olması vacibdir. Fragment STARTED vəziyyətinə keçdikdə callback işə düşür, STOPPED-da sönür. Bu, gizli Fragment-in (ViewPager-da) “Geri” basmasını işləməyəcəyinə zəmanət verir.

class EditorFragment : Fragment() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        val callback = object : OnBackPressedCallback(true) {
            override fun handleOnBackPressed() {
                showDiscardDialog()
            }
        }
        requireActivity().onBackPressedDispatcher.addCallback(this, callback)
    }
}

Dialog və BottomSheetDialog

Dialoqlar və BottomSheet bağlanmaq üçün “Geri” basmasını avtomatik tutur. Bağlanmadan əvvəl əlavə hərəkət etmək lazımdırsa — daha yüksək prioritetlə callback qeydiyyatdan keçirin. Vacibdir: Dialog-da setCancelable(false) təyin etsəniz, callback işləməyəcək — bu sistem davranışıdır.

Jetpack Compose-da Back Press Handling

Jetpack Compose BackHandler composable funksiyası vasitəsilə “Geri” düyməsinin işlənməsi üçün deklarativ API təmin edir. BackHandler enabled (bool dəyəri) və onBack — basma zamanı çağırılan callback qəbul edir. enabled = false olarsa, basma zəncirlə daha irəli ötürülür.

Compose-da BackHandler

BackHandler avtomatik olaraq valideyn Activity-nin OnBackPressedDispatcher-də OnBackPressedCallback qeydiyyatdan keçirir. O, composable-in həyat dövrünü nəzərə alır: kompozisiyadan çıxdıqda callback silinir. enabled vəziyyətə bağlana bilər — məsələn, təsdiq dialoqunu yalnız formada saxlanmamış dəyişikliklər olduqda göstərmək.

@Composable
fun EditScreen(hasUnsavedChanges: Boolean) {
    BackHandler(enabled = hasUnsavedChanges) {
        // Təsdiq dialoqunu göstər
    }

    Column {
        TextField(value = ..., onValueChange = ...)
    }
}

Compose-da Predictive Back

Predictive back gesture Compose-da Compose 1.5.0-dan dəstəklənir. BackHandler cihazda aktiv olduqda sistem keçid animasiyasını avtomatik idarə edir. Fərdi predictive-animasiya üçün 0-dan 1-ə qədər jestin gedişatını qaytaran predictiveBackHandler modifikatorundan istifadə edin.

Tipik səhvlər və best practices

Back Press Handling sadə görünür, amma praktikada tərtibatçılar bir sıra sistematik səhvlərə yol verirlər. Google tövsiyələri və icma təcrübəsi əsasında ən çox yayılmış problemlərə və onların həll yollarına baxaq.

Səhv: naviqasiya yığınını yoxlamadan finish() çağırmaq

Birbaşa finish() çağırışı handleOnBackPressed-də naviqasiya yığınında fon ekranları varsa, tətbiqdən gözlənilmədən çıxmağa səbəb ola bilər. Activity-ni bağlamadan əvvəl həmişə Navigation Component və ya Coordinator vasitəsilə NavController.backStack-i yoxlayın.

Səhv: callback qeydiyyatında lifecycle-ı nəzərə almamaq

Callback-i LifecycleOwner olmadan (parametrsiz köhnə addCallback istifadə edərək) qeydiyyatdan keçirsəniz, callback əbədi yaşayacaq və Activity artıq məhv edilibsə NullPointerException yarada bilər. Həmişə LifecycleOwner ilə addCallback(this, callback) istifadə edin.

Best Practice: modal pəncərələr üçün zəncirin kəsilməsi

Modal pəncərələr (Bottom Sheet, Dialog) üçün həmişə isEnabled = true yalnız pəncərə görünəndə təyin edin. Pəncərənin vəziyyətini yoxlayan lambda ilə addCallback istifadə edin. Navigation Component NavHost üçün bunu avtomatik idarə edir.

Best Practice: ikiqat basmanın işlənməsi

Sürətli ikiqat “Geri” basması ikiqat finish() çağırışına səbəb ola bilər. 500 ms ərzində təkrar çağırışlardan qorunmaq üçün flag və ya throttleLast istifadə edin. Navigation Component bu vəziyyəti daxili olaraq idarə edir, lakin fərdi ssenarilərdə qorumanı əl ilə tətbiq etmək lazımdır.

private var lastBackPressTime = 0L

override fun handleOnBackPressed() {
    val currentTime = System.currentTimeMillis()
    if (currentTime - lastBackPressTime > 500) {
        lastBackPressTime = currentTime
        navigateBack()
    }
}