Tahmine dayalı geri hareketi için destek eklendi

Şekil 1. Telefondaki tahmini geri hareketinin görünüm ve tarzını gösteren maket

Hareketle gezinme özelliği olan Tahmini Geri, kullanıcıların geri kaydırma hareketinin onları nereye götüreceğini önizlemelerine olanak tanır.

Örneğin, geri hareketi kullanarak uygulamanızın arkasındaki ana ekranın animasyonlu bir önizlemesini gösterebilirsiniz (Şekil 1'deki taslakta gösterildiği gibi).

Android 15'ten itibaren tahmine dayalı geri animasyonlar için geliştirici seçeneği kullanılamamaktadır. Ana sayfaya geri gitme, görevler arasında geçiş yapma ve etkinlikler arasında geçiş yapma gibi sistem animasyonları artık tahmini geri gitme hareketini tamamen veya etkinlik düzeyinde etkinleştiren uygulamalarda gösteriliyor.

Bu ana sayfaya dönme animasyonunu test edebilirsiniz (bu sayfanın sonraki bir bölümünde açıklandığı gibi).

Tahmini geri hareketi desteklemek için uygulamanızı, geriye dönük uyumlu OnBackPressedCallback AppCompat 1.6.0-alpha05 (AndroidX) veya daha yeni bir API'yi ya da yeni OnBackInvokedCallback platform API'sini kullanarak güncellemeniz gerekir. Çoğu uygulama, geriye dönük uyumlu AndroidX API'yi kullanır.

Bu güncelleme, geri gezinmeyi düzgün şekilde durdurmak için bir taşıma yolu sağlar. Bu yol, KeyEvent.KEYCODE_BACK'daki geri müdahaleleri ve Activity ve Dialog gibi onBackPressed yöntemlerine sahip tüm sınıfları yeni sistem geri API'leriyle değiştirmeyi içerir.

Not: Android 13, tahmini geri hareketini kullanıcılara göstermez ancak test için geliştirici seçeneği olarak kullanıcı arayüzünün erken bir sürümünü sağlar. Bu kullanıcı arayüzünü gelecekteki bir Android sürümünde kullanıcıların kullanımına sunmayı planlıyoruz. Bu süre zarfında, en son güncellemeleri alabilmeniz için uygulamanızı güncellemenizi önemle tavsiye ederiz.

Not: KeyEvent.KEYCODE_BACK için desteklenen bazı kullanım alanları olduğundan KeyEvent.KEYCODE_BACK desteği sonlandırılmamaktadır. Ancak KeyEvent.KEYCODE_BACK'den gelen geri etkinliklerin kesilmesi artık desteklenmez.

Codelab ve Google I/O videosu

Bu sayfada bulunan dokümanları kullanmanın yanı sıra codelab'imizi de deneyin. AndroidX Activity API'lerini kullanarak tahmini geri hareketini işleyen bir WebView'in ortak kullanım alanı uygulamasını sağlar.

AndroidX ve platform API'lerinin uygulanmasıyla ilgili ek örnekler içeren Google I/O videomuzu da izleyebilirsiniz.

Varsayılan geri gezinme özelliğini kullanan bir uygulamayı güncelleme

Uygulamanızda özel geri davranışı uygulanmıyorsa (yani geri işlemeyi sisteme bırakıyorsa) uygulamanızı bu özelliği destekleyecek şekilde güncellemek kolaydır. Bu kılavuzda açıklandığı şekilde bu özelliği etkinleştirin.

Uygulamanız Fragment veya Gezinme Bileşeni kullanıyorsa AndroidX Etkinliği 1.6.0-alpha05 veya sonraki bir sürüme de yükseltme yapın.

Özel geri gezinme kullanan bir uygulamayı güncelleme

Uygulamanız özel geri davranışı uyguluyorsa AndroidX'i kullanıp kullanmadığına ve geri gezinmeyi nasıl işlediğine bağlı olarak farklı taşıma yolları vardır.

Uygulamanız AndroidX kullanıyorsa	Uygulamanızın geri navigasyonu işleme şekli	Önerilen taşıma yolu (bu sayfadaki bağlantı)
Evet	AndroidX API'leri	Mevcut bir AndroidX arka uç 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şınabilir	Desteklenmeyen geri gezinme API'lerini kullanan bir uygulamayı platform API'lerine taşıma
	Desteklenmeyen platform API'leri ancak taşıma yapılamıyor	Bu özellik zorunlu hale gelene kadar etkinleştirmeyi erteleme

Önemli: Tahmini geri gezinme özelliğini en kısa sürede uygulamanızı önemle tavsiye ederiz. Aksi takdirde, kullanıcılar Android'in gelecekteki bir sürümünde beklenmedik davranışlarla karşılaşabilir.

AndroidX geri gezinme uygulamasını taşıma

Bu kullanım alanı en yaygın (ve en çok önerilen) kullanım alanıdır. Özel geri gezinme sağlama bölümünde açıklandığı gibi, OnBackPressedDispatcher ile özel hareket gezinme işlevini uygulayan yeni veya mevcut uygulamalar için geçerlidir.

Uygulamanız bu kategoriye uyuyorsa tahmini geri hareketi desteği eklemek için aşağıdaki adımları uygulayın:

1. Halihazırda OnBackPressedDispatcher API'lerini kullanan API'lerin (ör. Fragment'ler ve Gezinme Bileşeni) tahmini geri hareketiyle sorunsuz bir şekilde ç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"
   

2. Bu sayfada açıklandığı şekilde tahmini geri gitme hareketini etkinleştirin.

Desteklenmeyen geri gezinme API'leri içeren bir AndroidX uygulamasını AndroidX API'lerine taşıma

Uygulamanız AndroidX kitaplıklarını kullanıyorsa ancak desteklenmeyen geri gezinme API'lerini uyguluyorsa veya referans veriyorsa yeni davranışı desteklemek için AndroidX API'lerini kullanmaya geçmeniz gerekir.

Not: AndroidX kitaplıklarını kullanmanızı önemle tavsiye ederiz. AndroidX, özelliği etkinleştirdiğinizde uygulamanızda güncellenmiş sistem geri gezinme özelliğini otomatik olarak etkinleştirir. Ayrıca, size zaman ve iş tasarrufu sağlamak için her sürümde API'leri otomatik olarak güncelleyen birçok yararlı özellik de sunar.

Desteklenmeyen API'leri AndroidX API'lerine taşımak için:

1. OnBackPressedCallback uygulamasını kullanarak sistem geri işleme mantığınızı AndroidX'in OnBackPressedDispatcher sürümüne taşıyın. Ayrıntılı bilgi için Özel geri gezinme sağlama başlıklı makaleyi inceleyin.

2. Geri hareketini engellemeyi durdurmaya hazır olduğunuzda OnBackPressedCallback seçeneğini devre dışı bırakın.

3. OnBackPressed veya KeyEvent.KEYCODE_BACK aracılığıyla geri etkinliklerini durdurun.

4. AndroidX Activity 1.6.0-alpha05 sürümüne 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"
   

5. Uygulamanızı başarıyla taşıdıktan sonra, ana ekrana geri dönme sistem animasyonunu görmek için tahmini geri hareketi etkinleştirin (bu sayfada açıklandığı gibi).

   Not: android:enableOnBackInvokedCallback değerinden bağımsız olarak OnBackPressedCallback her zaman çağrılır. Diğer bir deyişle, sistem animasyonunu devre dışı bırakmak, OnBackPressedCallback kullanan uygulamanızın geri işleme mantığını etkilemez.

Desteklenmeyen geri gezinme API'lerini 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 uyguluyorsa veya bu özelliğe referans veriyorsa OnBackInvokedCallback platform API'sine geçmeniz gerekir.

Not: AndroidX kitaplıklarını kullanmanızı önemle tavsiye ederiz. AndroidX, özelliği etkinleştirdiğinizde uygulamanızda güncellenmiş sistem geri gezinme özelliğini otomatik olarak etkinleştirir. Ayrıca, size zaman ve iş tasarrufu sağlamak için her sürümde API'leri otomatik olarak güncelleyen birçok yararlı özellik de sunar.

Desteklenmeyen API'leri platform API'sine taşımak için aşağıdaki adımları tamamlayın:

1. 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 ise desteklenmeyen API'leri kullanın.

2. Özel geri mantığınızı OnBackInvokedCallback'e onBackInvokedDispatcher ile kaydedin. Bu işlem, mevcut etkinliğin tamamlanmasını engeller ve kullanıcı sistemde Geri gezinmeyi tamamladığında geri çağırma işleviniz Geri işlemine tepki verme şansı elde eder.

3. Geri hareketini durdurmaya hazır olduğunuzda OnBackInvokedCallback için kayıt silme işlemini yapın. Aksi takdirde, kullanıcılar sistem geri düğmesini kullanırken istenmeyen davranışlarla karşılaşabilir (ör. görünümler arasında "takılıp kalma" ve uygulamanızı kapatmaya zorlanmak).

   Mantığın onBackPressed'ten nasıl taşınacağına dair bir örnek aşağıda 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)
              */
           }
       );
     }
   }
   

