تشغيل نص 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.