تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
photopicker
توفّر هذه المكتبة عملية دمج لتطبيق "الإنشاء" وAndroid
Views لأداة اختيار الصور المضمّنة.
آخر تعديل |
الإصدار الثابت |
إصدار محتمل |
الإصدار التجريبي |
الإصدار الأولي |
4 حزيران (يونيو) 2025 |
- |
- |
- |
1.0.0-alpha01 |
تحديد التبعيات
لإضافة تبعية على PhotoPicker، يجب إضافة مستودع Google Maven إلى
مشروعك. اطّلِع على مستودع Maven من Google
لمزيد من المعلومات.
أضِف التبعيات للعناصر التي تحتاج إليها في ملف build.gradle
ل
تطبيقك أو وحدتك:
رائع
dependencies {
// For apps using Compose
implementation "androidx.photopicker:photopicker-compose:1.0.0-alpha01"
// For apps using Android views
implementation "androidx.photopicker:photopicker:1.0.0-alpha01"
}
Kotlin
dependencies {
// For apps using Compose
implementation("androidx.photopicker:photopicker-compose:1.0.0-alpha01")
// For apps using Android views
implementation("androidx.photopicker:photopicker:1.0.0-alpha01")
}
لمزيد من المعلومات عن العناصر الاعتمادية، اطّلِع على مقالة إضافة عناصر الاعتماد الخاصة بالإصدار.
الملاحظات
تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا واجهت مشاكل جديدة أو كان لديك
أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على
المشاكل الحالية
في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال
النقر على زر النجمة.
إنشاء مشكلة جديدة
اطّلِع على مستندات أداة تتبُّع المشاكل
لمزيد من المعلومات.
لا تتوفّر ملاحظات حول الإصدار لهذا العنصر.
الإصدار 1.0
الإصدار 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، والذي يتيح للتطبيقات المستندة إلى View والتطبيقات المستندة إلى Compose الدمج بسهولة مع خدمة أداة اختيار الصور المضمّنة.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة
EmbeddedPhotopicker
composable ليكون نقطة دخول للتطبيقات المستندة إلى Compose.
- يمكن استخدام
rememberEmbeddedPhotoPickerState
(إجراء يُنصح به) أو يمكن للتطبيقات تنفيذ إدارة الحالة الخاصة بها باستخدام واجهة EmbeddedPhotoPickerState
.
- تمت إضافة
EmbeddedPhotopickerView
كنقطة دخول للتطبيقات المستندة إلى العرض.
- يمكن استخدام
EmbeddedPhotoPickerStateChangeListener
لتلقّي عمليات استدعاء ذات صلة بالحالة داخل PhotoPicker.
- تمت إضافة
TestEmbeddedPhotoPickerProvider
للسماح للتطبيقات باختبار عمليات التنقّل التي تعتمد على أداة اختيار الصور المضمّنة.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# photopicker\n===========\n\nAPI Reference \n[androidx.photopicker](/reference/kotlin/androidx/photopicker/package-summary) \nThis library provides an integration for Compose and Android Views for the embedded photo picker. \n\n| Latest Update | Stable Release | Release Candidate | Beta Release | Alpha Release |\n|---------------|----------------|-------------------|--------------|-----------------------------------------------------------------------|\n| June 4, 2025 | - | - | - | [1.0.0-alpha01](/jetpack/androidx/releases/photopicker#1.0.0-alpha01) |\n\nDeclaring dependencies\n----------------------\n\nTo add a dependency on PhotoPicker, you must add the Google Maven repository to your\nproject. Read [Google's Maven repository](/studio/build/dependencies#google-maven)\nfor more information.\n\nAdd the dependencies for the artifacts you need in the `build.gradle` file for\nyour app or module: \n\n### Groovy\n\n```groovy\ndependencies {\n // For apps using Compose\n implementation \"androidx.photopicker:photopicker-compose:1.0.0-alpha01\"\n // For apps using Android views\n implementation \"androidx.photopicker:photopicker:1.0.0-alpha01\"\n}\n \n```\n\n### Kotlin\n\n```kotlin\ndependencies {\n // For apps using Compose\n implementation(\"androidx.photopicker:photopicker-compose:1.0.0-alpha01\")\n // For apps using Android views\n implementation(\"androidx.photopicker:photopicker:1.0.0-alpha01\")\n}\n \n```\n\nFor more information about dependencies, see [Add build dependencies](/studio/build/dependencies).\n\nFeedback\n--------\n\nYour feedback helps make Jetpack better. Let us know if you discover new issues or have\nideas for improving this library. Please take a look at the\n[existing issues](https://issuetracker.google.com/issues?q=componentid:1815792%20status:open)\nin this library before you create a new one. You can add your vote to an existing issue by\nclicking the star button.\n\n[Create a new issue](https://issuetracker.google.com/issues/new?component=1815792&template=2142352)\n\nSee the [Issue Tracker documentation](https://developers.google.com/issue-tracker)\nfor more information.\n\nThere are no release notes for this artifact.\n\nVersion 1.0\n-----------\n\n### Version 1.0.0-alpha01\n\nJune 4, 2025\n\n`androidx.photopicker:photopicker:1.0.0-alpha01`, `androidx.photopicker:photopicker-compose:1.0.0-alpha01`, and `androidx.photopicker:photopicker-testing:1.0.0-alpha01` are released. Version 1.0.0-alpha01 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/786176dc2284c87a0e620477608e0aca9adeff15/photopicker).\n\n**New Features**\n\n- The initial alpha release of androidx implementations of the [Embedded PhotoPicker](https://developer.android.com/reference/android/widget/photopicker/package-summary) that enable both View based and Compose based applications to easily integrate with the Embedded Photopicker service.\n\n**API Changes**\n\n- Added `EmbeddedPhotopicker` composable for as an entrypoint for compose based applications.\n - `rememberEmbeddedPhotoPickerState` can be used (recommended) or applications can implement their own state management with the `EmbeddedPhotoPickerState` interface.\n- Added `EmbeddedPhotopickerView` as an entrypoint for view based applications.\n - `EmbeddedPhotoPickerStateChangeListener` can be used to receive related callbacks to state inside the PhotoPicker.\n- Added `TestEmbeddedPhotoPickerProvider` to allow apps to test flows that rely on the Embedded Photopicker."]]