4. Android 13 ve sonraki sürümlerde OnBackPressed veya KeyEvent.KEYCODE_BACK aracılığıyla geri etkinliklerinin engellenmesini durdurun.

5. Uygulamanızı başarıyla taşıdıktan sonra OnBackInvokedCallback'nin geçerli olması için tahmini geri hareketini etkinleştirin (bu sayfada açıklandığı şekilde).

Benzer AndroidX OnBackPressedCallback'ta kullanılamayan OnBackInvokedCallback'leri PRIORITY_DEFAULT veya PRIORITY_OVERLAY ile kaydedebilirsiniz. PRIORITY_OVERLAY ile geri arama kaydetme bazı durumlarda faydalı olabilir.

Bu durum, onKeyPreIme()'ten geçiş yaptığınızda ve geri çağırma işlevinizin açık bir IME yerine geri hareketini alması gerektiğinde geçerlidir. IME'ler açıldığında PRIORITY_DEFAULT ile geri çağırma işlevini kaydeder. OnBackInvokedDispatcher'un, açık IME yerine geri hareketini geri aramanıza göndermesini sağlamak için geri aramanızı PRIORITY_OVERLAY ile kaydedin.

Tahmini geri gitme hareketini etkinleştirme

Destek kaydınıza göre uygulamanızı nasıl güncelleyeceğinizi belirledikten sonra tahmini geri hareketi desteklemeyi etkinleştirin.

