原生移动开发 / 系统课时
Navigation Compose 基础
Navigation Compose 基础
Navigation Compose 的核心不是“切换两个 Composable”,而是由控制器维护导航图与返回栈,再由 NavHost 显示当前目的地。本节用一个最小示例把 NavController、NavHost、Destination 和返回栈的职责一次讲清。
学习目标
- 说明 NavController、NavHost 与 Destination 各自负责什么。
- 根据
navigate()与popBackStack()判断返回栈如何变化。 - 写出一个可进入详情页并返回的最小导航图。
四个对象如何协作
rememberNavController() 创建并记住一个 NavHostController,应用通常把它放在导航图的拥有者位置。NavHost 绑定这个控制器,并用 startDestination 指定首次展示的目的地。每个 composable(route) 注册一个 Destination;当控制器切换目的地时,NavHost 才组合对应页面。
返回栈记录的不是“页面截图”,而是一组导航栈条目。执行 navigate("detail") 会把新的目的地压栈;执行 popBackStack() 会尝试弹出栈顶并回到前一个条目。处在起始目的地且已经没有可弹出的条目时,popBackStack() 会返回 false。

用最小导航图跑通一次
下面示例假定项目已经启用 Compose、Material 3,并加入 androidx.navigation:navigation-compose 依赖。两个页面只接收导航回调,页面本身不需要知道完整的 NavController,后续更容易测试和复用。
package com.example.navigationbasic
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.Column
import androidx.compose.material3.Button
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.navigation.compose.NavHost
import androidx.navigation.compose.composable
import androidx.navigation.compose.rememberNavController
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
NavigationDemo()
}
}
}
@Composable
fun NavigationDemo() {
val navController = rememberNavController()
NavHost(
navController = navController,
startDestination = "home"
) {
composable("home") {
HomeScreen(onOpenDetail = {
navController.navigate("detail")
})
}
composable("detail") {
DetailScreen(onBack = {
navController.popBackStack()
})
}
}
}
@Composable
fun HomeScreen(onOpenDetail: () -> Unit) {
Column {
Text("Home")
Button(onClick = onOpenDetail) {
Text("打开详情")
}
}
}
@Composable
fun DetailScreen(onBack: () -> Unit) {
Column {
Text("Detail")
Button(onClick = onBack) {
Text("返回")
}
}
}预期结果
应用启动后显示 Home。
点击“打开详情”后显示 Detail,返回栈由 [home] 变为 [home, detail]。
点击“返回”后重新显示 Home,返回栈恢复为 [home]。返回栈变化要按操作理解
把导航看成对栈的操作更不容易混淆。起始时只有 home;进入详情时是“压栈”,所以系统返回键或 popBackStack() 都能回到 home。如果再次从 home 进入 detail,会创建新的导航条目,而不是复用此前已经弹出的那个条目。
NavHost 负责承载当前目的地,NavController 负责决定下一步去哪里,Destination 负责描述“某条路由对应哪个内容”,返回栈则保存实际的访问历史。四者职责分开后,页面跳转、返回和深层导航都可以用同一套模型解释。
容易写错的边界
不要在每个页面内部都调用 rememberNavController()。那会创建彼此独立的控制器,页面之间不会共享同一个返回栈。通常应在导航图的上层创建一次控制器,再把导航意图作为回调传给各页面。
还要区分“页面返回”和 Activity 结束:popBackStack() 只操作这个控制器管理的返回栈。根目的地已经无栈可退时,应由更上层决定是否退出当前 Activity,而不是假设 popBackStack() 一定能完成返回。