原生移动开发 / 系统课时

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。

Navigation Compose 核心对象与返回栈关系

用最小导航图跑通一次

下面示例假定项目已经启用 Compose、Material 3,并加入 androidx.navigation:navigation-compose 依赖。两个页面只接收导航回调,页面本身不需要知道完整的 NavController,后续更容易测试和复用。

kotlin
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("返回")
        }
    }
}

预期结果

text
应用启动后显示 Home。
点击“打开详情”后显示 Detail,返回栈由 [home] 变为 [home, detail]。
点击“返回”后重新显示 Home,返回栈恢复为 [home]。

返回栈变化要按操作理解

把导航看成对栈的操作更不容易混淆。起始时只有 home;进入详情时是“压栈”,所以系统返回键或 popBackStack() 都能回到 home。如果再次从 home 进入 detail,会创建新的导航条目,而不是复用此前已经弹出的那个条目。

NavHost 负责承载当前目的地,NavController 负责决定下一步去哪里,Destination 负责描述“某条路由对应哪个内容”,返回栈则保存实际的访问历史。四者职责分开后,页面跳转、返回和深层导航都可以用同一套模型解释。

容易写错的边界

不要在每个页面内部都调用 rememberNavController()。那会创建彼此独立的控制器,页面之间不会共享同一个返回栈。通常应在导航图的上层创建一次控制器,再把导航意图作为回调传给各页面。

还要区分“页面返回”和 Activity 结束:popBackStack() 只操作这个控制器管理的返回栈。根目的地已经无栈可退时,应由更上层决定是否退出当前 Activity,而不是假设 popBackStack() 一定能完成返回。

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

目录与阅读设置

阅读设置

17

记录一个想法

Navigation Compose 基础

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

登录哪都通