Etkinleştirmek için AndroidManifest.xml'teki <application> etiketinde android:enableOnBackInvokedCallback işaretini true olarak ayarlayın.

<application
    ...
    android:enableOnBackInvokedCallback="true"
    ... >
...
</application>

Değer sağlamazsanız varsayılan olarak false olur ve aşağıdakileri yapar:

• Tahmine dayalı geri hareketi sistem animasyonunu devre dışı bırakır.
• OnBackInvokedCallback çağrıları yoksayılır ancak OnBackPressedCallback çağrıları çalışmaya devam eder.

Etkinlik düzeyinde etkinleştirme

Android 14'ten itibaren android:enableOnBackInvokedCallback işaretçisi, tahmini sistem animasyonları özelliğini etkinlik düzeyinde etkinleştirmenize olanak tanır. Bu davranış, çok sayıda etkinliğe sahip büyük uygulamaları tahmini geri hareketlere taşımayı daha kolay hale getirir. Android 15'te tahmini geri artık geliştirici seçeneğinin arkasında değil. Uygulamalar, tahmini geri yüklemeyi tamamen veya etkinlik düzeyinde etkinleştirebilir.

Aşağıdaki kodda, MainActivity öğesinden ana sayfaya dönme sistemi animasyonunu etkinleştirmek için enableOnBackInvokedCallback öğesinin kullanımıyla ilgili 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>

