เครื่องมือเลือกรูปภาพ

  
ไลบรารีนี้มีการผสานรวมสำหรับ Compose และ Android Views สำหรับเครื่องมือเลือกรูปภาพแบบฝัง
อัปเดตล่าสุด รุ่นที่เสถียร รุ่นที่อาจได้รับการเผยแพร่ รุ่นเบต้า รุ่นอัลฟ่า
21 ตุลาคม 2569 - - - 1.0.0-alpha03

การประกาศทรัพยากร Dependency

หากต้องการเพิ่มทรัพยากร Dependency ใน PhotoPicker คุณต้องเพิ่มที่เก็บ Maven ของ Google ลงในโปรเจ็กต์ อ่านข้อมูลเพิ่มเติมได้ที่ที่เก็บ Maven ของ Google

เพิ่มทรัพยากร Dependency สำหรับอาร์ติแฟกต์ที่ต้องการในไฟล์ build.gradle สำหรับแอปหรือโมดูล ดังนี้

ดึงดูด

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")
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับการขึ้นต่อกันได้ที่เพิ่มการขึ้นต่อกันของบิลด์

ความคิดเห็น

ความคิดเห็นของคุณช่วยเราปรับปรุง Jetpack ให้ดียิ่งขึ้น โปรดแจ้งให้เราทราบหากคุณพบปัญหาใหม่หรือมีแนวคิดในการปรับปรุงไลบรารีนี้ โปรดดูปัญหาที่มีอยู่ในคลังนี้ก่อนสร้างปัญหาใหม่ คุณสามารถโหวตปัญหาที่มีอยู่ได้โดยคลิกปุ่มดาว

สร้างปัญหาใหม่

ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของ Issue Tracker

ไม่มีบันทึกประจำรุ่นสำหรับอาร์ติแฟกต์นี้

รุ่น 1.0

เวอร์ชัน 1.0.0-alpha03

21 ตุลาคม 2569

androidx.photopicker:photopicker-*:1.0.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha03 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เพิ่ม EXTRA_SYSTEM_FALLBACK_PICK_IMAGES_REQUEST_LOCATION_METADATA_ACCESS ลงใน PickVisualMedia เพื่ออนุญาตให้ขอสิทธิ์เข้าถึงข้อมูลเมตาตำแหน่งในเครื่องมือเลือกสำรองของระบบ (Ie5917)
  • เปลี่ยนชื่ออาร์ติแฟกต์ androidx.photopicker:photopicker เป็น androidx.photopicker:photopicker-embedded (แพ็กเกจ androidx.photopicker.embedded), androidx.photopicker:photopicker-compose เป็น androidx.photopicker:photopicker-embedded-compose (แพ็กเกจ androidx.photopicker.embedded.compose) และ androidx.photopicker:photopicker-testing เป็น androidx.photopicker:photopicker-embedded-testing (แพ็กเกจ androidx.photopicker.embedded.testing) (I48b9b, b/537430760)
  • เปลี่ยนโครงสร้างภายในโค้ด EmbeddedPhotoPickerState เพื่อแสดง surfacePackage และ notifyVisibilityChanged รวมถึงเพิ่ม Callback onError (Ifa4b0)
  • เพิ่ม setLocationMetadataAccessRequested ลงใน PickVisualMediaRequest เพื่ออนุญาตให้ขอสิทธิ์เข้าถึงข้อมูลเมตาตำแหน่งในคำขอเครื่องมือเลือกรูปภาพ (Idde80)
  • ย้ายข้อมูลสัญญา PickVisualMedia และ PickMultipleVisualMedia รวมถึง PickVisualMediaRequest ไปยังอาร์ติแฟกต์ photopicker-activity ใหม่แล้ว คัดลอกการทดสอบแล้ว (I2a201, b/530216959)
  • นำพารามิเตอร์ inputs ออกจาก rememberEmbeddedPhotoPickerState แล้ว หากต้องการรีเซ็ตสถานะเมื่ออินพุตมีการเปลี่ยนแปลง ให้รวมการเรียกใช้ไว้ในบล็อก key แทน (I8a0c5)
  • ลด minSdk ของไลบรารี androidx.photopicker:photopicker และ androidx.photopicker:photopicker-compose เป็น 23 (I94e42, b/524083018)
  • Revising Embedded PhotoPicker Compose APIs (Ie32c9)
  • ไลบรารีใหม่สำหรับเครื่องมือเลือกรูปภาพ (I0f52a)
  • ไลบรารีการทดสอบใหม่สำหรับเครื่องมือเลือกรูปภาพ (I7c1ec)

