原生移动开发 / 系统课时
底部导航与多入口页面
底部导航与多入口页面
这一节把多个一级页面接到同一个 NavigationBar,并让底部选中状态始终跟随真实导航目的地。重点不是画出三个按钮,而是避免重复入栈,同时在用户切换首页、搜索和我的页面时保存并恢复各入口的页面状态。
学习目标
- 用
NavigationBar和单个NavController管理多个一级入口 - 从当前返回栈目的地计算底部导航的选中状态
- 使用
saveState、restoreState与launchSingleTop避免状态丢失和重复入栈
让导航栏只负责选择入口
底部导航不是三个互相独立的页面容器。常见做法是让 NavigationBar 和 NavHost 共享一个 NavController:导航栏发出“切到哪个一级目的地”的意图,真正显示哪个页面仍由返回栈决定。

如果把选中的索引单独存成一个普通 remember 状态,它可能与返回栈脱节,例如系统返回键已经切换目的地,但底部仍高亮旧入口。更稳妥的做法是观察 currentBackStackEntryAsState(),由当前目的地反推哪个按钮应该选中。
准备导航依赖
下面是 app/build.gradle.kts 的片段示例。这里继续使用类型安全路由,因此需要 Navigation Compose 和 Kotlin Serialization。
plugins {
id("org.jetbrains.kotlin.plugin.serialization")
}
dependencies {
implementation("androidx.navigation:navigation-compose:2.10.0")
implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3")
}配置生效后,三个一级页面可以直接用可序列化对象作为路由,不需要维护 "home"、"search" 这类易拼错的字符串常量。
保存并恢复一级页面状态
下面的主示例为三个一级页面各放一个计数器。先在首页增加计数,再切到搜索,最后切回首页;如果导航选项正确,首页计数会保留。
package com.example.bottomnavdemo
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.Button
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.NavigationBar
import androidx.compose.material3.NavigationBarItem
import androidx.compose.material3.Scaffold
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.navigation.NavDestination.Companion.hasRoute
import androidx.navigation.NavGraph.Companion.findStartDestination
import androidx.navigation.NavHostController
import androidx.navigation.NavOptionsBuilder
import androidx.navigation.compose.NavHost
import androidx.navigation.compose.composable
import androidx.navigation.compose.currentBackStackEntryAsState
import androidx.navigation.compose.rememberNavController
import kotlinx.serialization.Serializable
@Serializable
data object Home
@Serializable
data object Search
@Serializable
data object Profile
private enum class TopDestination(
val label: String,
val iconText: String
) {
HOME("首页", "首"),
SEARCH("搜索", "搜"),
PROFILE("我的", "我")
}
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
MaterialTheme {
BottomNavApp()
}
}
}
}
@Composable
private fun BottomNavApp() {
val navController = rememberNavController()
val backStackEntry by navController.currentBackStackEntryAsState()
val currentDestination = backStackEntry?.destination
Scaffold(
bottomBar = {
NavigationBar {
TopDestination.entries.forEach { item ->
val selected = when (item) {
TopDestination.HOME ->
currentDestination?.hasRoute<Home>() == true
TopDestination.SEARCH ->
currentDestination?.hasRoute<Search>() == true
TopDestination.PROFILE ->
currentDestination?.hasRoute<Profile>() == true
}
NavigationBarItem(
selected = selected,
onClick = { navController.navigateTopLevel(item) },
icon = { Text(item.iconText) },
label = { Text(item.label) }
)
}
}
}
) { innerPadding ->
NavHost(
navController = navController,
startDestination = Home,
modifier = Modifier.padding(innerPadding)
) {
composable<Home> {
CounterScreen("首页")
}
composable<Search> {
CounterScreen("搜索")
}
composable<Profile> {
CounterScreen("我的")
}
}
}
}
private fun NavHostController.navigateTopLevel(item: TopDestination) {
val options: NavOptionsBuilder.() -> Unit = {
// 保存离开的一级目的地,并在回来时恢复。
popUpTo(graph.findStartDestination().id) {
saveState = true
}
launchSingleTop = true
restoreState = true
}
when (item) {
TopDestination.HOME -> navigate(Home, options)
TopDestination.SEARCH -> navigate(Search, options)
TopDestination.PROFILE -> navigate(Profile, options)
}
}
@Composable
private fun CounterScreen(title: String) {
var count by rememberSaveable { mutableIntStateOf(0) }
Column(
modifier = Modifier.fillMaxSize(),
verticalArrangement = Arrangement.Center,
horizontalAlignment = Alignment.CenterHorizontally
) {
Text("$title:count=$count")
Button(onClick = { count++ }) {
Text("加一")
}
}
}预期结果
启动:底部“首页”被选中,页面显示 首页:count=0
点击两次“加一”:首页显示 首页:count=2
切到“搜索”:底部“搜索”被选中,页面显示 搜索:count=0
再切回“首页”:底部“首页”重新被选中,页面仍显示 首页:count=2
连续点击已选中的“首页”不会不断创建重复的首页实例这里 launchSingleTop 负责避免对当前一级目的地重复入栈;popUpTo(...){ saveState = true } 在切换入口时保存被弹出目的地的状态;restoreState = true 在再次进入时尝试恢复它。三者解决的是不同问题,不应只保留其中一个。
多入口继续扩展时的边界
如果某个一级入口内部还有“列表 → 详情 → 编辑”这样的二级页面,底部选中判断不能只比较一个叶子页面名称,而应判断当前目的地是否属于该一级入口对应的导航层级。此时通常把每个一级入口组织为嵌套导航图,再基于目的地层级判断选中状态。
当一级入口越来越多,或大屏设备需要更适合横向空间的导航方式时,可以把“目的地定义”和“导航逻辑”保留不变,只将 NavigationBar 替换为更合适的导航组件;这样页面状态和返回栈规则无需跟着 UI 外壳重写。