Önceki örnekte, ".SecondActivity" için android:enableOnBackInvokedCallback=true ayarını yapmak etkinlik arası sistem animasyonunu etkinleştirir.

android:enableOnBackInvokedCallback işaretini kullanırken aşağıdaki hususları göz önünde bulundurun:

• android:enableOnBackInvokedCallback=false ayarı, etiketi ayarlamanıza bağlı olarak tahmini geri animasyonlarını etkinlik düzeyinde veya uygulama düzeyinde devre dışı bırakır ve sisteme OnBackInvokedCallback platform API'sine yapılan çağrıları yoksaymasını söyler. Ancak OnBackPressedCallback geriye dönük uyumlu olduğundan ve Android 13'ten önce desteklenmeyen onBackPressed API'yi çağırdığından OnBackPressedCallback çağrıları çalışmaya devam eder.
• enableOnBackInvokedCallback işaretini uygulama düzeyinde ayarlamak, uygulamadaki tüm etkinlikler için varsayılan değeri belirler. Önceki kod örneğinde gösterildiği gibi, işareti etkinlik düzeyinde ayarlayarak etkinlik başına varsayılan değeri geçersiz kılabilirsiniz.

Geri aramayla ilgili en iyi uygulamalar

Desteklenen sistem geri aramalarını (BackHandler (Oluştur için), OnBackPressedCallback veya OnBackInvokedCallback) kullanmayla ilgili en iyi uygulamaları aşağıda bulabilirsiniz.

Her geri çağırmayı etkinleştiren ve devre dışı bırakan kullanıcı arayüzü durumunu belirleyin

Kullanıcı arayüzü durumu, kullanıcı arayüzünü tanımlayan bir özelliktir. Aşağıdaki genel adımları uygulamanızı öneririz.

1. Her geri çağırmayı etkinleştiren ve devre dışı bırakan kullanıcı arayüzü durumunu belirleyin.

2. StateFlow veya Compose State gibi bir gözlenebilir veri tutucu türü kullanarak bu durumu tanımlayın ve durum değiştikçe geri çağırma işlevini etkinleştirin veya devre dışı bırakın.

Uygulamanız daha önce geri mantığını koşullu ifadelerle ilişkilendiriyorsa bu, geri etkinliğine zaten gerçekleştikten sonra tepki verdiğinizi gösterebilir. Yeni geri çağırmalarda bu kalıptan kaçının. Mümkünse geri aramayı koşullu ifadenin dışına taşıyın ve bunun yerine geri aramayı gözlemlenebilir bir veri tutucu türüyle ilişkilendirin.

Kullanıcı arayüzü mantığı için sistem geri geri çağırma işlevlerini kullanma

Kullanıcı arayüzü mantığı, kullanıcı arayüzünün nasıl görüntüleneceğini belirler. Kullanıcı arayüzü mantığını çalıştırmak için sistem geri geri çağırma işlevlerini kullanın (ör. pop-up görüntüleme veya animasyon çalıştırma).

Uygulamanız sistem geri geri çağırma işlevini etkinleştirirse tahmini animasyonlar çalışmaz ve geri etkinliğini işlemeniz gerekir. Yalnızca kullanıcı arayüzü olmayan mantık çalıştırmak için geri çağırma işlevi oluşturmayın.

Örneğin, geri etkinliklerini yalnızca günlüğe kaydetmek için durduruyorsanız bunun yerine etkinlik veya parça yaşam döngüsü içinde günlüğe kaydedin.

• Etkinlikten etkinliğe veya parçadan etkinliğe geçiş durumları için, onDestroy içindeki isFinishing'ün etkinlik yaşam döngüsü içinde true olup olmadığını günlüğe kaydedin.
• Parçadan parçaya durumlarda, onDestroy içinde isRemoving ifadesinin parçanın görüntüleme yaşam döngüsü içinde doğru olup olmadığını günlüğe kaydedin. Alternatif olarak, FragmentManager.OnBackStackChangedListener'de onBackStackChangeStarted veya onBackStackChangeCommitted yöntemlerini kullanarak giriş yapabilirsiniz.

