يمثّل مصدر عدم النشاط عملية غير متزامنة تؤثر نتائجها في العمليات اللاحقة في اختبار واجهة المستخدم. من خلال تسجيل مصادر عدم النشاط باستخدام Espresso، يمكنك التحقّق من صحة هذه العمليات غير المتزامنة بشكل أكثر موثوقية عند اختبار تطبيقك.
تحديد الحالات التي تكون فيها مصادر عدم النشاط مطلوبة
يوفّر Espresso مجموعة متطوّرة من
إمكانات المزامنة. ومع ذلك، لا تنطبق هذه السمة في إطار العمل إلا على العمليات التي تنشر الرسائل على MessageQueue، مثل فئة فرعية من View ترسم محتواها على الشاشة.
بما أنّ Espresso لا يرصد أي عمليات غير متزامنة أخرى، بما في ذلك تلك التي يتم تنفيذها في سلسلة مهام في الخلفية، لا يمكنه تقديم ضمانات المزامنة في هذه الحالات. لإعلام Espresso بالعمليات التي تستغرق وقتًا طويلاً في تطبيقك، يجب تسجيل كل عملية كمصدر عدم نشاط.
إذا لم تستخدم مصادر عدم النشاط عند اختبار نتائج العمل غير المتزامن لتطبيقك، قد تضطر إلى استخدام أحد الحلول البديلة السيئة التالية لتحسين موثوقية اختباراتك:
- جارٍ إضافة طلبات عرض الإعلان إلى
Thread.sleep(). عند إضافة تأخيرات اصطناعية إلى اختباراتك، يستغرق الأمر وقتًا أطول حتى تنتهي حزمة الاختبار من التنفيذ، وقد تظل اختباراتك تفشل أحيانًا عند تنفيذها على أجهزة أبطأ. بالإضافة إلى ذلك، لا يمكن توسيع نطاق هذه التأخيرات بشكل جيد، لأنّ تطبيقك قد يضطر إلى تنفيذ المزيد من الأعمال غير المتزامنة التي تستغرق وقتًا طويلاً في إصدار مستقبلي. - تنفيذ برامج تضمين إعادة المحاولة التي تستخدم حلقة للتحقّق بشكل متكرّر مما إذا كان تطبيقك لا يزال يؤدي عملاً غير متزامن إلى أن تنتهي المهلة. حتى إذا حددت الحد الأقصى لعدد مرات إعادة المحاولة في اختباراتك، فإن كل إعادة تنفيذ تستهلك موارد النظام، وخاصة وحدة المعالجة المركزية.
- استخدام مثيلات
CountDownLatchالتي تسمح لسلسلة تعليمات واحدة أو أكثر بالانتظار حتى يكتمل عدد معيّن من العمليات التي يتم تنفيذها في سلسلة تعليمات أخرى تتطلّب هذه العناصر تحديد مدة المهلة، وإلا قد يتم حظر تطبيقك إلى أجل غير مسمى. تضيف المزالج أيضًا تعقيدًا غير ضروري إلى التعليمات البرمجية الخاصة بك، مما يجعل الصيانة أكثر صعوبة.
تتيح لك أداة Espresso إزالة هذه الحلول البديلة غير الموثوقة من اختباراتك وتسجيل العمل غير المتزامن لتطبيقك كمصادر عدم نشاط بدلاً من ذلك.
حالات الاستخدام الشائعة
عند إجراء عمليات مشابهة للأمثلة التالية في اختباراتك، ننصحك باستخدام مصدر عدم النشاط:
- تحميل البيانات من الإنترنت أو من مصدر بيانات محلي
- إنشاء اتصالات بقواعد البيانات وعمليات الاستدعاء
- إدارة الخدمات، إما باستخدام خدمة تابعة لنظام التشغيل أو مثيل من
IntentService - تنفيذ منطق أعمال معقّد، مثل عمليات تحويل الصور النقطية
من المهم بشكل خاص تسجيل مصادر عدم النشاط عندما تعدّل هذه العمليات واجهة مستخدم تتحقّق منها اختباراتك بعد ذلك.
أمثلة على عمليات تنفيذ مصادر عدم النشاط
توضّح القائمة التالية عدة أمثلة على عمليات تنفيذ مصادر عدم النشاط التي يمكنك دمجها في تطبيقك:
CountingIdlingResource- يحتفظ بعدّاد للمهام النشطة. عندما يكون العدّاد صفرًا، يُعتبر المورد
المرتبط به غير نشط. تشبه هذه الوظيفة إلى حد كبير وظيفة
Semaphore. في معظم الحالات، يكون هذا التنفيذ كافيًا لإدارة العمل غير المتزامن لتطبيقك أثناء الاختبار. UriIdlingResource- يشبه
CountingIdlingResource، ولكن يجب أن يكون العدّاد صفرًا لفترة زمنية محدّدة قبل أن يتم اعتبار المورد غير نشط. تأخذ فترة الانتظار الإضافية هذه في الاعتبار طلبات الشبكة المتتالية، حيث قد يرسل تطبيق في سلسلة المحادثات طلبًا جديدًا فور تلقّي ردّ على طلب سابق. IdlingThreadPoolExecutor- تنفيذ مخصّص لـ
ThreadPoolExecutorيتتبّع إجمالي عدد المهام قيد التشغيل ضمن مجموعات سلاسل المحادثات التي تم إنشاؤها. تستخدم هذه الفئةCountingIdlingResourceللاحتفاظ بعدّاد المهام النشطة. IdlingScheduledThreadPoolExecutor- تنفيذ مخصّص لـ
ScheduledThreadPoolExecutor. وتوفّر هذه الفئة الوظائف والإمكانات نفسها التي توفّرها الفئةIdlingThreadPoolExecutor، ولكن يمكنها أيضًا تتبُّع المهام المجدوَلة في المستقبل أو المجدوَلة للتنفيذ بشكل دوري.
إنشاء مصدر عدم نشاط خاص بك
عند استخدام مصادر عدم النشاط في اختبارات تطبيقك، قد تحتاج إلى توفير إدارة مخصّصة للمصادر أو التسجيل. وفي هذه الحالات، قد لا تكون عمليات التنفيذ المدرَجة في القسم السابق كافية. في هذه الحالة، يمكنك توسيع نطاق أحد عمليات تنفيذ مصادر عدم النشاط هذه أو إنشاء عملية خاصة بك.
إذا كنت تستخدم وظيفة مصدر عدم النشاط الخاصة بك، يُرجى مراعاة أفضل الممارسات التالية، لا سيما الممارسة الأولى:
- استدعاء عمليات الانتقال إلى حالة عدم النشاط خارج عمليات التحقّق من عدم النشاط
- بعد أن يصبح تطبيقك غير نشط، يمكنك استدعاء
onTransitionToIdle()خارج أي عمليات تنفيذ لـisIdleNow(). بهذه الطريقة، لا يُجري Espresso عملية تحقّق ثانية غير ضرورية لتحديد ما إذا كان مصدر عدم النشاط المحدّد غير نشط.
يوضّح مقتطف الرمز التالي هذا الاقتراح:
fun isIdle() { // DON'T call callback.onTransitionToIdle() here! } fun backgroundWorkDone() { // Background work finished. callback.onTransitionToIdle() // Good. Tells Espresso that the app is idle. // Don't do any post-processing work beyond this point. Espresso now // considers your app to be idle and moves on to the next test action. }
- سجِّل مصادر عدم النشاط قبل الحاجة إليها.
لا تسري مزايا المزامنة المرتبطة بمصادر عدم النشاط إلا بعد استدعاء Espresso الأول لطريقة
isIdleNow()الخاصة بهذا المصدر.تعرض القائمة التالية عدة أمثلة على هذه السمة:
- إذا سجّلت مصدر عدم نشاط في طريقة تمّت إضافة تعليق توضيحي إليها باستخدام
@Before، سيتم تفعيل مصدر عدم النشاط في السطر الأول من كل اختبار. - إذا سجّلت مصدر عدم نشاط داخل اختبار، سيتم تفعيل مصدر عدم النشاط أثناء الإجراء التالي المستنِد إلى Espresso. يستمر هذا السلوك حتى إذا كان الإجراء التالي في الاختبار نفسه الذي يتضمّن العبارة التي تسجّل مصدر عدم النشاط.
- إذا سجّلت مصدر عدم نشاط في طريقة تمّت إضافة تعليق توضيحي إليها باستخدام
- إلغاء تسجيل مصادر عدم النشاط بعد الانتهاء من استخدامها
للحفاظ على موارد النظام، يجب إلغاء تسجيل مصادر عدم النشاط فور عدم الحاجة إليها. على سبيل المثال، إذا سجّلت مصدر عدم نشاط في طريقة تمّت إضافة تعليق توضيحي إليها باستخدام
@Before، من الأفضل إلغاء تسجيل هذا المصدر في طريقة مقابلة تمّت إضافة تعليق توضيحي إليها باستخدام@After.- استخدِم سجلّ عدم النشاط لتسجيل مصادر عدم النشاط وإلغاء تسجيلها.
باستخدام هذه الحاوية لمصادر عدم النشاط في تطبيقك، يمكنك تسجيل مصادر عدم النشاط وإلغاء تسجيلها بشكل متكرر حسب الحاجة مع الحفاظ على سلوك متسق.
- احتفِظ بحالة التطبيق البسيطة فقط ضمن مصادر عدم النشاط.
على سبيل المثال، يجب ألا تحتوي مصادر عدم النشاط التي تنفّذها وتسجّلها على مراجع لعناصر
View.
تسجيل مصادر عدم النشاط
يوفّر Espresso فئة حاوية يمكنك وضع مصادر عدم النشاط الخاصة بتطبيقك فيها. هذه الفئة، التي تُسمى
IdlingRegistry، هي
عنصر مستقل يقدّم الحد الأدنى من النفقات العامة لتطبيقك. تتيح لك الفئة
أيضًا اتّخاذ الخطوات التالية لتحسين
قابلية صيانة تطبيقك:
- أنشئ مرجعًا إلى
IdlingRegistry، بدلاً من مصادر عدم النشاط التي يحتوي عليها، في اختبارات تطبيقك. - الحفاظ على الاختلافات في مجموعة مصادر عدم النشاط التي تستخدمها لكل تنويعة تصميم
- حدِّد مصادر عدم النشاط في خدمات تطبيقك، بدلاً من مكوّنات واجهة المستخدم التي تشير إلى تلك الخدمات.
دمج مصادر عدم النشاط في تطبيقك
على الرغم من أنّه يمكنك إضافة مصادر عدم النشاط إلى تطبيق بعدة طرق مختلفة، فإنّ هناك طريقة واحدة على وجه الخصوص تحافظ على التغليف لتطبيقك مع السماح لك بتحديد عملية معيّنة يمثّلها مصدر عدم نشاط معيّن.
الطريقة المُقترحة
عند إضافة مصادر عدم النشاط إلى تطبيقك، ننصحك بشدة بوضع منطق مصدر عدم النشاط في التطبيق نفسه وإجراء عمليات التسجيل وإلغاء التسجيل فقط في الاختبارات.
على الرغم من أنّك تنشئ حالة غير معتادة لاستخدام واجهة مخصّصة للاختبار فقط في رمز الإنتاج باتّباع هذا الأسلوب، يمكنك تضمين مصادر عدم النشاط في الرمز الذي لديك حاليًا، مع الحفاظ على حجم حزمة APK لتطبيقك وعدد الطرق.
طرق بديلة
إذا كنت تفضّل عدم استخدام منطق مصادر عدم النشاط في رمز الإنتاج الخاص بتطبيقك، فهناك العديد من استراتيجيات الدمج الأخرى القابلة للتطبيق:
- أنشئ تنويعات تصميم، مثل صيغ المنتج في Gradle، واستخدِم مصادر عدم النشاط فقط في الإصدار المخصّص لتصحيح الأخطاء في تطبيقك.
- استخدِم إطار عمل لإدخال التبعية مثل Dagger لإدخال الرسم البياني لتبعية مصدر عدم النشاط في تطبيقك في اختباراتك. إذا كنت تستخدم Dagger 2، يجب أن يكون الحقن نفسه من مكوّن فرعي.
نفِّذ مصدر عدم نشاط في اختبارات تطبيقك، واكشف عن الجزء من تنفيذ تطبيقك الذي يجب مزامنته في تلك الاختبارات.
تنبيه: على الرغم من أنّ قرار التصميم هذا يبدو أنّه ينشئ مرجعًا قائمًا بذاته لمصادر عدم النشاط، إلا أنّه يكسر أيضًا التغليف في جميع التطبيقات باستثناء أبسطها.
مراجع إضافية
لمزيد من المعلومات حول استخدام Espresso في اختبارات Android، يُرجى الاطّلاع على المراجع التالية.
نماذج
- IdlingResourceSample: المزامنة مع المهام التي يتم تنفيذها في الخلفية