Android退出App显示确认对话框的新方案（适配Navigation Component）

在API 33及以上版本中，onBackPressed()已被标记为过时，且在使用Navigation Component的场景下，Fragment返回会触发Activity的onBackPressed()，导致误弹出退出确认对话框。以下是适配Navigation Component的新实现方案：

核心思路 #

利用AndroidX提供的OnBackPressedCallback和OnBackPressedDispatcher，区分两种返回场景：

• 当当前页面是导航图的起始目的地（即首页）时，弹出退出确认对话框
• 当当前页面是其他Fragment时，正常执行Fragment间的返回逻辑
• 若特定Fragment需要自定义返回行为，可在Fragment内部注册独立的返回回调，拦截Activity的返回逻辑

具体实现 #

1. Activity层面处理退出确认 #

在宿主Activity中注册全局返回回调，判断当前导航目的地是否为起始页，再决定是否弹出退出对话框：

class MainActivity : AppCompatActivity() {
    private lateinit var navController: NavController

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        navController = findNavController(R.id.nav_host_fragment)

        // 注册返回键回调
        onBackPressedDispatcher.addCallback(this, object : OnBackPressedCallback(true) {
            override fun handleOnBackPressed() {
                // 检查当前是否处于导航图的起始页面
                val isStartDestination = navController.currentDestination?.id == navController.graph.startDestinationId
                if (isStartDestination) {
                    // 弹出退出确认对话框
                    AlertDialog.Builder(this@MainActivity)
                        .setTitle("确认退出")
                        .setMessage("确定要退出应用吗？")
                        .setPositiveButton("确定") { _, _ -> finish() }
                        .setNegativeButton("取消", null)
                        .show()
                } else {
                    // 非起始页，让Navigation组件正常返回上一个Fragment
                    navController.popBackStack()
                }
            }
        })
    }
}

2. Fragment层面自定义返回逻辑 #

如果某个Fragment需要拦截返回事件（比如有未保存的表单、弹窗等），可在Fragment内部注册独立的OnBackPressedCallback，优先级高于Activity的回调：

class EditProfileFragment : Fragment() {
    private lateinit var navController: NavController

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        navController = findNavController()

        // 注册Fragment专属的返回回调
        requireActivity().onBackPressedDispatcher.addCallback(this, object : OnBackPressedCallback(true) {
            override fun handleOnBackPressed() {
                // 自定义Fragment的返回逻辑，比如提示保存内容
                AlertDialog.Builder(requireContext())
                    .setTitle("提示")
                    .setMessage("您有未保存的修改，确定离开吗？")
                    .setPositiveButton("确定") { _, _ ->
                        // 允许返回，移除当前回调并执行Fragment返回
                        navController.popBackStack()
                        this.remove()
                    }
                    .setNegativeButton("取消", null)
                    .show()
            }
        })
    }
}

关键说明 #

• OnBackPressedCallback的enabled参数设为true时，回调处于激活状态，会优先拦截返回事件；设为false则会跳过该回调
• 绑定到Fragment的OnBackPressedCallback会在Fragment销毁时自动移除，无需手动清理
• 通过navController.currentDestination?.id判断当前页面，确保只有在首页才触发退出确认逻辑

内容的提问来源于stack exchange，提问作者Swaminath Bera