แก้ไขข้อบกพร่อง

  • อัปเดตทรัพยากร Dependency androidx.lifecycle:lifecycle-runtime เป็น 2.10.0 แล้ว เวอร์ชันนี้จำเป็นสำหรับการตรวจสอบ Lint ของรันไทม์วงจรที่รวมมาให้เพื่อทำงานร่วมกับ AGP เวอร์ชัน 9.5.0-alpha04 ขึ้นไป (I99bfd, b/556807521)
  • อัปเดต compileSdk สำหรับไลบรารี Compose เป็น 37.1 แล้ว ซึ่งจะต้องอัปเดต compileSdk แบบสกรรมกริยาสำหรับแอปและไลบรารีทั้งหมดที่ใช้ Compose (I05b0f)
  • อัปเดต compileSdk ของ Compose เป็น API 37 ซึ่งหมายความว่าต้องใช้ AGP เวอร์ชัน 9.2.0 เป็นอย่างน้อยเมื่อใช้ Compose (Id45cd)

เวอร์ชัน 1.0.0-alpha02

1 กรกฎาคม 2026

androidx.photopicker:photopicker:1.0.0-alpha02, androidx.photopicker:photopicker-compose:1.0.0-alpha02 และ androidx.photopicker:photopicker-testing:1.0.0-alpha02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha02 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • ลด minSdk ของไลบรารี androidx.photopicker:photopicker และ androidx.photopicker:photopicker-compose เป็น 23 ขณะที่ API ยังคงต้องเรียกใช้ตั้งแต่ 34 เป็นต้นไป (I94e42, b/524083018)
  • การอัปเดต API ของ Compose สำหรับเครื่องมือเลือกรูปภาพแบบฝัง (การนำ AbstractEmbeddedPhotoPickerState ออก การเปลี่ยนชื่อ และการเปลี่ยนระดับการเข้าถึงของบางฟิลด์จาก EmbeddedPhotoPickerState) (Ie32c9, b/449786033)

แก้ไขข้อบกพร่อง

  • อัปเดต compileSdk ของ Compose เป็น API 37 ซึ่งหมายความว่าต้องใช้ AGP เวอร์ชัน 9.2.0 เป็นอย่างน้อยเมื่อใช้ Compose (Ic748a, b/413674743)

เวอร์ชัน 1.0.0-alpha01

4 มิถุนายน 2025

androidx.photopicker:photopicker:1.0.0-alpha01, androidx.photopicker:photopicker-compose:1.0.0-alpha01 และ androidx.photopicker:photopicker-testing:1.0.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • การเปิดตัวเวอร์ชันอัลฟ่าครั้งแรกของการติดตั้งใช้งาน androidx ของ Embedded PhotoPicker ซึ่งช่วยให้ทั้งแอปพลิเคชันที่ใช้ View และ Compose ผสานรวมกับบริการ Embedded PhotoPicker ได้อย่างง่ายดาย

การเปลี่ยนแปลง API

  • เพิ่ม EmbeddedPhotopicker Composable เป็นจุดแรกเข้าสำหรับแอปพลิเคชันที่ใช้ Compose
    • คุณสามารถใช้ rememberEmbeddedPhotoPickerState (แนะนำ) หรือแอปพลิเคชันจะใช้การจัดการสถานะของตนเองด้วยอินเทอร์เฟซ EmbeddedPhotoPickerState ก็ได้
  • เพิ่ม EmbeddedPhotopickerView เป็นจุดแรกเข้าสำหรับแอปพลิเคชันที่อิงตามมุมมอง
    • คุณสามารถใช้ EmbeddedPhotoPickerStateChangeListener เพื่อรับ Callback ที่เกี่ยวข้องกับสถานะภายใน PhotoPicker
  • เพิ่ม TestEmbeddedPhotoPickerProvider เพื่ออนุญาตให้แอปทดสอบขั้นตอนที่อาศัยเครื่องมือเลือกรูปภาพแบบฝัง