photopicker

  
توفّر هذه المكتبة عملية دمج لـ Compose وAndroid Views من أجل أداة اختيار الصور المضمّنة.
آخر خبر الإصدار المستقر إصدار محتمل الإصدار التجريبي الإصدار الأولي
‫1 يوليو 2026 - - - ‎1.0.0-alpha02

تحديد الاعتماديات

لإضافة اعتمادية على PhotoPicker، يجب تضمين مستودع Google Maven في مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف الاعتماديات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:

رائع

dependencies {
    // For apps using Compose
    implementation "androidx.photopicker:photopicker-compose:1.0.0-alpha02"
    // For apps using Android views
    implementation "androidx.photopicker:photopicker:1.0.0-alpha02"
}
    

Kotlin

dependencies {
    // For apps using Compose
    implementation("androidx.photopicker:photopicker-compose:1.0.0-alpha02")
    // For apps using Android views
    implementation("androidx.photopicker:photopicker:1.0.0-alpha02")
}
    

لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على إضافة اعتماديات الإصدار.

الملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى إلقاء نظرة على الـ مشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.

ما مِن ملاحظات إصدار لهذا العنصر.

الإصدار 1.0

الإصدار ‎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 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • تم خفض minSdk لمكتبتَي androidx.photopicker:photopicker وandroidx.photopicker:photopicker-compose إلى 23، بينما لا تزال واجهات برمجة التطبيقات تتطلّب بدء استدعائها من الإصدار 34. (I94e42, b/524083018)
  • تعديل واجهات برمجة التطبيقات Embedded PhotoPicker Compose (إزالة AbstractEmbeddedPhotoPickerState وإعادة تسمية بعض الحقول وتغيير مستوى ظهورها من EmbeddedPhotoPickerState) (Ie32c9, b/449786033)

إصلاح الأخطاء

  • تم تعديل compileSdk في Compose إلى واجهة برمجة التطبيقات 37. يعني ذلك أنّه يجب توفُّر إصدار 9.2.0 على الأقل من "مكوّن Android Gradle الإضافي" عند استخدام 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 لتنفيذ أداة اختيار الصور المضمّنة التي تتيح للتطبيقات المستندة إلى العرض والمستندة إلى Compose التكامل بسهولة مع خدمة أداة اختيار الصور المضمّنة.

التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة العنصر القابل للإنشاء EmbeddedPhotopicker كنقطة دخول للتطبيقات المستندة إلى Compose.
    • يمكن استخدام rememberEmbeddedPhotoPickerState (ننصح بذلك)، أو يمكن للتطبيقات تنفيذ إدارة الحالة الخاصة بها باستخدام واجهة EmbeddedPhotoPickerState.
  • تمت إضافة EmbeddedPhotopickerView كنقطة دخول للتطبيقات المستندة إلى العرض.
    • يمكن استخدام EmbeddedPhotoPickerStateChangeListener لتلقّي عمليات معاودة الاتصال ذات الصلة بالحالة داخل PhotoPicker.
  • تمت إضافة TestEmbeddedPhotoPickerProvider للسماح للتطبيقات باختبار المسارات التي تعتمد على أداة اختيار الصور المضمّنة.