Unlimited WordPress themes, graphics, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. Android SDK
Code

ترميز تطبيق معرض صور Android مع بيكاسو

by
Difficulty:IntermediateLength:LongLanguages:

Arabic (العربية/عربي) translation by Maryam Abbas (you can also view the original English article)

Final product image
What You'll Be Creating

Picasso هي مكتبة Android مفتوحة المصدر الشعبية لتحميل الصور المحلية والبعيدة. تعلم كيفية استخدامها بسهولة للتعامل مع احتياجاتك لتحميل الصور.

1. ما هو بيكاسو؟

بيكاسو (اسم مستوحى من الفنان الفرنسي الشهير بابلو بيكاسو) هي مكتبة أندرويد شعبية مفتوحة المصدر لتحميل الصور في تطبيق Android الخاص بك. وفقًا للمستندات الرسمية، تنص على ما يلي:

... تسمح بيكاسو بتحميل صور خالية من المتاعب في تطبيقك - في كثيرمن الأحيان في سطر واحد من التعليمات البرمجية!

لاحظ أن بيكاسو يستخدم OkHttp (مكتبة الشبكة من نفس المطور) تحت الغطاء لتحميل الصور عبر الإنترنت.

2. لماذا إذن استخدم بيكاسو؟

الآن لقد تعلمت ما يدور حول بيكاسو، والسؤال التالي الذي قد تسأله هو لماذا تستخدمه؟

يمكن أن يكون تطوير وظيفة تحميل وعرض الوسائط الخاصة بك في Java أو Kotlin بمثابة ألم حقيقي: يجب عليك الاهتمام بالتخزين المؤقت وفك التشفير وإدارة اتصالات الشبكة والترابط ومعالجة الاستثناءات والمزيد. بيكاسو هي مكتبة سهلة الاستخدام ومخطط لها جيدا وموثقة ومدروسة جيدا ويمكنها أن توفر لك الكثير من الوقت الثمين - وتوفر عليك بعض الصداع.

في ما يلي العديد من المخاطر الشائعة لتحميل الصور على Android والتي تم التعامل معها من أجلك بواسطة بيكاسو، وفقًا للمستندات الرسمية:

  • التعامل مع إعادة تدوير عرض الصور وحذف التحميل في المحول
  • تحويلات الصور المعقدة مع الحد الأدنى من استخدام الذاكرة
  • الذاكرة التلقائية والتخزين المؤقت للقرص

يمكن أن تؤدي إضافة صور إلى تطبيقك إلى جعل تطبيق Android الخاص بك ينبض بالحياة. لذا في هذا البرنامج التعليمي، سنتعرف على Picasso 2 من خلال إنشاء تطبيق معرض صور بسيط. سيتم تحميل الصور عبر الإنترنت وعرضها كصور مصغرة في مدور العرض، وعندما ينقر المستخدم على صورة، فإنه سيفتح نشاطًا تفصيليًا يحتوي على الصورة الأكبر.

يمكن العثور على عينة من المشروع (في Kotlin) لهذا البرنامج التعليمي في المرجع GitHub لدينا حتى تتمكن من المتابعة بسهولة دائماً.

نسخة الفنانين الجيدة، وسرقة الفنانين الكبار. - بابلو بيكاسو

3. الشروط الأساسية

لتتمكن من متابعة هذا البرنامج التعليمي، ستحتاج إلى:

  • فهم أساسي لواجهة برمجة تطبيقات Android الأساسية و Kotlin
  • Android Studio 3.1.1 أو إصدار أحدث
  • البرنامج المساعد Kotlin plugin1.2.30 أو أعلى

أطلق Android Studio وأنشئ مشروعًا جديدًا (يمكنك تسميته البرنامج التجريبي بيكاسو) بنشاط فارغ يسمى النشاط الاساسي. تأكد أيضًا من فحص خانة اختبار تضمين الدعم Kotlin.

Android Studios Add an Activity to Mobile dialog

4. إعلان التبعيات

