navigation3

宣告依附元件

如要為 navigation3 新增依附元件，您必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

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

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

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 文件。

這個構件沒有任何版本資訊。

1.0 版本

1.0.0-alpha02 版

2025 年 5 月 23 日

發布 androidx.navigation3:navigation3-*:1.0.0-alpha02。1.0.0-alpha02 版包含這些修訂項目。

修正錯誤

• 修正 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 指南。