原生移动开发 / 系统课时
定义路由与页面跳转
定义路由与页面跳转
完成导航图后,真正容易出错的是“跳到哪里”和“返回后留下什么”。本节把路由集中定义,并分别实现普通进入、返回和替换三种语义,让每次操作后的返回栈都可预测。
学习目标
- 用稳定的路由常量注册并访问 Destination。
- 正确使用
navigate()、popBackStack()和popUpTo()。 - 区分普通进入、返回与“替换当前页面”的返回栈效果。
先把路由集中定义
小型示例可以直接使用字符串路由,但不要把 "home"、"edit" 这类字面量散落在各页面中。集中定义后,注册导航图和执行跳转都引用同一来源,至少能避免手写字符串不一致导致的目的地匹配错误。
完成进入、返回和替换
示例从首页进入编辑页。编辑完成后进入成功页,同时把编辑页从返回栈移除,这就是常见的“替换”效果:Navigation Compose 没有单独的 replace(),而是通过 navigate() 配合 popUpTo() 控制旧条目是否保留。
package com.example.routejump
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
object Routes {
const val Home = "home"
const val Edit = "edit"
const val Success = "success"
}
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
RouteDemo()
}
}
}
@Composable
fun RouteDemo() {
val navController = rememberNavController()
NavHost(navController, startDestination = Routes.Home) {
composable(Routes.Home) {
ActionScreen("Home", "进入编辑") {
navController.navigate(Routes.Edit)
}
}
composable(Routes.Edit) {
ActionScreen("Edit", "保存并完成") {
navController.navigate(Routes.Success) {
// 删除 Edit,再把 Success 放到栈顶,实现“替换当前页”。
popUpTo(Routes.Edit) {
inclusive = true
}
}
}
}
composable(Routes.Success) {
ActionScreen("Success", "返回首页") {
navController.popBackStack()
}
}
}
}
@Composable
fun ActionScreen(
title: String,
buttonText: String,
onClick: () -> Unit
) {
Column {
Text(title)
Button(onClick = onClick) {
Text(buttonText)
}
}
}预期结果
启动后返回栈为 [home]。
点击“进入编辑”后为 [home, edit]。
点击“保存并完成”后为 [home, success],edit 已被移除。
在 Success 点击“返回首页”后回到 Home,返回栈为 [home]。
三种跳转语义不要混用
普通进入使用 navigate(route),它会把新目的地压到栈顶,适合“首页进入详情”这类还要原路返回的场景。返回使用 popBackStack(),它删除当前栈顶并显示前一个目的地;如果没有可弹出的条目,返回值是 false。
所谓替换,关键不是显示新页面,而是清理旧页面。popUpTo(Routes.Edit) { inclusive = true } 表示一直弹到 edit,并且连 edit 自己也移除,再把 success 压栈。因此用户从成功页返回时不会重新进入编辑页。
防止重复跳转和误清栈
连续点击同一个按钮可能重复执行 navigate()。当目标已经位于栈顶且不希望再创建一份时,可以在导航选项中设置 launchSingleTop = true。它只阻止“栈顶目标的重复副本”,不会自动清理更早的同路由条目。
popUpTo() 的影响通常比 launchSingleTop 更大,因为它会删除一段返回历史。使用 inclusive = true 前先明确目标条目是否也应该消失;登录页、一次性表单、提交完成页这类流程尤其适合用栈变化图或调试日志先验证,再决定清理范围。