công cụ chọn ảnh

  
Thư viện này cung cấp một công cụ tích hợp cho Chế độ xem Compose và Android cho công cụ chọn ảnh được nhúng.
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 21 tháng 10 năm 2026 - - - 1.0.0-alpha03

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

Để thêm một phần phụ thuộc trên PhotoPicker, bạn phải thêm kho lưu trữ Maven của Google 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 {
    // For apps using Compose
    implementation "androidx.photopicker:photopicker-compose:1.0.0-alpha03"
    // For apps using Android views
    implementation "androidx.photopicker:photopicker:1.0.0-alpha03"
}
    

Kotlin

dependencies {
    // For apps using Compose
    implementation("androidx.photopicker:photopicker-compose:1.0.0-alpha03")
    // For apps using Android views
    implementation("androidx.photopicker:photopicker: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ề Trình theo dõi sự cố để 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 21 tháng 10 năm 2026

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

Thay đổi về API

  • Thêm EXTRA_SYSTEM_FALLBACK_PICK_IMAGES_REQUEST_LOCATION_METADATA_ACCESS vào PickVisualMedia để cho phép yêu cầu quyền truy cập vào siêu dữ liệu vị trí trong bộ chọn dự phòng của hệ thống. (Ie5917)
  • Đổi tên cấu phần phần mềm androidx.photopicker:photopicker thành androidx.photopicker:photopicker-embedded (gói androidx.photopicker.embedded), androidx.photopicker:photopicker-compose thành androidx.photopicker:photopicker-embedded-compose (gói androidx.photopicker.embedded.compose) và androidx.photopicker:photopicker-testing thành androidx.photopicker:photopicker-embedded-testing (gói androidx.photopicker.embedded.testing). (I48b9b, b/537430760)
  • Cải tiến EmbeddedPhotoPickerState để hiển thị surfacePackage và notifyVisibilityChanged, đồng thời thêm lệnh gọi lại onError. (Ifa4b0)
  • Thêm setLocationMetadataAccessRequested vào PickVisualMediaRequest để cho phép yêu cầu quyền truy cập vào siêu dữ liệu vị trí trong các yêu cầu của Công cụ chọn ảnh. (Idde80)
  • Di chuyển các hợp đồng PickVisualMedia và PickMultipleVisualMedia, cũng như PickVisualMediaRequest sang cấu phần phần mềm photopicker-activity mới. Đã sao chép các bài kiểm tra. (I2a201, b/530216959)
  • Xoá tham số inputs khỏi rememberEmbeddedPhotoPickerState. Để đặt lại trạng thái khi dữ liệu đầu vào thay đổi, hãy gói lệnh gọi trong một khối key. (I8a0c5)
  • Giảm minSdk của thư viện androidx.photopicker:photopicker và androidx.photopicker:photopicker-compose xuống còn 23. (I94e42, b/524083018)
  • Revising Embedded PhotoPicker Compose APIs (Ie32c9)
  • Thư viện mới cho Công cụ chọn ảnh (I0f52a)
  • Thư viện thử nghiệm mới cho công cụ chọn ảnh (I7c1ec)

Sửa lỗi

  • Phần phụ thuộc androidx.lifecycle:lifecycle-runtime đã được cập nhật lên phiên bản 2.10.0. Bạn cần có phiên bản này để chạy các quy trình kiểm tra tìm lỗi mã nguồn trong thời gian chạy của vòng đời đi kèm với AGP phiên bản 9.5.0-alpha04 trở lên. (I99bfd, b/556807521)
  • compileSdk cho thư viện Compose được cập nhật lên phiên bản 37.1. Việc này sẽ yêu cầu cập nhật bắc cầu compileSdk cho tất cả ứng dụng và thư viện sử dụng Compose. (I05b0f)
  • Cập nhật compileSdk của Compose lên API 37. Điều này có nghĩa là bạn cần có AGP phiên bản tối thiểu là 9.2.0 khi sử dụng Compose. (Id45cd)

Phiên bản 1.0.0-alpha02

Ngày 1 tháng 7 năm 2026

Phát hành androidx.photopicker:photopicker:1.0.0-alpha02, androidx.photopicker:photopicker-compose:1.0.0-alpha02 và androidx.photopicker:photopicker-testing:1.0.0-alpha02. Phiên bản 1.0.0-alpha02 bao gồm các thay đổi sau.

Thay đổi về API

  • Hạ minSdk của thư viện androidx.photopicker:photopicker và androidx.photopicker:photopicker-compose xuống 23, trong khi các API vẫn cần được gọi từ 34. (I94e42, b/524083018)
  • Cập nhật API Compose của Công cụ chọn ảnh được nhúng (xoá AbstractEmbeddedPhotoPickerState, đổi tên và thay đổi chế độ hiển thị của một số trường trong EmbeddedPhotoPickerState) (Ie32c9, b/449786033)

Sửa lỗi

  • Cập nhật compileSdk của Compose lên API 37. Điều này có nghĩa là bạn cần có AGP phiên bản tối thiểu là 9.2.0 khi sử dụng Compose. (Ic748a, b/413674743)

Phiên bản 1.0.0-alpha01

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

Phát hành androidx.photopicker:photopicker:1.0.0-alpha01, androidx.photopicker:photopicker-compose:1.0.0-alpha01 và androidx.photopicker:photopicker-testing: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

  • Bản phát hành alpha đầu tiên của các phương thức triển khai androidx cho Công cụ chọn ảnh được nhúng, cho phép cả ứng dụng dựa trên Khung hiển thị và ứng dụng dựa trên Compose dễ dàng tích hợp với dịch vụ Công cụ chọn ảnh được nhúng.

Thay đổi về API

  • Thêm thành phần kết hợp EmbeddedPhotopicker làm điểm truy cập cho các ứng dụng dựa trên Compose.
    • Bạn có thể sử dụng rememberEmbeddedPhotoPickerState (nên dùng) hoặc các ứng dụng có thể triển khai tính năng quản lý trạng thái riêng bằng giao diện EmbeddedPhotoPickerState.
  • Thêm EmbeddedPhotopickerView làm điểm truy cập cho các ứng dụng dựa trên khung hiển thị.
    • Bạn có thể dùng EmbeddedPhotoPickerStateChangeListener để nhận các lệnh gọi lại liên quan đến trạng thái bên trong PhotoPicker.
  • Thêm TestEmbeddedPhotoPickerProvider để cho phép các ứng dụng kiểm thử những quy trình dựa vào Công cụ chọn ảnh được nhúng.