جارٍ تحميل الصور

تحميل صورة من القرص

يمكنك استخدام Image القابل للإنشاء لعرض رسم على الشاشة. لتحميل صورة (مثل PNG أو JPEG أو WEBP) أو مورد ملفات رسومية من القرص، استخدِم واجهة برمجة التطبيقات painterResource مع مرجع الصورة. لست بحاجة إلى معرفة نوع من مادة العرض، ما عليك سوى استخدام painterResource في مفاتيح التعديل Image أو paint.

DrawScope:

Image(
    painter = painterResource(id = R.drawable.dog),
    contentDescription = stringResource(id = R.string.dog_content_description)
)
LoadingImagesSnippets.kt

لضمان سهولة استخدام تطبيقك، يجب توفير contentDescription ل العناصر المرئية على الشاشة. تقرأ ميزة TalkBack وصف المحتوى بصوت عالٍ، ما يجعلك أن يتأكد من أن النص ذي معنى إذا تمت قراءته بصوت عالٍ وترجمته. في المثال أعلاه، يتم استخدام stringResource() لتحميل وصف المحتوى المُترجَم من ملف strings.xml. إذا كان العنصر المرئي على الشاشة فقط للتزيين المرئي، اضبط contentDescription على null قارئ الشاشة لتجاهلها.

إذا كنت بحاجة إلى وظائف ImageBitmap محدّدة من المستوى الأدنى، يمكنك استخدام ImageBitmap.imageResource() لتحميل ملف Bitmap. لمزيد من المعلومات عن ImageBitmaps، اطّلِع على قسم ImageBitmap في مقابل ImageVector.

إتاحة استخدام عناصر قابلة للرسم

تتيح painterResource حاليًا أنواع الرسومات التالية:

• AnimatedVectorDrawable
• BitmapDrawable (PNG وJPG وWEBP)
• ColorDrawable
• VectorDrawable

تحميل صورة من الإنترنت

لتحميل صورة من الإنترنت، تتوفّر عدة مكتبات تابعة لجهات خارجية. المتاحة لمساعدتك في التعامل مع هذه العملية. تنفذ مكتبات تحميل الصور الكثير من الأحمال الثقيلة من أجلك؛ سيتعاملان مع كلا حقلي التخزين المؤقت (حتى لا تتمكن من تنزيل الصورة عدة مرات) ومنطق الشبكات لتنزيل الصورة وعرضها الذي يظهر على الشاشة.

على سبيل المثال، لتحميل صورة باستخدام الملف. من Instacart، أضِف المكتبة إلى ملف Gradle، واستخدِم علامة AsyncImage لتحميل صورة من عنوان URL:

AsyncImage(
    model = "https://example.com/image.jpg",
    contentDescription = "Translated description of what the image contains"
)
LoadingImagesSnippets.kt

ملف

مكتبة لتحميل الصور تستند إلى Kotlin Coroutines (Instacart)

Glide

مكتبة سريعة وفعّالة لتحميل الصور على أجهزة Android تركّز على الانتقال السلس (Google)