Tahmine dayalı geri hareketi için destek eklendi

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 artık kullanılamıyor. 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 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).

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'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öntemleri içeren tüm sınıfları yeni sistem geri API'leriyle değiştirmeyi içerir.

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'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ız herhangi bir özel geri davranışı uygulamıyorsa (diğer bir deyişle, işleri tekrar sisteme bırakı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 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.

AndroidX geri gezinme uygulamasını taşıma

Bu, en yaygın (ve en önerilen) kullanım alanıdır. Özel geri gezinme sağlama bölümünde açıklandığı gibi, OnBackPressedDispatcher ile özel hareket gezinme işlevi 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.

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 sunma başlıklı makaleyi inceleyin.

2. Geri hareketine müdahale etmeyi durdurmaya hazır olduğunuzda OnBackPressedCallback öğesini devre dışı bırakın.

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

4. 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"
   

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).

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 uyguluyorsa veya bu özelliğe 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:

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 desteklenmeyen API'lerden yararlanı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 yanıt 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 zorlanmaları).

   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)
              */
           }
       );
     }
   }

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

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).

PRIORITY_DEFAULT veya PRIORITY_OVERLAY ile bir OnBackInvokedCallback kaydettirebilirsiniz. Bu işlev, benzer AndroidXOnBackPressedCallback sürümünde sunulmaz. PRIORITY_OVERLAY ile geri arama kaydetme bazı durumlarda faydalıdır.

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 ürününün, açık IME yerine geri aramanıza geri aramasını gönderdiğinden emin olmak için geri arama işleminizi PRIORITY_OVERLAY ile kaydedin.

Tahmini geri gitme 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'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:enableOnBackInvokedCallback işareti, Android 14'ten itibaren etkinlik düzeyinde tahmine dayalı sistem animasyonlarını etkinleştirmenize olanak tanır. Bu davranış, çok 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'ten ana ekrana dönme sistemi animasyonunu etkinleştirmek için enableOnBackInvokedCallback 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. 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, önceki etkinlik gerçekleştikten sonra geri etkinliğine 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ü dışı mantığı çalıştırmak için geri çağırma oluşturmayın.

Örneğin, geri etkinliklerini yalnızca günlüğe kaydetmek için durduruyorsanız bunun yerine Activity veya Fragment yaşam döngüsü içinde 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'de, yığınta her biri bir şeyden sorumlu olan birden fazla geri çağırma işlevi olabileceği gösterilmektedir. Geri çağırma, yalnızca yığında kendi üzerindeki geri çağırmalar devre dışı bırakılırsa ç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ğırma işlevleri devre dışı bırakılırsa ve bu FragmentManager için geri yığını boş değilse childFragmentManager öğesinin geri çağırması çalışır. childFragmentManager bir Parçanın içine eklenir. Bu örnekte, bu dahili geri çağırma devre dışıdı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 "Emin misiniz..." geri çağırmasının devre dışı bırakılmasına neden olacak bir metin girmediyse bu geri çağırma yapı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

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ı tamamlayı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 çalışır halde görmek için geri hareketini kullanın.