navigationevent

  
Thư viện Navigation Event cung cấp một API ưu tiên KMP để xử lý thao tác quay lại hệ thống cũng như tính năng Xem trước thao tác quay lại.
Bản cập nhật mới nhất Bản phát hành ổn định Bản phát hành dùng thử Bản phát hành beta Bản phát hành alpha
Ngày 2 tháng 7 năm 2025 - - - 1.0.0-alpha04

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

Để thêm một phần phụ thuộc vào navigationevent, 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:

Groovy

dependencies {
    implementation "androidx.navigationevent:navigationevent:1.0.0-alpha04"
}

Kotlin

dependencies {
    implementation("androidx.navigationevent:navigationevent:1.0.0-alpha04")
}

Để 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-alpha04

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

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

Sửa lỗi

  • Đã dùng implementedInJetBrainsFork để navigationevent-compose và thêm mục tiêu commonStubs để khớp với các quy ước của Compose. Ivan Matkov của JetBrains yêu cầu thay đổi. (f60c79)
  • Đã khắc phục việc áp dụng trình bổ trợ trình biên dịch Compose cho Kotlin/Native để đảm bảo tạo đúng phần giữ chỗ. Không ảnh hưởng đến các API công khai hoặc hành vi. (1890c9)

Phiên bản 1.0.0-alpha03

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

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

Tính năng mới

  • Giới thiệu một mô-đun navigationevent-compose mới để hỗ trợ các tính năng của Jetpack Compose trong thư viện navigationevent. (980d78)
  • NavigationEvent Compose đã thêm một thành phần kết hợp cục bộ LocalNavigationEventDispatcherOwner mới. Hàm này trả về một giá trị rỗng để xác định rõ hơn liệu giá trị đó có trong cấu trúc hiện tại hay không. NavigationEventHandler hiện sẽ hiển thị lỗi nếu không tìm thấy chủ sở hữu cơ sở. (62ffda)
  • NavigationEvent Compose đã thêm một thành phần kết hợp NavigationEventHandler mới để xử lý các sự kiện (cử chỉ xem trước thao tác quay lại). Thư viện này cung cấp Flow của các đối tượng NavigationEvent mà bạn phải thu thập trong lambda tạm ngưng mà bạn cung cấp c42ba6: 
NavigationEventHandler { progress: Flow<NavigationEvent> ->
  // This block is executed when the back gesture begins.
  try {
    progress.collect { backEvent ->
      // Handle gesture progress updates here.
    }
    // This block is executed if the gesture completes successfully.
  } catch (e: CancellationException) {
    // This block is executed if the gesture is cancelled
    throw e
  } finally {
    // This block is executed either the gesture is completed or cancelled
  }
}

Thay đổi về API

  • Giờ đây, mỗi NavigationEventCallback chỉ có thể được đăng ký với một NavigationEventDispatcher tại một thời điểm; việc thêm NavigationEventCallback vào nhiều điều phối viên sẽ tạo ra một IllegalStateException. Xin lưu ý rằng hành vi này khác với OnBackPressedDispatcher, cho phép nhiều trình điều phối. (e82c19)
  • Tạo isPassThrough một val để ngăn chặn quá trình đột biến trong khi điều hướng, điều này có thể làm gián đoạn quá trình gửi NavigationEvent. (I0b287)

Phiên bản 1.0.0-alpha02

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

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

Thay đổi về API

  • Thay thế hàm khởi tạo phụ của NavigationEventDispatcher bằng các đối số mặc định. (I716a0)
  • Xoá thuộc tính ưu tiên khỏi NavigationEventCallback. Thay vào đó, hãy truyền mức độ ưu tiên đến NavigationEventDispatcher.addCallback(). (I13cae)

Sửa lỗi

  • Khắc phục ConcurrentModificationException có thể xảy ra khi NavigationEventCallback.remove() được gọi do đồng thời sửa đổi danh sách nội bộ các đối tượng có thể đóng. (b/420919815)

Phiên bản 1.0.0-alpha01

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

Phát hành androidx.navigationevent:navigationevent-*: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

  • Thư viện androidx.navigationevent cung cấp một API ưu tiên KMP để xử lý thao tác quay lại hệ thống cũng như tính năng Xem trước thao tác quay lại. NavigationEventDispatcher đóng vai trò là một API chung để đăng ký một hoặc nhiều thực thể NavigationEventCallback để nhận các sự kiện quay lại hệ thống.
  • Lớp này nằm bên dưới các API đã phát hành trước đó trong androidx.activity và nhằm mục đích thay thế ít ý kiến hơn cho việc sử dụng API Hoạt động trong các thành phần cấp cao hơn hoặc trực tiếp sử dụng API OnBackInvokedDispatcher của khung Android. Các API androidx.activity đã được viết lại dựa trên Navigation Event API trong Activity 1.12.0-alpha01.