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

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

استخدِم العنصر القابل للتجميع 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() لتحميل صورة نقطية. لمزيد من المعلومات عن ImageBitmap، يُرجى الاطّلاع على قسم ImageBitmap في مقابل ImageVector.

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

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

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

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

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

على سبيل المثال، لتحميل صورة باستخدام Coil من 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).