Android'de Back Press Handling: özü, mekanizmaları ve uygulanması

Back Press Handling Nedir

Back Press Handling, kullanıcı donanımsal veya yazılımsal Geri butonuna bastığında ne olacağını belirleyen Android'deki bir sistem mekanizmasıdır. Bağlama bağlı olarak, basma şunları yapabilir: geçerli ekranı kapatıp öncekine dönmek, klavyeyi gizlemek, Drawer veya Bottom Sheet'i kapatmak, kullanıcı kök ekrandaysa uygulamadan çıkmak.

Geri butonunun davranışı her Android sürümüyle evrimleşmiştir. Android 10 jest navigasyonunu tanıttı, Android 11 OnBackPressedDispatcher'i standart API olarak tanıttı ve Android 13, eylem fiilen yürütülmeden önce sistemin bir geçiş animasyonu gösterdiği gelişmiş predictive back gesture desteğini getirdi. Google, tüm cihazlarda tahmin edilebilir ve tutarlı Back Press davranışına doğru istikrarlı bir şekilde ilerlemektedir.

Geri butonunun doğru şekilde işlenmesi, bir Android uygulamasında kritik bir UX öğesidir. Kullanıcı, Geri'ye basmanın onu navigasyon yığınındaki önceki ekrana döndürmesini bekler, uygulamanın beklenmedik şekilde kapanmasını değil. Bu beklentiyi ihlal etmek, Google Play'deki olumsuz yorumların ve düşük puanların ana nedenlerinden biridir.

Back Press API'nin Evrimi: onBackPressed'den OnBackPressedDispatcher'a

Android'deki Back Press API'sinin tarihi, platformun genel evrimini yansıtır: Activity'deki basit bir yöntemden, yaşam döngüsü desteği ve Compose ile esnek bir callback sistemine. Geliştirmenin üç aşamasını inceleyelim.

onBackPressed Çağı (API Level 1–30)

İlk Android API'sinden itibaren, Geri butonu Activity sınıfının onBackPressed yönteminde işleniyordu. Geliştirici bu yöntemi geçersiz kılar ve kendi mantığını yazardı. Sorun, Fragment ve View'ın basmayı yakalayamamasıydı — tüm kontrol Activity üzerinden gidiyordu. Bu, şişkin Activity'lere ve basmayı kimin işlemesi gerektiğini belirlemek için karmaşık if-else zincirlerine yol açtı.

OnBackPressedDispatcher'ın Gelişi (Activity 1.0.0)

Activity 1.0.0 (AndroidX) ile Google, OnBackPressedDispatcher'ı tanıttı. Bu, herhangi bir bileşenden — Activity, Fragment, Dialog, özel View — callback kabul eden merkezi bir dağıtıcıdır. Callback'ler bir sırayla (priority aracılığıyla) kaydedilir ve dinamik olarak eklenebilir veya kaldırılabilir. OnBackPressedDispatcher, eski onBackPressed'ten önce çağrılır ve Activity'nin işlemesinden önce basmanın yakalanmasına izin verir.

Predictive Back Gesture (Android 13+)

Android 13, predictive back gesture'ü tanıttı — kullanıcı hareketi tamamlamadan önce Geri tuşuna basmanın nereye götüreceğini gösteren bir sistem animasyonu. Bu animasyonu desteklemek için geliştiricilerin OnBackPressedDispatcher'ı kullanması ve isEnabled özelliği aracılığıyla callback'in sistem animasyonunu destekleyip desteklemediğini belirtmesi gerekir. Callback, predictive animation'ı desteklemezse, sistem uygulama bağlamıyla eşleşmeyebilecek varsayılan bir animasyon gösterir.

OnBackPressedDispatcher — Mimari ve callback zinciri

OnBackPressedDispatcher, yeni Back Press API'sinin çekirdeğidir. Bir callback zincirini yönetir ve ilki olayı işleyene kadar bunları sırayla çağırır. Hiçbir callback basmayı işlemezse, dağıtıcı varsayılan eylemi gerçekleştirir — bir Activity için finish() veya Navigation Component için popBackStack() çağırmak.

Öncelikle callback kaydetme

Bir callback, bir LifecycleOwner ve OnBackPressedCallback nesnesi ile addCallback aracılığıyla kaydedilir. Callback'in bir isEnabled özelliği vardır — false olarak ayarlanırsa callback atlanır. Öncelik için, 0 (en düşük) ile Integer.MAX_VALUE arasında bir değer iletebilirsiniz. Fragment Activity Result API, yaşam döngüsüne bağlı callback'lerin otomatik olarak kaydedilmesi için bu mekanizmayı kullanır.

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 temizlik

Callback'ler, LifecycleOwner DESTROYED durumuna geçtiğinde otomatik olarak kaldırılır. Bu, ekran döndürme sırasında callback sızıntıları sorununu çözer. Bir Fragment'a callback eklenirse, Fragment yok edildiğinde kaldırılacağı garanti edilir. Bir callback'i geçici olarak devre dışı bırakmak için isEnabled özelliğini kullanın — kaldırma ve yeniden kaydetme olmadan değiştirebilirsiniz.

