navigation3

  
Navigation 3 是一个旨在与 Compose 配合使用的新导航库。
最新更新 稳定版 发布候选版 Beta 版发布 Alpha 版发布
2025年6月4日 - - - 1.0.0-alpha03

声明依赖项

要添加对 navigation3 的依赖项,您必须将 Google Maven 代码库添加到您的项目中。如需了解详情,请参阅Google 的 Maven 代码库

在应用或模块的 build.gradle 文件中添加您所需工件的依赖项

Groovy

dependencies {
    implementation "androidx.navigation3.navigation3-runtime:1.0.0-alpha03"
    implementation "androidx.navigation3.navigation3-ui:1.0.0-alpha03"
}

Kotlin

dependencies {
    implementation("androidx.navigation3.navigation3-runtime:1.0.0-alpha03")
    implementation("androidx.navigation3.navigation3-ui:1.0.0-alpha03")
}

如需了解有关依赖项的更多信息,请参阅添加构建依赖项

反馈

您的反馈有助于改进 Jetpack。如果您发现新问题或对改进此库有任何建议,请告诉我们。在创建新问题之前,请查看此库中的现有问题。您可以通过点击星形按钮为您关注的现有问题投票。

创建新问题

如需了解详情,请参阅问题跟踪器文档

此工件没有发布说明。

版本 1.0

版本 1.0.0-alpha03

2025年6月4日

androidx.navigation3:navigation3-*:1.0.0-alpha03 已发布。版本 1.0.0-alpha03 包含这些提交

Bug 修复

  • Navigation3 将不再清除已被替换为另一个 backStack 实例的 backStacks 的装饰器状态。(I28a42, b/415076044

版本 1.0.0-alpha02

2025年5月23日

androidx.navigation3:navigation3-*:1.0.0-alpha02 已发布。版本 1.0.0-alpha02 包含这些提交

Bug 修复

  • 修复了 SavedStateNavEntryDecorator 的一个问题,该问题会导致具有相同属性值的不同数据类发生冲突。(b/418070648, Iff4775
  • 修复了在未声明显式依赖项的情况下运行会导致崩溃的类缺失问题。(b/419049149, I4b4ed

版本 1.0.0-alpha01

2025年5月20日

androidx.navigation3:navigation3-*:1.0.0-alpha01 已发布。版本 1.0.0-alpha01 包含这些提交

新功能

Navigation3 是一个专门为处理 Jetpack Compose 应用内导航而构建的新导航库。androidx.navigation3.runtime 工件提供了构建基块,而 androidx.navigation3.ui 工件通过 NavDisplay API 提供了 UI 层。开发者可以直接将自己的状态提供给 NavDisplay 可组合函数,该函数会根据开发者状态的变化来更改内容。

@Serialiable object Home : NavKey
@Serialiable object Chat : NavKey

val backStack = rememberNavBackStack(Home)

NavDisplay(backStack, entryProvider = entryProvider {
  entry<Home> {
    Column {
      Text(Home)
      Button(onClick = { backStack.add(Chat) } ) {
        Text(Go to Chat)
      } 
    }
  }
  entry<Chat> { /* My Composable Content */ }
})

如需了解详情,请参阅 Navigation3 指南