انتخاب‌گر عکس

اعلام وابستگی‌ها

برای افزودن وابستگی به PhotoPicker، باید مخزن Google Maven را به پروژه‌تان اضافه کنید. برای اطلاعات بیشتر، مخزن 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")
}
    

برای اطلاعات بیشتر درباره وابستگی‌ها، به افزودن وابستگی‌های ساخت مراجعه کنید.

بازخورد

بازخوردتان به بهبود Jetpack کمک می‌کند. اگر مشکل جدیدی پیدا کردید یا ایده‌ای برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل‌از ایجاد مشکل جدید، مشکلات موجود در این کتابخانه را بررسی کنید. با کلیک کردن روی دکمه ستاره می‌توانید رأی خود را به مشکل موجود اضافه کنید.

ایجاد مشکل جدید

برای اطلاعات بیشتر، سند Issue Tracker را ببینید.

هیچ یادداشت انتشاری برای این آرتیفکت وجود ندارد.

نسخه 1.0

نسخه 1.0.0-alpha03

‫۲۱ اکتبر ۲۰۲۶

‫androidx.photopicker:photopicker-*:1.0.0-alpha03 منتشر شده است. نسخه 1.0.0-alpha03 حاوی این موارد ثبت است.

تغییرات میانای برنامه‌سازی کاربردی

• EXTRA_SYSTEM_FALLBACK_PICK_IMAGES_REQUEST_LOCATION_METADATA_ACCESS به PickVisualMedia اضافه شد تا امکان درخواست دسترسی به فراداده مکان در انتخاب‌گرهای جایگزین سیستم فراهم شود. (Ie5917)
• Renamed artifact androidx.photopicker:photopicker to androidx.photopicker:photopicker-embedded (package androidx.photopicker.embedded), androidx.photopicker:photopicker-compose to androidx.photopicker:photopicker-embedded-compose (package androidx.photopicker.embedded.compose), and androidx.photopicker:photopicker-testing to androidx.photopicker:photopicker-embedded-testing (package 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 به ۲۳ کاهش یافت. (I94e42، b/524083018)
• ‫Revising Embedded PhotoPicker Compose APIs (Ie32c9)
• کتابخانه‌های جدید برای «انتخابگر عکس» (I0f52a)
• کتابخانه آزمایشی جدید برای انتخابگر عکس (I7c1ec)

رفع اشکال‌ها

• وابستگی androidx.lifecycle:lifecycle-runtime به نسخه ۲.۱۰.۰ به‌روز شد. این نسخه برای اجرای بررسی‌های lint زمان اجرای چرخه حیات بسته‌بندی‌شده با AGP نسخه 9.5.0-alpha04 یا جدیدتر لازم است. (I99bfd, b/556807521)
• ‫compileSdk برای کتابخانه‌های Compose به ۳۷.۱ به‌روز شد. این کار مستلزم به‌روزرسانی متعدی compileSdk برای همه برنامه‌ها و کتابخانه‌هایی است که از Compose استفاده می‌کنند. (I05b0f)
• ‫compileSdk مربوط به Compose به میانای برنامه‌سازی کاربردی ۳۷ به‌روز شد. این یعنی هنگام استفاده از Compose، حداقل نسخه AGP‏ ۹.۲.۰ لازم است. (Id45cd)

نسخه 1.0.0-alpha02

‫۱ ژوئیه ۲۰۲۶

‫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 حاوی این ارسال‌ها است.

تغییرات میانای برنامه‌سازی کاربردی

• ‫minSdk کتابخانه‌های androidx.photopicker:photopicker و androidx.photopicker:photopicker-compose به ۲۳ کاهش یافت، درحالی‌که APIها همچنان باید از ۳۴ به بالا فراخوانی شوند. (I94e42، b/524083018)
• Updating Embedded PhotoPicker Compose APIs (removing AbstractEmbeddedPhotoPickerState, renaming and change visibility of some fields from EmbeddedPhotoPickerState) (Ie32c9, b/449786033)

رفع اشکال‌ها

• ‫compileSdk مربوط به Compose به میانای برنامه‌سازی کاربردی ۳۷ به‌روز شد. این یعنی هنگام استفاده از Compose، حداقل نسخه AGP‏ ۹.۲.۰ لازم است. (Ic748a، b/413674743)

نسخه 1.0.0-alpha01

‫۴ ژوئن ۲۰۲۵

‫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 از انتخاب‌گر عکس جاسازی‌شده که به برنامه‌های مبتنی بر View و Compose امکان می‌دهد به‌راحتی با سرویس «انتخاب‌گر عکس جاسازی‌شده» ادغام شوند.

تغییرات میانای برنامه‌سازی کاربردی

• ‫EmbeddedPhotopicker composable به‌عنوان نقطه ورودی برای برنامه‌های مبتنی بر compose اضافه شد.
  • می‌توان از rememberEmbeddedPhotoPickerState استفاده کرد (توصیه می‌شود) یا برنامه‌ها می‌توانند مدیریت وضعیت خودشان را با میانای EmbeddedPhotoPickerState پیاده‌سازی کنند.
• ‫EmbeddedPhotopickerView به‌عنوان نقطه ورودی برای برنامه‌های مبتنی بر View اضافه شد.
  • از EmbeddedPhotoPickerStateChangeListener می‌توان برای دریافت پاسخ‌های تماس مرتبط با وضعیت داخل PhotoPicker استفاده کرد.
• TestEmbeddedPhotoPickerProvider اضافه شد تا برنامه‌ها بتوانند جریان‌هایی را که به «انتخابگر عکس جاسازی‌شده» متکی هستند آزمایش کنند.