原生移动开发 / 系统课时

导航状态保存与恢复

导航状态保存与恢复

本节解决 Compose 导航里最常见的“切换后丢位置”和“重复点击堆页面”问题:保存顶层目的地的返回栈、恢复已访问状态,并把页面 UI 状态与导航状态分开处理,使重选、返回和配置变化都有明确行为。

学习目标

  • 区分返回栈状态与页面 UI 状态各由谁保存
  • 使用 saveState、restoreState 和 launchSingleTop 管理顶层导航
  • 为重选当前入口和屏幕旋转定义可预测的恢复行为

先区分导航状态与页面状态

Navigation 保存的是“去过哪些目的地、返回时回到哪里”这类返回栈信息;输入框文本、筛选条件等页面状态则应由 Compose 或 ViewModel 保存。把两者混在一起,常见结果是返回栈恢复了,但页面内容重置,或者为了保留输入而手工复制整个导航历史。

对于可放进保存状态机制的小型 UI 数据,可使用 rememberSaveable;业务数据、网络结果和可重新加载的大对象应留在 ViewModel 或数据层,而不是塞进导航参数或保存状态包。

保存并恢复顶层返回栈

底部导航通常需要在多个顶层入口之间保留各自的位置。切换入口时,popUpTo(...){ saveState = true } 保存被弹出的栈,restoreState = true 在再次进入时恢复它,launchSingleTop = true 则避免当前顶层目标被重复压入栈顶。

底部导航多返回栈的保存、恢复与重选关系

片段示例:以下辅助函数用于已有的 Compose Navigation 项目;reselect 由底部导航项是否已经处于选中状态决定。

kotlin
import androidx.compose.material3.OutlinedTextField
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.navigation.NavGraph.Companion.findStartDestination
import androidx.navigation.NavHostController

fun NavHostController.selectTopLevel(route: String, reselect: Boolean) {
    if (reselect) {
        // 常见产品语义:再次点击当前入口时回到该入口根页。
        popBackStack(route, inclusive = false)
        return
    }

    navigate(route) {
        popUpTo(graph.findStartDestination().id) {
            // 切走前保存当前入口被弹出的返回栈与可保存状态。
            saveState = true
        }
        launchSingleTop = true
        restoreState = true
    }
}

@Composable
fun SearchScreen(modifier: Modifier = Modifier) {
    // 小型页面状态交给 rememberSaveable,应对 Activity 重建。
    var query by rememberSaveable { mutableStateOf("") }

    OutlinedTextField(
        value = query,
        onValueChange = { query = it },
        modifier = modifier
    )
}

预期结果:从 Home 的详情页切到 Search,再切回 Home 时会恢复先前保存的 Home 栈;重复进入同一顶层目标不会额外堆叠副本。Search 输入框中的文本在常见 Activity 重建场景下也能恢复。

明确定义重选与返回行为

“重选当前 Tab”没有唯一正确答案,必须由产品语义决定。上面的实现选择了常见规则:当前入口已选中时执行 popBackStack(route, inclusive = false),把该入口之上的详情页弹出,回到入口根页。

如果你的产品要求“重选后仍停在原位置”,则不要执行这个分支,继续使用 launchSingleTop 避免重复压栈即可。系统返回键则应让 NavController 按当前活动返回栈正常弹出,不要再维护一套平行的自定义页面栈。

配置变化与恢复边界

rememberNavController() 应在组合中稳定创建,不要因为普通状态变化反复重建控制器。页面里需要跨配置变化保存的小状态使用 rememberSaveable;需要跨页面共享或从数据源恢复的业务状态优先交给 ViewModel。

验证时至少覆盖三组动作:进入详情后切换顶层入口再切回、连续重选当前入口、在输入内容后旋转屏幕。三组行为分别对应返回栈恢复、重选策略和页面状态恢复,分开测试比只看“页面还在不在”更容易定位问题。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

导航状态保存与恢复

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通