تشغيل نص Robo برمجي (على Android)

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

باستخدام نصوص Robo البرمجية، يمكنك تسجيل نفسك أثناء تنفيذ سير عمل في تطبيقك، ثم تحميل هذا التسجيل إلى Firebase Console لتشغيله في اختبارات Robo. عند إجراء اختبار Robo مع إرفاق نص برمجي، ينفِّذ Robo أولاً الإجراءات التي تشتمل على نص برمجي، ثم يستكشف التطبيق كالمعتاد.

تستخدم نصوص Robo البرمجية اختبار Robo كمحرّك للاختبار. في أبسط أشكالها، تتألف نصوص Robo البرمجية من تسلسل لإجراءات واجهة المستخدم، مثل إدخال النص "اسم المستخدم" ثم النقر على الزر "موافق". يمكن أن تتضمّن نصوص Robo البرمجية أيضًا إجراءات مثل انتظار ظهور عنصر، والنقر على نقطة معيّنة داخل عنصر، وتنفيذ أوامر shell في Android Debug Bridge‏ (adb).

تتميّز نصوص Robo البرمجية بالمزايا التالية مقارنةً بأُطر الاختبار التقليدية:

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

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

ننصحك باستخدام نصوص Robo البرمجية كلما أمكن ذلك لأنّه يمكن صيانتها بسهولة. على سبيل المثال، يمكنك استخدام نص Robo برمجي لإجراء ما يلي:

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

استخدِم ميزات نصوص Robo البرمجية الأكثر تقدّمًا لإجراء ما يلي:

• تنفيذ إجراءات قبل أن يبدأ Robo في الزحف إلى التطبيق قيد الاختبار أو بعد اكتمال عملية الزحف، على سبيل المثال، تنظيف بيانات التطبيق قيد الاختبار قبل عملية الزحف أو تغيير إعدادات الجهاز.
• تغيير جوانب سلوك Robo أثناء عملية الزحف، على وجه الخصوص:
  • جعل Robo يتجاهل بعض أدوات واجهة المستخدم أو شاشات التطبيق.
  • توفير إجراء مخصّص ليُنفّذه Robo عند الرجوع من شاشة معيّنة.
  • جعل Robo ينفّذ إجراءات معيّنة كلما تم العثور على شاشة تطبيق معيّنة أثناء عملية الزحف.
• تخصيص طريقة إجراء Robo لعملية الزحف بالكامل. على سبيل المثال، استخدِم مجموعة من الإجراءات المشروطة وغير المشروطة لإبقاء التطبيق قيد الاختبار في الخلفية طوال عملية الزحف، مع إجراء عمليات معالجة للجهاز وإغلاق أي مربّعات حوار منبثقة تظهر على طول الطريق.

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

تسجيل نص Robo برمجي باستخدام Test Lab في "استوديو Android"

يتيح لك مسجِّل نصوص Robo البرمجية في "استوديو Android" تسجيل نصوص Robo البرمجية من خلال التفاعل مباشرةً مع التطبيق على جهازك. اتّبِع هذه التعليمات للبدء في كتابة نصوص Robo البرمجية من خلال أداة Firebase في "استوديو Android":

1. افتح استوديو Android وانقر على الأدوات (Tools) -> Firebase.

2. في لوحة Firebase، انقر على تسجيل نص Robo برمجي واستخدامه لتوجيه اختبار Robo.

3. انقر على تسجيل نص Robo برمجي. يظهر مربّع الحوار "اختيار هدف النشر".

4. اختَر الجهاز الذي تريد تسجيل نص Robo البرمجي فيه.

5. بعد تسجيل نص Robo البرمجي على الجهاز، احفظ الملف كملف JSON في الموقع الجغرافي المطلوب.

6. افتح صفحة Test Lab في وحدة تحكم Firebase وحمِّل ملف النص البرمجي بتنسيق JSON وملف APK للتطبيق.

7. انقر على الزر متابعة. يُطلب منك اختيار الجهاز ومستوى واجهة برمجة التطبيقات. بعد اكتمال النص البرمجي للاختبار، Test Lab ينشئ الـ تقرير الاختبار.

8. (اختياري) لنسخ ملف logcat الخاص بتقرير الاختبار والفيديو أو تنزيلهما، انقر على عرض ملفات المصدر.

تمنع آليات متانة نصوص Robo البرمجية بشكل تلقائي تعرّضها للفشل مبكرًا. إذا اخترت وضع التنفيذ strict وفشل نص Robo برمجي في أي وقت، Test Lab سيتجاهل جميع الخطوات الإضافية في النص البرمجي ويستأنف عملية زحف Robo عادية. في معظم الأحيان، تفشل نصوص Robo البرمجية لأنّ Robo لا يمكنه العثور على عنصر مطلوب على الشاشة. لتجنُّب حالات الفشل، تأكَّد من أنّ عملية التنقل في تطبيقك يمكن التنبؤ بها وأنّ شاشاتك تظهر بترتيب محدّد.

تشغيل نص Robo برمجي في Test Lab

لتشغيل نص Robo برمجي في Test Lab، اتّبِع هذه التعليمات:

1. افتح صفحة Test Lab في وحدة تحكّم Firebase.

2. حمِّل ملف APK أو AAB للتطبيق في حقل ملف APK أو AAB للتطبيق.

3. حمِّل ملف نص Robo البرمجي المسجَّل أو الذي تم إنشاؤه يدويًا في حقل نص Robo البرمجي (اختياري).

توفير نص Robo برمجي لتشغيل اختبار Robo محليًا

لتوفير نص Robo برمجي لتشغيل اختبار Robo محليًا، استخدِم خيار اختبار Robo التالي:

--robo-script-file <robo-script-path>

استبدِل <robo-script-path> بمسار ملف نص Robo البرمجي في نظام الملفات المحلي. اتّبِع الـ تعليمات تشغيل اختبار Robo محليًا لـ.

تحديد نص Robo برمجي في طلب اختبار باستخدام gcloud CLI

لتحديد نص Robo برمجي في طلب اختبار باستخدام gcloud CLI، استخدِم علامة gcloud CLI التالية:

--robo-script = <robo-script-path>

استبدِل <robo-script-path> بمسار ملف نص Robo البرمجي في نظام الملفات المحلي أو في Cloud Storage باستخدام الرمز gs://. على سبيل المثال:

gcloud firebase test android run --app = <path_to_app_apk_file> --robo-script = <robo-script-path>

الخطوات التالية

• للتعرّف على بنية نصوص Robo البرمجية وإمكاناتها واستخدامها وإجراءاتها، اطّلِع على دليل مرجع نصوص Robo البرمجية.
• إجراء اختبار Robo.