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

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

باستخدام نصوص Robo البرمجية، يمكنك تسجيل نفسك أثناء تنفيذ سير عمل في تطبيقك، ثم تحميل هذا التسجيل إلى وحدة تحكّم Firebase لتشغيله في اختبارات 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