Çağrı zinciri

Çağrı sırası, ekleme sırasının tersidir: en son eklenen callback önce kontrolü alır. Bu mantıklıdır çünkü en iç içe geçmiş UI öğesi (örneğin, bir Fragment içindeki Bottom Sheet), üst Fragment'inden önce basmayı işlemelidir. En derin callback basmayı işlemezse (isEnabled = false), kontrol zincirdeki bir sonrakine geçer.

Fragment ve Diyaloglarda Back Press

Fragment API, requireActivity().onBackPressedDispatcher yöntemi aracılığıyla OnBackPressedDispatcher ile kendi entegrasyonunu sağlar. Fragment 1.2.0'dan itibaren, her Fragment kendi callback'ini kaydedebilir; bu, otomatik olarak Fragment yaşam döngüsüne bağlanır ve yok edildiğinde kaldırılır.

Fragment'te callback

Bir Fragment'te callback kaydı onCreate, onViewCreated veya hatta View'in kendisinde yapılır — önemli olan LifecycleOwner'ın (Fragment) aktif olmasıdır. Fragment STARTED durumuna geçtiğinde callback etkinleştirilir; STOPPED olduğunda devre dışı bırakılır. Bu, gizli bir Fragment'in (ViewPager'da) Geri basmasını işlememesini sağlar.

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 ve BottomSheetDialog

Diyaloglar ve BottomSheet'ler, kapanmak için Geri basmasını otomatik olarak yakalar. Kapanmadan önce ek bir eylem gerçekleştirmeniz gerekiyorsa — daha yüksek öncelikli bir callback kaydedin. Önemli: Bir Dialog'da setCancelable(false) ayarlarsanız, callback tetiklenmez — bu sistem davranışıdır.

Jetpack Compose'da Back Press Handling

Jetpack Compose, BackHandler composable işlevi aracılığıyla Geri butonunu işlemek için bildirimsel bir API sağlar. BackHandler, enabled (boolean durum) ve onBack — basıldığında çağrılan bir callback — kabul eder. enabled = false ise, basma zincirde daha aşağı iletilir.

Compose'da BackHandler

BackHandler, üst Activity'nin OnBackPressedDispatcher'ında otomatik olarak bir OnBackPressedCallback kaydeder. Composable yaşam döngüsüne saygı duyar: kompozisyondan çıkıldığında callback kaldırılır. enabled, duruma bağlanabilir — örneğin, yalnızca formda kaydedilmemiş değişiklikler varsa bir onay diyaloğu göstermek.

@Composable
fun EditScreen(hasUnsavedChanges: Boolean) {
    BackHandler(enabled = hasUnsavedChanges) {
        // Show confirmation dialog
    }

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

Compose'da Predictive Back

Compose'da Predictive back gesture, Compose 1.5.0'dan itibaren desteklenmektedir. BackHandler, cihazda etkinleştirilmişse sistem geçiş animasyonunu otomatik olarak işler. Özel predictive animasyonu için, jest ilerlemesini 0'dan 1'e döndüren predictiveBackHandler değiştiricisini kullanın.

Yaygın Hatalar ve En İyi Uygulamalar

Back Press Handling basit görünür, ancak pratikte geliştiriciler bir dizi sistematik hata yapar. Google'ın önerilerine ve topluluk deneyimine dayanarak en yaygın sorunları ve çözümlerini inceleyelim.

Hata: navigasyon yığınını kontrol etmeden finish() çağırmak

handleOnBackPressed'te doğrudan finish() çağırmak, navigasyon yığınında arka plan ekranları varsa beklenmedik uygulama çıkışına neden olabilir. Activity'yi kapatmadan önce her zaman Navigation Component veya Coordinator aracılığıyla NavController.backStack'i kontrol edin.

Hata: callback kaydederken yaşam döngüsünü yoksaymak

Bir callback'i LifecycleOwner olmadan kaydederseniz (parametresiz eski addCallback'i kullanarak), callback sonsuza kadar yaşar ve Activity zaten yok edilmişse NullPointerException'a neden olabilir. Her zaman bir LifecycleOwner ile addCallback(this, callback) kullanın.

En iyi uygulama: modal pencereler için zinciri kırmak

Modal pencereler (Bottom Sheet, Dialog) için, isEnabled = true'yu yalnızca pencere görünür olduğunda ayarlayın. Pencere durumunu kontrol eden bir lambda ile addCallback kullanın. Navigation Component, NavHost için bunu otomatik olarak yönetir.

En iyi uygulama: çift basmayı işleme

Hızlı çift Geri basması, finish()'in çift çağrılmasına neden olabilir. 500 ms içinde tekrarlanan çağrılara karşı korunmak için bir bayrak veya throttleLast kullanın. Navigation Component bu durumu yerel olarak işler, ancak özel senaryolarda korumayı manuel olarak uygulamanız gerekir.

private var lastBackPressTime = 0L

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