navigation3

Khai báo phần phụ thuộc

Để thêm một phần phụ thuộc vào navigation3, bạn phải thêm kho lưu trữ Google Maven vào dự án. Đọc nội dung Kho lưu trữ Maven của Google để biết thêm thông tin.

Thêm các phần phụ thuộc cho cấu phần phần mềm bạn cần trong tệp build.gradle cho ứng dụng hoặc mô-đun:

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

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

Để biết thêm thông tin về các phần phụ thuộc, hãy xem bài viết Thêm phần phụ thuộc vào bản dựng.

Ý kiến phản hồi

Ý kiến phản hồi của bạn có thể giúp chúng tôi cải thiện Jetpack. Hãy cho chúng tôi biết nếu bạn phát hiện lỗi mới hoặc có ý tưởng cải thiện thư viện này. Vui lòng xem các lỗi hiện có trong thư viện này trước khi báo một lỗi mới. Bạn có thể thêm lượt bình chọn cho lỗi hiện có bằng cách nhấp vào nút dấu sao.

Báo lỗi mới

Xem tài liệu về Công cụ theo dõi lỗi để biết thêm thông tin.

Không có ghi chú phát hành cho cấu phần phần mềm này.

Phiên bản 1.0

Phiên bản 1.0.0-alpha05

Ngày 2 tháng 7 năm 2025

Phát hành androidx.navigation3:navigation3-*:1.0.0-alpha05. Phiên bản 1.0.0-alpha05 bao gồm các thay đổi sau.

Thay đổi về hành vi

• Giờ đây, trạng thái của NavEntry hoàn toàn dựa trên danh sách hiện tại của các đối tượng trang trí được truyền đến NavDisplay. Điều này có nghĩa là bạn nên hoán đổi các đối tượng trang trí dọc theo ngăn xếp lui trong trường hợp có nhiều ngăn xếp lui để giữ nguyên trạng thái của NavEntry trên ngăn xếp lui. Nếu không, các trạng thái sẽ bị xoá như thể các mục đã được bật lên (thay vì hoán đổi). (I7a759, b/428033667)

Phiên bản 1.0.0-alpha04

Ngày 18 tháng 6 năm 2025

Phát hành androidx.navigation3:navigation3-*:1.0.0-alpha04. Phiên bản 1.0.0-alpha04 bao gồm các thay đổi sau.

Thay đổi về API

• NavEntry.content hiện ở chế độ riêng tư. Để gọi nội dung NavEntry, hãy gọi API NavEntry.Content() mới. API này không còn yêu cầu tham số key để gọi nữa. (Icd0fd, b/420991203)
• NavEntry.key hiện là một trường riêng tư. NavEntry và các trạng thái có liên quan phải được xác định bằng trường contentKey mới được tạo từ lambda contentKeyFactory mới và mặc định là một hàm băm có thể lưu được tạo từ NavEntry.key (I81a6c, b/422001357, b/420991203 I2d7d4, b/420991203, b/422841812)

Thay đổi về phần phụ thuộc

• Navigation3 hiện phụ thuộc vào cấu phần phần mềm androidx.navigationevent.compose mới.

Phiên bản 1.0.0-alpha03

Ngày 4 tháng 6 năm 2025

Phát hành androidx.navigation3:navigation3-*:1.0.0-alpha03. Phiên bản 1.0.0-alpha03 bao gồm các thay đổi sau.

Sửa lỗi

• Navigation3 sẽ không còn xoá các trạng thái của đối tượng trang trí cho backStacks đã được thay thế bằng một thực thể backStack khác. (I28a42, b/415076044)

Phiên bản 1.0.0-alpha02

Ngày 23 tháng 5 năm 2025

Phát hành androidx.navigation3:navigation3-*:1.0.0-alpha02. Phiên bản 1.0.0-alpha02 bao gồm các thay đổi sau.

Sửa lỗi

• Đã khắc phục một vấn đề với SavedStateNavEntryDecorator gây ra xung đột cho các lớp dữ liệu khác nhau có cùng giá trị thuộc tính. (b/418070648, Iff4775)
• Khắc phục vấn đề thiếu lớp gây ra sự cố khi chạy mà không khai báo các phần phụ thuộc rõ ràng. (b/419049149, I4b4ed)

Phiên bản 1.0.0-alpha01

Ngày 20 tháng 5 năm 2025

Phát hành androidx.navigation3:navigation3-*:1.0.0-alpha01. Phiên bản 1.0.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Navigation3 là một thư viện điều hướng mới được xây dựng dành riêng cho việc xử lý hoạt động điều hướng trong ứng dụng Jetpack Compose. Cấu phần phần mềm androidx.navigation3.runtime cung cấp các khối dựng, trong khi cấu phần phần mềm androidx.navigation3.ui cung cấp lớp giao diện người dùng thông qua API NavDisplay. Nhà phát triển có thể cung cấp trạng thái riêng của họ trực tiếp cho hàm có khả năng kết hợp NavDisplay. Hàm này sẽ thay đổi nội dung dựa trên các thay đổi về trạng thái của nhà phát triển.

@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 */ }
})

Để biết thêm thông tin, hãy xem hướng dẫn về Navigation3.