![](https://developer.android.com/static/images/about/versions/13/predictive-back-nav-home.gif?authuser=7&hl=tr)
Android 14 (API düzeyi 34), özel animasyonlar oluşturmak için ek sistem animasyonları ve API'ler için destek sağlar. Daha fazla bilgi için Yerleşik ve özel tahmine dayalı geri animasyonlar için destek ekleme bölümünü inceleyin.
Örneğin, geri hareketi kullandığınızda, Şekil 1'deki modelde gösterildiği gibi, uygulamanızın arkasındaki Ana ekranın animasyonlu bir önizlemesini görüntüleyebilirsiniz. Android 13'ten itibaren bir geliştirici seçeneğini etkinleştirerek (bu sayfada açıklandığı gibi) bu ana ekrana dönüş animasyonunu test edebilirsiniz.
Tahmine dayalı geri hareketini desteklemek için uygulamanızın geriye dönük uyumlu
OnBackPressedCallback
AppCompat 1.6.0-alpha05
(AndroidX) veya sonraki bir API ya da yeni OnBackInvokedCallback
platform API'si ile güncellenmesi gerekir. Çoğu uygulama, geriye dönük uyumlu AndroidX API'sini kullanır.
Bu güncelleme, geri gezinmeye düzgün bir şekilde müdahale etmek için bir taşıma yolu sağlar. Bu kapsamda, KeyEvent.KEYCODE_BACK
kaynaklı geri müdahaleler ve Activity
ile Dialog
gibi onBackPressed
yöntemlerine sahip tüm sınıflar yeni geri gezinme API'leriyle değiştirilir.
Codelab ve Google I/O videosu
Bu sayfadaki belgelerden yararlanmanın yanı sıra codelab'imizi de deneyin. AndroidX Activity API'lerini kullanarak tahmini geri hareketini işleyen bir WebView'un yaygın bir kullanım alanı uygulamasını sunar.
AndroidX ve platform API'lerini uygulamayla ilgili diğer örneklerin ele alındığı Google I/O videomuzu da izleyebilirsiniz.
Varsayılan geri navigasyonu kullanan bir uygulamayı güncelleme
Uygulamanız herhangi bir özel geri davranışı uygulamıyorsa (yani işlem tekrar sisteme bırakılıyorsa) bu özelliği desteklemek için uygulamanızı güncellemek oldukça kolaydır. Bu kılavuzda açıklandığı şekilde bu özelliği etkinleştirin.
Uygulamanız Parçalar veya Gezinme Bileşeni kullanıyorsa AndroidX Etkinlik 1.6.0-alpha05 veya sonraki bir sürüme de geçin.
Özel geri gezinme özelliğini kullanan bir uygulamayı güncelleme
Uygulamanızda özel geri gezinme davranışı kullanılıyorsa uygulamanızın AndroidX kullanıp kullanmadığına ve geri gezinmeyi işleme şekline bağlı olarak farklı taşıma yolları vardır.
Uygulamanız AndroidX kullanıyor | Uygulamanız geri navigasyonu nasıl işler? | Önerilen taşıma yolu (bu sayfadaki bağlantı) |
Evet | AndroidX API'leri | Mevcut bir AndroidX geri uygulamasını taşıma |
Desteklenmeyen platform API'leri | Desteklenmeyen geri gezinme API'leri içeren bir AndroidX uygulamasını AndroidX API'lerine taşıma | |
Hayır | Desteklenmeyen platform API'leri, taşınabiliyor | Desteklenmeyen geri gezinme API'leri kullanan bir uygulamayı platform API'lerine taşıma |
Platform API'leri desteklenmiyor ancak taşınamıyor | Bu gerekli bir özellik haline gelene kadar etkinleştirme işlemini ertele |
AndroidX geri gezinme uygulamasını taşıma
Bu, en yaygın (ve en çok önerilen) kullanım alanıdır. Bu, Özel geri gezinme sağlama bölümünde açıklandığı gibi OnBackPressedDispatcher
ile özel hareketle gezinme özelliğini uygulayan yeni veya mevcut uygulamalar için geçerlidir.
Uygulamanız bu kategoriye uygunsa tahmini geri hareketi için destek eklemek üzere şu adımları izleyin:
Halihazırda
OnBackPressedDispatcher
API'lerini kullanan API'lerin (ör. Parçalar ve Gezinme Bileşeni) tahmine dayalı geri hareketiyle sorunsuz çalışmasını sağlamak için AndroidX Activity 1.6.0-alpha05 sürümüne geçin.// In your build.gradle file: dependencies { // Add this in addition to your other dependencies implementation "androidx.activity:activity:1.6.0-alpha05"
Bu sayfada açıklandığı şekilde tahmini geri hareketini etkinleştirin.
Desteklenmeyen geri gezinme API'leri içeren bir AndroidX uygulamasını AndroidX API'lerine taşı
Uygulamanız AndroidX kitaplıkları kullanıyor ancak desteklenmeyen geri gezinme API'lerini uyguluyor veya bunlara referans veriyorsa yeni davranışı desteklemek için AndroidX API'lerine geçiş yapmanız gerekir.
Desteklenmeyen API'leri AndroidX API'lerine taşımak için:
OnBackPressedCallback
uygulayarak sisteminizi AndroidX'inOnBackPressedDispatcher
uygulamasına geri taşıyın. Ayrıntılı bilgi için Özel geri gezinme sağlama bölümüne bakın.Geri hareketine müdahale etmeyi durdurmaya hazır olduğunuzda
OnBackPressedCallback
öğesini devre dışı bırakın.OnBackPressed
veyaKeyEvent.KEYCODE_BACK
aracılığıyla etkinliklere müdahale etmeyi durdurun.AndroidX Etkinlik 1.6.0-alpha05'e geçtiğinizden emin olun.
// In your build.gradle file: dependencies { // Add this in addition to your other dependencies implementation "androidx.activity:activity:1.6.0-alpha05"
Uygulamanızı başarıyla taşıdıktan sonra ana ekrana dönüş sistem animasyonunu görmek için tahmini geri hareketini etkinleştirin (bu sayfada açıklandığı gibi).
Desteklenmeyen geri gezinme API'leri kullanan bir uygulamayı platform API'lerine taşıma
Uygulamanız AndroidX kitaplıklarını kullanamıyorsa ve bunun yerine desteklenmeyen API'leri kullanarak özel Geri gezinme özelliğini uyguluyor veya bunlara referans veriyorsa OnBackInvokedCallback
platform API'sine geçmeniz gerekir.
Desteklenmeyen API'leri platform API'sine taşımak için aşağıdaki adımları tamamlayın:
Android 13 veya sonraki sürümleri çalıştıran cihazlarda yeni
OnBackInvokedCallback
API'yi, Android 12 veya önceki sürümleri çalıştıran cihazlarda desteklenmeyen API'lerden yararlanın.OnBackInvokedCallback
içindeki özel geri mantığınızıonBackInvokedDispatcher
ile kaydedin. Bu, geçerli etkinliğin tamamlanmasını engeller ve kullanıcı sistemin Geri gezinmesini tamamladıktan sonra geri çağırmanızın Geri işlemine tepki verme fırsatı olur.Geri hareketine müdahale etmeyi durdurmaya hazır olduğunuzda
OnBackInvokedCallback
öğesinin kaydını iptal edin. Aksi takdirde, kullanıcılar bir sistemin Geri gezinme menüsünü kullanırken istenmeyen davranışlarla karşılaşabilir. Örneğin, görünümler arasında "takılıp takılma" ve bunları uygulamanızdan kapanmaya zorlama.Aşağıda,
onBackPressed
mantığının dışına nasıl taşınacağına dair bir örnek verilmiştir:Kotlin
@Override fun onCreate() { if (BuildCompat.isAtLeastT()) { onBackInvokedDispatcher.registerOnBackInvokedCallback( OnBackInvokedDispatcher.PRIORITY_DEFAULT ) { /** * onBackPressed logic goes here. For instance: * Prevents closing the app to go home screen when in the * middle of entering data to a form * or from accidentally leaving a fragment with a WebView in it * * Unregistering the callback to stop intercepting the back gesture: * When the user transitions to the topmost screen (activity, fragment) * in the BackStack, unregister the callback by using * OnBackInvokeDispatcher.unregisterOnBackInvokedCallback * (https://developer.android.com/reference/kotlin/android/window/OnBackInvokedDispatcher#unregisteronbackinvokedcallback) */ } } }
Java
@Override void onCreate() { if (BuildCompat.isAtLeastT()) { getOnBackInvokedDispatcher().registerOnBackInvokedCallback( OnBackInvokedDispatcher.PRIORITY_DEFAULT, () -> { /** * onBackPressed logic goes here - For instance: * Prevents closing the app to go home screen when in the * middle of entering data to a form * or from accidentally leaving a fragment with a WebView in it * * Unregistering the callback to stop intercepting the back gesture: * When the user transitions to the topmost screen (activity, fragment) * in the BackStack, unregister the callback by using * OnBackInvokeDispatcher.unregisterOnBackInvokedCallback * (https://developer.android.com/reference/kotlin/android/view/OnBackInvokedDispatcher#unregisteronbackinvokedcallback) */ } ); } }
Android 13 ve sonraki sürümlerde
OnBackPressed
veyaKeyEvent.KEYCODE_BACK
aracılığıyla etkinliklere müdahale etmeyi durdurun.Uygulamanızı başarıyla taşıdıktan sonra
OnBackInvokedCallback
'ın geçerli olması için tahmini geri hareketini etkinleştirin (bu sayfada açıklandığı gibi).
PRIORITY_DEFAULT
veya PRIORITY_OVERLAY
ile bir OnBackInvokedCallback
kaydettirebilirsiniz. Bu özellik AndroidX'in benzer sürümünde
OnBackPressedCallback
bulunmaz. PRIORITY_OVERLAY
ile bir geri arama kaydetmek bazı durumlarda faydalıdır. Bu durum, onKeyPreIme()
ürününden geçiş yaptığınızda ve geri aramanızın açık IME yerine geri hareketini alması gerektiğinde geçerli olabilir. IME'ler, açıldığında PRIORITY_DEFAULT
ile geri çağırma kaydeder.
OnBackInvokedDispatcher
tarafından geri aramanızın açık IME yerine geri arama işlevine gönderileceğinden emin olmak için geri arama işleminizi PRIORITY_OVERLAY
ile kaydedin.
Tahmine dayalı geri hareketini etkinleştirme
Uygulamanızı vakanıza göre nasıl güncelleyeceğinizi belirledikten sonra, tahmine dayalı geri hareketini desteklemeyi etkinleştirin.
Etkinleştirmek için AndroidManifest.xml
içindeki <application>
etiketinde android:enableOnBackInvokedCallback
işaretini true
olarak ayarlayın.
<application
...
android:enableOnBackInvokedCallback="true"
... >
...
</application>
Bir değer sağlamazsanız varsayılan olarak false
olur ve şu işlemler gerçekleşir:
- Tahmine dayalı geri hareketi sistem animasyonunu devre dışı bırakır.
OnBackInvokedCallback
öğesini yoksayar ancakOnBackPressedCallback
çağrıları çalışmaya devam eder.
Etkinlik düzeyinde etkinleştirme
android:enableOnBackInvokedCallback
işareti, Android 14'ten itibaren etkinlik düzeyinde tahmine dayalı sistem animasyonlarını etkinleştirmenize olanak tanır. Bu davranış, büyük çok etkinlikli uygulamaların tahmine dayalı geri hareketlerine taşınmasını daha kolay hale getirir.
Aşağıdaki kodda MainActivity
öğesinden eve dönüş sistem animasyonunu etkinleştirmek için enableOnBackInvokedCallback
özelliğinin kullanıldığı bir örnek gösterilmektedir:
<manifest ...>
<application . . .
android:enableOnBackInvokedCallback="false">
<activity
android:name=".MainActivity"
android:enableOnBackInvokedCallback="true"
...
</activity>
<activity
android:name=".SecondActivity"
android:enableOnBackInvokedCallback="false"
...
</activity>
</application>
</manifest>
Yukarıdaki örnekte ".SecondActivity"
için android:enableOnBackInvokedCallback=true
politikasının ayarlanması, etkinlikler arası sistem animasyonunu etkinleştirir.
android:enableOnBackInvokedCallback
işaretini kullanırken aşağıdaki noktaları göz önünde bulundurun:
android:enableOnBackInvokedCallback=false
ayarlandığında, etiketi ayarladığınız yere bağlı olarak etkinlik düzeyinde veya uygulama düzeyinde tahmine dayalı geri animasyonlar devre dışı bırakılır ve sistemeOnBackInvokedCallback
platform API'sine yapılan çağrıları yoksayması talimatı verilir. AncakOnBackPressedCallback
geriye dönük uyumlu olduğu ve Android 13'ten önceki sürümlerde desteklenmeyenonBackPressed
API'sini çağırdığı içinOnBackPressedCallback
çağrıları çalışmaya devam eder.enableOnBackInvokedCallback
işaretini uygulama düzeyinde ayarlamak, uygulamadaki tüm etkinlikler için varsayılan değeri oluşturur. Önceki kod örneğinde gösterildiği gibi, etkinlik seviyesinde işareti ayarlayarak etkinlik başına varsayılan değeri geçersiz kılabilirsiniz.
Geri arama ile ilgili en iyi uygulamalar
Desteklenen sistem geri çağırmalarının kullanımıyla ilgili en iyi uygulamalar şunlardır:
BackHandler
(Oluşturma için), OnBackPressedCallback
veya OnBackInvokedCallback
.
Her geri çağırmayı etkinleştiren ve devre dışı bırakan kullanıcı arayüzü durumunu belirleme
Kullanıcı arayüzü durumu, kullanıcı arayüzünü açıklayan bir özelliktir. Aşağıdaki üst düzey adımları uygulamanızı öneririz.
Her bir geri çağırmayı etkinleştiren ve devre dışı bırakan kullanıcı arayüzü durumunu belirleyin.
Bu durumu
StateFlow
veya Oluşturma Durumu gibi gözlemlenebilir veri sahibi türünü kullanarak tanımlayın ve durum değiştikçe geri çağırmayı etkinleştirin ya da devre dışı bırakın.
Uygulamanız daha önce mantığı koşullu ifadelerle ilişkilendiriyorsa bu, geri etkinliğine zaten gerçekleştikten sonra tepki verdiğinizi gösterebilir. Bu, yeni geri çağırmalarda kaçınmanız gereken bir kalıptır. Mümkünse geri çağırmayı koşullu ifadenin dışına taşıyın ve bunun yerine geri çağırmayı gözlemlenebilir bir veri sahibi türüyle ilişkilendirin.
UI Logic için sistem geri çağırmalarını kullan
Kullanıcı arayüzü mantığı, kullanıcı arayüzünün nasıl görüntüleneceğini belirler. Pop-up görüntüleme veya animasyon çalıştırma gibi kullanıcı arayüzü mantığı çalıştırmak için sistem geri çağırma işlevlerini kullanın.
Uygulamanız sistem geri çağırma özelliğini etkinleştirirse tahmine dayalı animasyonlar çalışmaz ve geri etkinliği işlemeniz gerekir. Yalnızca kullanıcı arayüzü dışı mantığı çalıştırmak için geri çağırma oluşturmayın.
Örneğin, yalnızca günlüğe kaydetmek üzere etkinlikleri geri çekiyorsanız bunun yerine Etkinlik veya Parça yaşam döngüsünde günlük kaydı oluşturun.
- Etkinlik-etkinliğe yönelik durumlar veya parçadan etkinliğe dönüş durumları için,
onDestroy
içindekiisFinishing
değerinin Etkinlik yaşam döngüsündetrue
olması durumunda günlüğe kaydedin. - Parçadan parçaya durumlar için
onDestroy
içindekiisRemoving
değeri, Parçanın görünüm yaşam döngüsünde doğruysa günlüğe veyaFragmentManager.OnBackStackChangedListener
içindeonBackStackChangeStarted
ya daonBackStackChangeCommitted
yöntemlerini kullanarak günlüğe kaydedin.
Compose destek kaydı için Compose hedefiyle ilişkili bir ViewModel
öğesinin onCleared()
geri çağırmasına giriş yapın. Bu, oluşturma hedefinin arka yığından ne zaman çıkarılıp kaldırıldığını öğrenmek için en iyi sinyaldir.
Tek sorumluluk geri çağırmaları oluşturun
Bu, sevk görevlisine birden fazla geri arama ekleyebildiğinizden mümkündür. Geri çağırma işlevleri, son eklenen etkin geri çağırmanın her geri çağırma hareketiyle bir sonraki geri hareketini işlediği bir yığına eklenir.
Tahmine dayalı geri hareketi animasyonunu test etme
Android 13'ün son sürümünden itibaren, şekil 1'de gösterilen ana sayfaya dönüş animasyonunu test etmek için bir geliştirici seçeneği etkinleştirebileceksiniz.
Bu animasyonu test etmek için aşağıdaki adımları tamamlayın:
Cihazınızda Ayarlar > Sistem > Geliştirici seçenekleri'ne gidin.
Tahmine dayalı geri animasyonlar'ı seçin.
Güncellenen uygulamanızı başlatın ve çalışır halde görmek için geri hareketini kullanın.