أداة اختيار الصور

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

لإضافة تبعية على 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

‫21 أكتوبر 2026

تم طرح androidx.photopicker:photopicker-*:1.0.0-alpha03. يتضمّن الإصدار ‎1.0.0-alpha03 هذه التعديلات.

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

• تمت إضافة 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 وإضافة دالة الاستدعاء 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 المجمّعة لوقت تشغيل مراحل النشاط مع الإصدار 9.5.0-alpha04 من AGP أو الإصدارات الأحدث. (I99bfd، b/556807521)
• تم تحديث مكتبات compileSdk for Compose إلى الإصدار 37.1. سيتطلّب ذلك تحديث compileSdk بشكل متعدٍّ لجميع التطبيقات والمكتبات التي تستخدم Compose. (I05b0f)
• تم تحديث compileSdk في Compose إلى المستوى 37 من واجهة برمجة التطبيقات. وهذا يعني أنّه يجب استخدام الإصدار 9.2.0 أو إصدار أحدث من "مكوّن Android الإضافي لـ Gradle" عند استخدام 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 هذه التعديلات.

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

• تم خفض minSdk لمكتبتَي androidx.photopicker:photopicker وandroidx.photopicker:photopicker-compose إلى 23، في حين لا تزال واجهات برمجة التطبيقات تتطلّب استدعاءها بدءًا من 34. (I94e42، b/524083018)
• تحديث واجهات برمجة التطبيقات الخاصة بـ "أداة اختيار الصور" المضمّنة في 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 لتلقّي عمليات استدعاء ذات صلة بالحالة داخل "أداة اختيار الصور".
• تمت إضافة TestEmbeddedPhotoPickerProvider للسماح للتطبيقات باختبار المسارات التي تعتمد على "أداة اختيار الصور" المضمّنة.