更新您的应用以支持预测性返回手势

图 1：预测性返回手势在手机上的外观和风格模拟

Android 13 将针对手机、大屏设备和可折叠设备等 Android 设备引入预测性返回手势。完全实现后，此功能将使用户能够在完全执行返回手势之前预览返回手势的目的地或其他效果，这样他们就可以决定是继续操作还是留在当前视图中。

例如，使用返回手势可以在应用后面显示主屏幕的动画预览，如图 1 中的模型所示。从 Android 13 最终版开始，您应该能够通过启用开发者选项来测试此返回主屏幕动画（如本页所述）。

如需支持预测性返回手势，您需要使用 OnBackPressedCallback AppCompat 1.6.0-alpha03 (AndroidX) 或更高版本的 API，或使用新的 OnBackInvokedCallback 平台 API。

此更新为不再受支持的返回导航 API 提供了迁移路径，这些 API 包括 KeyEvent.KEYCODE_BACK 以及任何包含 onBackPressed 方法（例如 Activity 和 Dialog）的类。

注意：在 Android 13 最终版本发布之前，用户无法看到预测性返回手势的动画组件。在此期间，我们强烈建议您更新应用，以确保获取最新的更新。在此版本之后，我们将增加对新动画的支持。

Codelab

除了参考本页的文档外，您还可以尝试我们的 Codelab，其中提供了使用 AndroidX Activity APIs 处理预测性返回手势的常见 WebView 用例实现。

更新使用默认返回导航的应用

如果您的应用未实现任何自定义返回行为（换言之，由系统处理返回导航），则更新应用以支持此功能非常简单。只需按照本页中的说明选择启用此功能即可。

更新使用自定义返回导航的应用

如果您的应用实现了自定义返回行为，则有不同的迁移路径，具体取决于它是否使用了 AndroidX 以及它如何处理返回导航。

您的应用是否使用了 AndroidX	您的应用会如何处理返回导航	推荐的迁移路径（此页面上的链接）
是	AndroidX APIs	迁移现有的 AndroidX 返回实现
	不受支持的平台 API	将包含不受支持的返回导航 API 的 AndroidX 应用迁移至 AndroidX API
否	不受支持的平台 API，可以迁移	将使用不受支持的返回导航 API 的应用迁移至平台 API
	不受支持的平台 API，但无法迁移	推迟选择启用此功能，直到此功能成为必要功能为止

注意：如果您未在 Android 13 之后的下一个主要 Android 版本推出之前更新应用，则用户在运行您的应用时会遇到返回导航中断的情况。

迁移 AndroidX 返回导航实现

此用例最常见（也最推荐）。它适用于使用 OnBackPressedDispatcher 实现自定义手势导航处理功能的新应用或现有应用，如提供自定义返回导航中所述。

如果您的应用属于此类别，您只需选择启用本页介绍的预测性返回手势，即可添加对预测性返回手势的支持。

将包含不受支持的返回导航 API 的 AndroidX 应用迁移至 AndroidX API

如果您的应用使用 AndroidX 库，但会实现或引用不受支持的返回导航 API，则需要改用 AndroidX API 来支持新行为。

注意：我们强烈建议您使用 AndroidX 库。当您启用此功能后，AndroidX 会自动在您的应用内启用更新后的系统返回导航，并且还会提供许多其他实用功能，这些功能会随着每个版本的发布自动更新 API，从而为您节省工作量和时间。

如需将不受支持的 API 迁移到 AndroidX API，请执行以下操作：

1. 通过实现 OnBackPressedCallback 将系统返回导航处理逻辑迁移到 AndroidX 的 OnBackPressedDispatcher。如需获得详细指导，请参阅提供自定义返回导航。

2. 如需停止拦截系统返回导航，请停用之前启用的所有 OnBackPressedCallback 实例，或者任何时候都不启用任何回调。

3. 成功迁移应用后，请按照本页面中的说明选择启用预测性返回手势。

将使用不受支持的返回导航 API 的应用迁移至平台 API

如果您的应用无法使用 AndroidX 库，而是使用不受支持的 API 实现或引用自定义返回导航，您必须迁移到 OnBackInvokedCallback 平台 API。

注意：我们强烈建议您使用 AndroidX 库。当您启用此功能后，AndroidX 会自动在您的应用内启用更新后的系统返回导航，并且还会提供许多其他实用功能，这些功能会随着每个版本的发布自动更新 API，从而为您节省工作量和时间。

完成以下步骤，将不受支持的 API 迁移到平台 API：

1. 在搭载 Android 13 或更高版本的设备上使用新的 OnBackInvokedCallback API，并在搭载 Android 12 或更低版本的设备上依赖不受支持的 API。

2. 在 OnBackInvokedCallback 中使用 onBackInvoked 方法中的逻辑注册自定义返回逻辑。这样可防止当前 activity 完成，并且当用户完成系统返回导航后，您的回调有机会对返回操作做出响应。

3. 为了确保未来对系统返回导航的增强功能得到适当支持，您的应用必须取消注册 OnBackInvokedCallback。否则，使用系统返回导航时，用户可能会看到不希望出现的行为，例如在视图之间“卡住”并强制退出应用。

   以下示例展示了如何从 onBackPressed 迁移出逻辑：

   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/view/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. 成功迁移应用后，请按照下文所述采用预测性返回手势。

选择启用预测性返回手势

根据具体情况确定如何更新应用后，就可以轻松地选择支持预测性返回手势。

如需选择启用预测性返回手势，请在 AndroidManifest.xml 的 <application> 标记中将 android:enableOnBackInvokedCallback 标志设置为 true。

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

如果您未提供值，则默认为 false 并停用预测性返回手势。

测试预测性返回手势动画

注意：在 Android 13 最终发布之前，该预测性返回手势功能的组件将无法使用。请参阅时间表、里程碑和更新以了解更多详情。

从 Android 13 最终版本开始，您应该能够启用一个开发者选项来测试图 1 中所示的返回主屏幕动画。

如需测试此动画，请完成以下步骤：

1. 在您的设备上，依次转到设置 > 系统 > 开发者选项。

2. 选择预测性返回手势动画。

3. 启动更新后的应用，然后执行返回手势，看看实际运行效果。