تحميل الصور وعرضها

لعرض الصور في تطبيقك للمحتوى وللردود على إجراءات المستخدمين، حمِّل الصور من القرص أو من مصدر خارجي على الإنترنت. يمكنك تحميل الصور بالطرق التالية:

  • من القرص
  • من شبكة تستخدم Coil
  • من شبكة تستخدم Glide

النتائج

صورة لكلب
الشكل 1. صورة تم تحميلها وعرضها

التوافق مع الإصدارات

يتطلّب هذا التنفيذ ضبط minSDK في مشروعك على المستوى 21 من واجهة برمجة التطبيقات أو مستوى أعلى.

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

يمكنك تحميل الصور المخزَّنة محليًا من القرص لعرضها في تطبيقك من أجل المحتوى والاستجابة لإجراءات المستخدم.

الطلبات التابعة

تحميل الصورة

استخدِم الرمز التالي لتحميل صورة مخزَّنة محليًا من القرص لعرضها في تطبيقك:

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

النقاط الرئيسية حول الرمز

  • كائن Image محدّد في Compose يتضمّن السمة painter التي تم ضبطها على painterResource() لتحميل صورة من موارد التطبيق
  • وهي contentDescription يمكن TalkBack قراءتها لتسهيل استخدام تطبيقك.
  • stringResource() لتحميل وصف المحتوى المترجَم من الملف strings.xml

تحميل صورة عبر الشبكة

يمكنك تحميل الصور المخزَّنة خارجيًا على الإنترنت باستخدام Coil أو Glide. لاختيار المكتبة التي تريد استخدامها في مشروعك، عليك مراعاة عوامل مثل متطلبات المشروع وقيود الأداء.

تحميل صورة باستخدام Coil

يمكنك تحميل الصور من الإنترنت باستخدام Coil، وهي مكتبة تابعة لجهة خارجية. تستند مكتبة Coil إلى إجراءات Kotlin الروتينية المتزامنة، وتتحمّل مسؤولية تحميل الصورة بعيدًا عن سلسلة التعليمات الرئيسية، وعرضها بعد تحميلها. اتّبِع هذه الإرشادات لتحميل الصور من الإنترنت باستخدام Coil.

الطلبات التابعة

تحميل الصورة

استخدِم الرمز التالي لتحميل الصور باستخدام Coil:

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

تحميل صورة باستخدام Glide

يمكنك تحميل الصور المخزَّنة خارجيًا على الإنترنت باستخدام Glide لعرضها في خلاصة تطبيقك. ‫Glide هي مكتبة سريعة وفعّالة لتحميل الصور على Android، وهي تركّز على التنقّل السلس، وتتولّى مسؤولية تحميل الصورة بعيدًا عن سلسلة التعليمات الرئيسية، وتعرضها بعد تحميلها.

الطلبات التابعة

تحميل الصورة

استخدِم الرمز التالي لتحميل الصور باستخدام Glide:

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

المجموعات التي تتضمّن هذا الدليل

يشكّل هذا الدليل جزءًا من مجموعات "الدليل السريع" المنسّقة التي تغطي أهدافًا أوسع لتطوير تطبيقات Android:

تعرَّف على أساليب استخدام صور جذابة وساطعة لمنح تطبيق Android مظهرًا رائعًا.
مجموعة الأدلة السريعة

هل لديك أسئلة أو ملاحظات؟

انتقِل إلى صفحة الأسئلة الشائعة واطّلِع على الأدلة السريعة أو تواصَل معنا وأطلِعنا على أفكارك.
الانتقال إلى الأسئلة الشائعة تقديم ملاحظات