بعد إنشاء مشروع جديد، حدد التبعيات التالية في build.gradle. في وقت كتابة هذا التقرير، أحدث إصدار من بيكاسو هو 2.71828.

او مع مافن:

تأكد من مزامنة مشروعك بعد إضافة بيكاسو ومنتجات RecyclerView v7.

5. إضافة إذن الإنترنت

نظرًا لأن بيكاسو سيقوم بتنفيذ طلب الشبكة لتحميل الصور عبر الإنترنت ، نحتاج إلى تضمين إذن الإنترنت في AndroidManifest.xml الخاص بنا.

لذا افعل ذلك الآن!

لاحظ أن هذا مطلوب فقط إذا كنت ستقوم بتحميل الصور من الإنترنت. هذا ليس مطلوبًا إذا كنت تقوم فقط بتحميل الصور محليًا على الجهاز.

6. إنشاء تخطيط

سنبدأ بإنشاء RecyclerView الخاص بنا داخل ملف layout activity_main.xml.

إنشاء تخطيط العنصر المخصص

بعد ذلك، لنقم بإنشاء تنسيق (XML (item_image.xml الذي سيتم استخدامه لكل عنصر (ImageView) ضمن RecyclerView.

الآن بعد أن أنشأنا التخطيطات اللازمة لتطبيق معرضنا البسيط، فإن الخطوة التالية هي إنشاء محول RecyclerView لتعبئة البيانات. قبل أن نفعل ذلك، دعونا على كل حال ننشئ نموذج البيانات البسيطة.

7. إنشاء نموذج البيانات

سنقوم بتحديد نموذج البيانات البسيط لـ RecyclerView الخاص بنا. تطبق هذه الرزمة من النموذج لنقل البيانات عالية الأداء من مكون إلى آخر في Android. في حالتنا، سيتم نقل البيانات من SunsetGalleryActivity إلى SunsetPhotoActivity.

لاحظ أن هذا النموذج SunsetPhoto يحتوي على حقل واحد فقط يسمى url (لأغراض تجريبية)، ولكن يمكنك الحصول على المزيد إذا كنت تريد. هذه الفئة تطبق Parcelable، مما يعني أن علينا تجاوز بعض الأساليب.

يمكننا الاستفادة من Android Studio IDEA لتوليد هذه الأساليب، ولكن الجانب السلبي لهذا هو الصيانة. ماذا؟ في أي وقت نضيف أي حقول جديدة إلى هذه الفئة، قد ننسى أن نقوم بتحديث المنطق وطريقة WriteToParcel بشكل صريح، مما قد يؤدي إلى بعض الأخطاء إذا لم نقم بتحديث الطرق.

الآن، للتحايل على تحديث أو كتابة هذه الأساليب المتسلسلة، قدم Kotlin 1.1.14 الشرحParcelize. سيساعدنا هذا التعليق التوضيحي في إنشاء أساليب writeTTarParcel و writeFromPolcel  describeContents تلقائيًا تحت الغطاء.

الآن، لدينا ترميزنا لفئة SunsetPhoto هو مجرد سطرين! رائع!

تذكر إضافة الشيفرة التالية إلى وحدة تطبيقك build.gradle:

بالإضافة إلى ذلك، قمت بتضمين كائن مرافق (أو طريقة ثابتة في جافا) احصل على  SunsetPhotos () في فئة طراز SunsetPhoto التي ستقوم فقط بإرجاع قائمة مصفوفة من SunsetPhoto عند الاستدعاء.

8. قم بإنشاء المحول

سنقوم بإنشاء محول لملء RecyclerView لدينا بالبيانات. سنقوم أيضًا بتطبيق مستمع للنقرات لفتح النشاط التفصيلي - SunsetPhotoActivity - لتمريره مثالًا لـ SunsetPhoto كهدف إضافي. سيعرض النشاط التفصيلي عرضاً مقرباً للصورة. سنقوم بإنشائها في قسم لاحق.

لاحظ أننا استخدمنا وظيفة الامتداد التطبيقي لوضع العنصر كإضافة في الهدف. وللتذكير، ترجع دالة التطبيق الكائن الذي تم تمريره إليها كوسيطة (أي الكائن المستقبل).

9. تحميل الصور من عنوان URL

سنحتاج إلى بيكاسو لأداء مهمته في هذا القسم - ليس لرسم أعمالنا الفنية، بل لجلب صور من الإنترنت وعرضها. سنقوم بعرض هذه الصور بشكل فردي في ImageViews الخاص بها داخل أسلوب RecyclerView  على BindViewHolder () الخاص بنا أثناء تمرير المستخدم للتطبيق.

خطوة بخطوة، إليك ما يفعله طلب بيكاسو:

طريقة الحصول()

هذا يعيد مثال Picasso العمومي (مثال singleton) المستهل به باستخدام التكوينات الافتراضية التالية:

  • ذاكرة التخزين المؤقت LRU 15 ٪ هي ذاكرة الوصول العشوائي المتاحة للتطبيق.
  • ذاكرة تخزين مؤقت للقرص تصل إلى 2٪ من مساحة التخزين حتى 50 ميجابايت ولكن لا تقل عن 5 ميغابايت. ملاحظة: هذا متاح فقط على API 14+.
  • ثلاثة سلاسل تنزيل للقرص والوصول للشبكة.

لاحظ أنه في حالة عدم استيفاء هذه الإعدادات لمتطلبات التطبيق، يمكنك إنشاء مثيل بيكاسو الخاص بك مع التحكم الكامل في هذه التهيئات باستخدام Picasso.Builder.

وأخيرًا، يمكنك استدعاء الأسلوب build () لإرجاع نسخة بيكاسو مع تكويناتك الخاصة.

من المستحسن القيام بذلك في Application.onCreate الخاص بك ثم قم بتعيينه كمثيل مفرد مع إعداد مثيل مفرد بيكاسو في هذه الطريقة — للتأكد من أن مثيل Picasso هو الإصدار العام.

طريقة التحميل ()

تحميل (مسار السلسلة) يبدأ بطلب صورة باستخدام المسار المحدد. يمكن أن يكون هذا المسار عبارة عن عنوان URL بعيد أو مورد ملف أو مورد محتوى، أو مورد Android.

  • العنصر النائب (int placeholderResId): معرف مورد عنصر نائب محلي أو قابل للسحب ليتم استخدامه أثناء تحميل الصورة ثم عرضها. إنه بمثابة تجربة مستخدم جيدة لعرض صورة عنصر نائب أثناء تنزيل الصورة.

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

أساليب أخرى

  • error (int errorResId): قابل للسحب ليتم استخدامه إذا تعذر تحميل الصورة المطلوبة - ربما بسبب تعطل موقع الويب.
  • noFade (): يتلاشى بيكاسو دائمًا في الصورة ليتم عرضها في ImageView. إذا كنت لا ترغب في إنشاء حركة رسوم متحركة تتلاشى، فاتصل ببساطة بالطريقة noFade ().
  • (into (ImageView imageView: عرض الصورة الهدف الذي سيتم وضع الصورة فيه.

تغيير حجم الصورة وتحويلها

إذا كان الخادم الذي تطلبه من الصورة لا يعطيك الصورة التي تحتاجها بالحجم المطلوب، يمكنك بسهولة تغيير حجم تلك الصورة باستخدام تغيير الحجم (int targetWidth ،int targetHeight). يؤدي استدعاء هذا الأسلوب إلى تغيير حجم الصورة ثم عرضها على ImageView. لاحظ أن الأبعاد بالبكسل (px)، وليس dp.

يمكنك المرور على مورد أبعاد Android لكل من العرض والارتفاع باستخدام الطريقة resizeDimen (int targetWidthResId، int targetHeightResId). سيقوم هذا الأسلوب بتحويل قياس الابعاد إلى البكسلات الصرفة ثم استدعاء تغيير الحجم () أسفل الغطاء - لتمرير المقاسات المحولة (بالبكسل) كوسيطة.

لاحظ أن أساليب تغيير الحجم هذه لن تحترم نسبة العرض إلى الارتفاع. بمعنى آخر، يمكن تشويه نسبة العرض إلى الارتفاع للصورة.

لحسن الحظ، تعطينا بيكاسو بعض الطرق المفيدة لحل هذه المشكلة:

  • centerCrop (): يقوم بقياس الصورة بشكل موحد (الحفاظ على نسبة العرض إلى الارتفاع للصورة) بحيث تملأ الصورة المنطقة المعينة، مع عرض أكبر قدر الامكان من الصورة. إذا لزم الأمر، سيتم اقتصاص الصورة أفقيًا أو رأسيًا لملاءمتها. يؤدي استدعاء هذا الأسلوب إلى اقتصاص صورة داخل الحدود المحددة بواسطة تغيير الحجم ().
  • centerInside (): يقوم بتحجيم الصورة بحيث يكون كلا البعدين مساويين أو أقل من الحدود المطلوبة. سيؤدي هذا إلى توسيط صورة داخل الحدود المحددة بواسطة تغيير الحجم ().
  • ScaleDownonly (): تغيير حجم صورة فقط إذا كان حجم الصورة الأصلية أكبر من الحجم المستهدف المحدد بواسطة تغيير الحجم ().
  • fit (): محاولة تغيير حجم الصورة لتتلاءم تمامًا مع حدود ImageView المستهدفة.

تدوير الصورة

لدى بيكاسو واجهة برمجة تطبيقات سهلة لتدوير صورة ثم عرض تلك الصورة. تقوم طريقة التدوير (درجات التعويم) بتدوير الصورة بالدرجات المحددة.

في المثال السابق، هذا سيؤدي الى تدوير الصورة بمقدار 90 درجة، طريقة تدوير  (float pivotY،float degrees, float pivotX)  تدور الصورة بالدرجات المخصصة حول النقطة المحورية .

سنقوم هنا بتدوير الصورة بمقدار 30 درجة حول النقطة المحورية 200، و 100 بكسل.

تحويل

وبصرف النظر عن مجرد التلاعب بالصورة من خلال تدويرها ، يمنحنا بيكاسو أيضًا خيار تطبيق تحويل مخصص على صورة قبل عرضها.

يمكنك ببساطة إنشاء فئة تقوم بتنفيذ واجهة تحويل بيكاسو. عليك بعد ذلك اجتياز طريقتين:

  • تحويل الصورة النقطية (مصدر نقطي): يؤدي هذا إلى تحويل الصورة النقطية المصدر إلى صورة نقطية جديدة.
  • أساس سلسلة (): يرجع الاساس الفريد للتحويل، يُستخدم لأغراض التخزين المؤقت.

بعد الانتهاء من إنشاء التحويل المخصص، يمكنك تنفيذه ببساطة عن طريق استدعاء التحويل (تحويل التحول) في مثيل بيكاسو الخاص بك. لاحظ أنه يمكنك أيضًا تمرير قائمة التحويل لتحويل ().

هنا، قمت بتطبيق تحويل مقبض دائري إلى صورة من مكتبة Android المفتوحة المصدر في تحويل بيكاسو. تحتوي هذه المكتبة على العديد من التحويلات التي يمكنك تطبيقها على صورة مع بيكاسو — بما في ذلك التحويلات لتعتيم أو تغيير حجم الصورة. اذهب للتحقق من ذلك إذا كنت ترغب في تطبيق بعض التحويلات الرائعة لصورك.

10. تهيئة المحول

هنا، نقوم ببساطة بإنشاء RecyclerView الخاص بنا مع GridLayoutManager كمدير التخطيط، نهيئ المحول الخاص بنا، ونربطه إلى RecyclerView.

11. إنشاء النشاط التفصيلي

قم بإنشاء نشاط جديد وتسميته SunsetPhotoActivity. نحصل على SunsetPhoto اضافية ونحمل الصورة - داخل onStart () - مع بيكاسو كما فعلنا من قبل.

التخطيط التفصيلي

فيما يلي تخطيط لعرض النشاط التفصيلي. يعرض فقط ImageView التي ستُظهر النسخة الكاملة الدقة للصورة المحملة.

12. آلية التخزين المؤقت في بيكاسو

إذا لاحظت بعناية، ستلاحظ أنه عند الانتقال مرة أخرى إلى صورة تم تحميلها مسبقًا، يتم تحميلها بشكل أسرع من ذي قبل. ما الذي جعلها أسرع؟ إنها آلية التخزين المؤقت بيكاسو، وهذا هو السبب.

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

باختصار، هنا ما يجري (تحت الغطاء) لطلب صورة: الذاكرة -> القرص -> الشبكة.

بناءً على طلبك، قد ترغب في تجنب التخزين المؤقت - على سبيل المثال، إذا كان من المرجح أن تتغير الصور المعروضة في كثير من الأحيان ولا يتم إعادة تحميلها.

لذا كيف يمكنك تعطيل التخزين المؤقت؟

يمكنك تجنب تخزين الذاكرة المؤقت عن طريق استدعاء memoryPolicy (MemoryPolicy.NO_CACHE). سيؤدي ذلك ببساطة إلى تخطي البحث في ذاكرة التخزين المؤقت عند معالجة طلب صورة.

لاحظ أن هناك اعدادًا آخرًا: MemoryPolicy.NO_STORE. يكون هذا مفيدًا إذا كنت متأكدًا تمامًا من أنك ستطلب صورة مرة واحدة فقط. لن يؤدي تطبيق ذلك إلى تخزين الصورة في ذاكرة التخزين المؤقت لذا لا يتم إخراج الصور النقطية الأخرى من ذاكرة التخزين المؤقت.

ولكن عليك أن تدرك تمامًا أن الصورة ستظل مخزنة مؤقتًا على القرص - لمنع ذلك أيضًا، فإنك تستخدم (@NonNull NetworkPolicy policy, @NonNull NetworkPolicy... additional)، والذي يأخذ واحدًا أو أكثر من قيم الاعداد التالية:

  • NetworkPolicy.NO_CACHE: يتخطى التحقق من ذاكرة التخزين المؤقت على القرص ويجبر التحميل عبر الشبكة.
  • NetworkPolicy.NO_STORE: يتخطى تخزين النتيجة في ذاكرة التخزين المؤقت على القرص.
  • NetworkPolicy.OFFLINE: فرض الطلب من خلال ذاكرة التخزين المؤقت على القرص فقط، وتخطي الشبكة.

لتجنب التخزين المؤقت للذاكرة والقرص تمامًا، ما عليك سوى استدعاء كلتا الطريقتين واحدة تلو الأخرى:

13. ​​المستمعين للطلب

في بيكاسو، يمكنك تنفيذ مستمع أو رد اتصال لمراقبة حالة الطلب الذي قمت به أثناء تحميل الصورة. سيتم استدعاء إحدى هذه الطرق فقط إذا قمت بتطبيق واجهة الهدف على طلب ما.

  •  void onBitmapFailed(e: Exception?, errorDrawable: Drawable?)يتم تشغيلها عندما يتعذر تحميل الصورة بنجاح. هنا، يمكننا الوصول إلى الاستثناء الذي تم طرحه.
  • void onBitmapLoaded (صورة نقطية نقطية ، LoadedFrom from): يتم إطلاقها كلما تم تحميل صورة بنجاح. هنا، نحصل على صورة نقطية لإظهار المستخدم.
  • void onPrepareLoad (drawable placeHolderDrawable): استدعاء قبل تقديم طلبك.

هنا يمكنك أيضًا إظهار مربع حوار التقدم ثم إخفائه إذا كان لديك واحدًا.

يوجد مستمع آخر لاستدعاء اتصال به يمكنك تنفيذه إذا أردت، يسمى Callback. تحتوي هذه الواجهة على طريقتين فقط: onSuccess () و onError (استثناء e). يتم استدعاء الأولى عند تحميل طلب الصورة بنجاح، ويتم استدعاء الثانية عندما يكون هناك خطأ في معالجة الطلب.

بالعودة إلى تطبيق معرض الصور لدينا (داخل SunsetPhotoActivity)، دعنا نعدل العرض قليلاً باستخدام كائن Callback الذي سيؤدي إلى تعيين الصورة النقطية إلى ImageView وأيضاً تغيير لون الخلفية للتخطيط من خلال استخراج اللون المظلم والنابض بالحياة لصورتنا باستخدام واجهة برمجة تطبيقات Android Palette.

لذلك قم بتضمين لوحة الألوان في البنية الخاصة بوحدة التطبيق الخاصة بك.

دعنا الآن ننفذ واجهة رد الاتصال في طلب Picasso الخاص بنا.

14. اختبار التطبيق

أخيرا، يمكنك تشغيل التطبيق! انقر على الصورة المصغرة للحصول على نسخة كاملة الحجم من الصورة.

Final app result

15. تحديد أولويات الطلبات

عندما تريد تحميل صور مختلفة في نفس الوقت على نفس الشاشة، لديك الخيار لترتيب أيهما أكثر أهمية من الآخر. بمعنى آخر، يمكنك تحميل الصور المهمة أولاً.

يمكنك ببساطة تسمية الأولوية () على مثيل طلب بيكاسو وتمريره في أي من الاعدادات: منخفض الاولوية أو أولوية عادية أو عالي الاولوية.

16. وسم الطلبات

بوسم طلبات Picasso، يمكنك استئناف الطلبات أو إيقافها مؤقتًا أو إلغاءها والتي ترتبط بوسم محدد. استنادًا إلى حالة الاستخدام، يمكنك وسم  طلباتك باستخدام سلسلة أو كائنات يجب أن تحدد نطاق الطلب على أنه محتوى أو نشاط أو جزء. يمكنك بسهولة وسم طلب بيكاسو عن طريق الاتصال بالعلامة (NonNull Object tag) على أحدها. قم بتمريرها على سبيل المثال للكائن الذي يعمل كوسم.

في ما يلي العمليات التالية التي يمكنك تنفيذها على طلبات Picasso الموسومة:

  • pauseTag (وسم الكائن): إيقاف جميع الطلبات المرتبطة بالعلامة المحددة مؤقتًا.
  • resumeTag (وسم الكائن): استئناف الطلبات المتوقفة مؤقتًا باستخدام العلامة المحددة.
  • cancelTag (وسم الكائن): قم بإلغاء أي طلبات موجودة بالعلامة المحددة.

على الرغم من أن وسم طلباتك يمنحك بعض التحكم في طلباتك، يجب عليك توخي الحذر الشديد عند استخدام الوسم نظرًا لاحتمال حدوث تسرب للذاكرة. إليك ما تقوله الوثائق الرسمية:

ستحتفظ بيكاسو بإشارة إلى العلامة طالما أن هذه العلامة متوقفة مؤقتًا و / أو تحتوي على طلبات نشطة. ابحث عن التسريبات المحتملة.

تحميل من نظام الملفات

من السهل تحميل الصور محليًا في تطبيقك.

استنتاج

عمل رائع! في هذا البرنامج التعليمي، قمت بإنشاء تطبيق معرض صور كامل مع بيكاسو، ومن خلال البرنامج تعلمت كيفية عمل المكتبة وكيف يمكنك دمجها في مشروعك الخاص.

لقد تعلمت أيضًا كيفية عرض الصور المحلية والبعيدة، وطلبات وضع العلامات، وتحديد أولويات الطلبات، وكيفية تطبيق تحويلات الصور مثل تغيير الحجم. ليس هذا فقط، ولكنك لاحظت مدى سهولة تمكين وتعطيل التخزين المؤقت، ومعالجة الأخطاء، ومستمعو الطلب المخصص.

لمعرفة المزيد عن بيكاسو، يمكنك الرجوع إلى وثائقها الرسمية. لمعرفة المزيد حول الترميز لنظام Android، تحقق من بعض الدورات والبرامج التعليمية الأخرى هنا على Envato Tuts +!

Advertisement
Advertisement
Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.