כלי לבחירת תמונות

הצהרה על יחסי תלות

כדי להוסיף תלות ב-PhotoPicker, צריך להוסיף לפרויקט את מאגר Maven של Google. מידע נוסף זמין במאמר מאגר ה-Maven של Google.

אתם יכולים להוסיף את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ 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"
}
    

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

מידע נוסף זמין במאמר הוספת יחסי תלות ב-build.

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. נשמח לדעת אם גיליתם בעיות חדשות או אם יש לכם רעיונות איך לשפר את הספרייה הזו. כדאי לעיין בבעיות הידועות בספרייה הזו לפני שמדווחים על בעיה. כדי להוסיף הצבעה בדיווח על בעיה קיימת, לוחצים על כפתור הכוכב.

יצירת דיווח על בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

אין נתוני גרסה לארטיפקט הזה.

גירסה 1.0

גרסה 1.0.0-alpha03

‫21 באוקטובר 2026

‫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)

תיקוני באגים

• התלות 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. כלומר, כשמשתמשים ב-Compose, נדרשת גרסת AGP מינימלית של 9.2.0. (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 של Embedded PhotoPicker Compose (הסרת AbstractEmbeddedPhotoPickerState, שינוי השם והחשיפה של חלק מהשדות מ-EmbeddedPhotoPickerState) (Ie32c9, ‏ b/449786033)

תיקוני באגים

• ‫compileSdk של Compose עודכן ל-API 37. כלומר, כשמשתמשים ב-Compose, נדרשת גרסת AGP מינימלית של 9.2.0. (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 של הכלי המוטמע לבחירת תמונות, שמאפשרות לאפליקציות מבוססות-תצוגה ומבוססות-Compose להשתלב בקלות עם השירות של הכלי המוטמע לבחירת תמונות.

שינויים ב-API

• נוסף הרכיב הקומפוזבילי EmbeddedPhotopicker כנקודת כניסה לאפליקציות שמבוססות על פיתוח נייטיב.
  • אפשר להשתמש ב-rememberEmbeddedPhotoPickerState (מומלץ) או שאפליקציות יכולות להטמיע ניהול מצב משלהן באמצעות הממשק EmbeddedPhotoPickerState.
• הוספנו את EmbeddedPhotopickerView כנקודת כניסה לאפליקציות מבוססות-תצוגה.
  • אפשר להשתמש ב-EmbeddedPhotoPickerStateChangeListener כדי לקבל קריאות חוזרות (callbacks) שקשורות למצב בתוך כלי בחירת התמונות.
• הוספנו את TestEmbeddedPhotoPickerProvider כדי לאפשר לאפליקציות לבדוק תהליכים שמסתמכים על כלי בחירת התמונות המוטמע.