添加预测性返回手势
了解如何在你的 Android 应用中添加预测性返回手势。
该功能已在 Flutter 中落地,但 Android 本身尚未默认启用。你可以按以下说明试用。
配置你的应用
#
确保你的应用支持 Android API 33 或更高版本,因为预测性返回在更低版本的 Android 上无效。然后在 android/app/src/main/AndroidManifest.xml 中设置标志 android:enableOnBackInvokedCallback="true"。
配置你的设备
#你需要启用开发者模式并在设备上设置标志,因此尚不能指望大多数用户的 Android 设备上都能使用预测性返回。若你想在自己的设备上试用,请确保运行 API 33 或更高版本,然后在 Settings => System => Developer 选项中,确保 Predictive back animations 旁的开关已启用。
设置你的应用
#预测性返回的路由过渡目前默认未启用,因此暂时需要在你的应用中手动启用。通常通过在主题中设置即可:
MaterialApp(
theme: ThemeData(
pageTransitionsTheme: const PageTransitionsTheme(
builders: <TargetPlatform, PageTransitionsBuilder>{
// Set the predictive back transitions for Android.
TargetPlatform.android: PredictiveBackPageTransitionsBuilder(),
},
),
),
...
),
运行你的应用
#最后,请确保运行应用时至少使用 Flutter 3.22.2 版本,撰写本文时这是最新的稳定版。
更多信息
#你可以在以下链接找到更多信息:
-
Android predictive back breaking change
Android predictive back 破坏性变更
除非另有说明,本文档之所提及适用于 Flutter 3.44.0 版本。本页面最后更新时间:2026-06-04。查看文档源码 或者 为本页面内容提出建议。