Oluştur işlemi için, Oluştur hedefiyle ilişkili bir ViewModel öğesinin onCleared() geri çağırma işlevinde günlük kaydı oluşturun. Bu, bir oluşturma hedefinin arka yığıntan ne zaman kaldırıldığını ve yok edildiğini öğrenmek için en iyi sinyaldir.

Tek sorumluluk çağrısı oluşturma

Yöneticiye birden fazla geri çağırma ekleyebilirsiniz. Geri çağırma işlevleri, son eklenen etkin geri çağırma işlevinin bir sonraki geri hareketini her geri hareket için bir geri çağırma işleviyle işlediği bir yığına eklenir.

Tek bir sorumluluğu olan geri aramaların etkin durumunu yönetmek daha kolaydır. Örnek:

Şekil 2. Geri çağırma yığın şeması.

Şekil 2'de, yığınta her biri bir şeyden sorumlu olan birden fazla geri çağırma işlevi olabileceği gösterilmektedir. Geri çağırma işlevi yalnızca yığıntaki üstündeki geri çağırma işlevleri devre dışıysa çalışır. Bu örnekte, "Emin misiniz?" geri çağırma işlevi, kullanıcı bir forma veri girdiğinde etkinleştirilir ve aksi takdirde devre dışı bırakılır. Kullanıcı formu kapatmak için geri kaydırdığında geri arama, bir onay iletişim kutusu açar.

Diğer geri çağırma, tahmini geri çağırmayı destekleyen bir Material bileşeni, Progress API'lerini kullanan bir AndroidX geçişi veya başka bir özel geri çağırma içerebilir.

Yukarıdaki geri çağırmalar devre dışıysa ve childFragmentManager bir Fragment'e eklenmişse bu FragmentManager için geri yığın boş değilse childFragmentManager'nin geri çağırması çalışır. Bu örnekte, bu dahili geri çağırma devre dışı bırakılmıştır.

Benzer şekilde, yukarıdaki geri çağırmalar devre dışı bırakılırsa ve yığını boş değilse supportFragmentManager'ın dahili geri çağırması çalışır. NavigationComponent, FragmentManager'e dayandığı için bu davranış, gezinme için FragmentManager veya NavigationComponent kullanıldığında tutarlıdır. Bu örnekte, kullanıcı forma metin girmezse "Emin misiniz?" geri çağırma işlevinin devre dışı bırakılmasına neden olan bu geri çağırma işlevi çalıştırılır.

Son olarak, super.onBackPressed(), yukarıdaki geri çağırmalar devre dışı bırakılırsa yine çalışan sistem düzeyinde geri çağırma işlevidir. Ana sayfaya geri dönme, etkinlik ve görevler arası geçiş gibi sistem animasyonlarını tetiklemek için supportFragmentManager'ın geri yığınının boş olması gerekir. Böylece, dahili geri çağırma işlevi devre dışı bırakılır.

Tahmine dayalı geri hareketi animasyonunu test etme

Not: Android 15'te ana sayfaya geri gitme, görevler arasında geçiş yapma ve etkinlikler arasında geçiş yapma gibi sistem animasyonları artık geliştirici seçeneğinin arkasında değildir. Bu bildirimler artık tahmini geri hareketi tamamen veya etkinlik düzeyinde etkinleştiren uygulamalarda gösteriliyor.

Hâlâ Android 13 veya Android 14 kullanıyorsanız Şekil 1'de gösterilen ana ekrana dön animasyonunu test edebilirsiniz.

Bu animasyonu test etmek için aşağıdaki adımları uygulayın:

1. Cihazınızda Ayarlar > Sistem > Geliştirici seçenekleri'ne gidin.

2. Tahmine dayalı geri hareketi animasyonları'nı seçin.

3. Güncellenen uygulamanızı başlatın ve geri hareketini kullanarak uygulamanın nasıl çalıştığını görün.