navigationevent

  
Thư viện Sự kiện điều hướng cung cấp một API KMP-first để xử lý thao tác quay lại hệ thống cũng như tính năng Quay lại dự đoán.
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 18 tháng 6 năm 2025 - - - 1.0.0-alpha03

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

Để thêm một phần phụ thuộc trên 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-alpha03"
}

Kotlin

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

Để 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-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ô-đun navigationevent-compose mới để hỗ trợ các tính năng Jetpack Compose trong thư viện navigationevent. (980d78)
  • NavigationEvent Compose đã thêm một thành phần cục bộ LocalNavigationEventDispatcherOwner mới. Phương thức này trả về một giá trị rỗng để xác định rõ hơn liệu giá trị đó có trong thành phần hiện tại hay không. NavigationEventHandler hiện sẽ gửi 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). Phương thức này cung cấp Flow của các đối tượng NavigationEvent phải được thu thập trong hàm 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 trình điều phối sẽ gửi 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 isPassThrough thành val để ngăn chặn việc đột biến trong quá trình điều hướng, điều này có thể làm hỏng việc điều phối của 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 priority 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ủa 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 KMP-first để xử lý thao tác quay lại hệ thống cũng như tính năng Quay lại theo dự đoán. NavigationEventDispatcher đóng vai trò là API phổ biến để đăng ký một hoặc nhiều thực thể NavigationEventCallback nhằm 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 chủ quan 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 API Sự kiện điều hướng trong Activity 1.12.0-alpha01.