يوضِّح هذا المستند كيفية استخدام نصوص Robo البرمجية، وهي اختبارات لأتمتة مهام تأكيد الجودة اليدوية لتطبيقات الأجهزة الجوّالة، وتفعيل الدمج المستمر (CI) واستراتيجيات اختبار الإطلاق التجريبي. على سبيل المثال، يمكنك استخدام نصوص Robo البرمجية لاختبار رحلة مستخدم شائعة أو توفير مدخلات واجهة مستخدم (UI) محددة، مثل اسم المستخدم وكلمة المرور. تُعد نصوص Robo البرمجية إحدى ميزات اختبار Robo
باستخدام نصوص Robo البرمجية، يمكنك تسجيل نفسك أثناء اتّباعك سير العمل في تطبيقك. بعد ذلك عليك تحميل ذلك التسجيل إلى وحدة تحكّم "Firebase" لتشغيله في Robo. الاختبار. عند إجراء اختبار Robo مع إرفاق نص برمجي، يبدأ Robo في الخطوات الأولى من خلال الإجراءات التي تستلزم وصفة طبية ثم يستكشف التطبيق كالمعتاد.
تستخدم نصوص Robo البرمجية اختبار Robo
كمحرك الاختبار. يتألف نص Robo البرمجي في أبسط صوره من
تسلسل إجراءات واجهة المستخدم مثل إدخال النص "username"
ثم انقر على الزر "حسنًا". يمكن أن تتضمن نصوص Robo البرمجية أيضًا إجراءات مثل الانتظار
لكي يظهر العنصر، والنقر عند نقطة معيّنة داخله
يتم من خلال تنفيذ أوامر واجهة أوامر Android Debug Bridge (adb).
وتتمتع نصوص Robo البرمجية بالمزايا التالية التي تفوق أطر الاختبار التقليدية:
| الإمكانات | الوصف |
| قوي للغاية | يمكن أن تخضع نصوص Robo لمفاهيم هيكلية وسلوكية مهمّة الاختلافات بين إصدارات التطبيق وتقويته. |
| مفتوح وغير محدد | بعد اكتمال نص Robo البرمجي، يمكن أن يتولى اختبار Robo الأساسي مواصلة اختبار التطبيق. يتيح نهج الاختبار المستمر هذا والعديد من حالات الاستخدام الرئيسية. على سبيل المثال، يمكنك استخدام نص Robo برمجي لجلب تطبيق إلى حالة معينة من خلال تنفيذ عملية تسجيل دخول مخصصة. |
| قابلة للتسجيل | لست بحاجة إلى ترميز نصوص Robo البرمجية يدويًا. يمكن تسجيلها باستخدام أداة تسجيل نصوص Robo البرمجية في "استوديو Android". إنشاء Robo أو تعديله لا تتطلب النصوص البرمجية عادةً أي معرفة بتطوير مواقع الويب. |
| مرن | يمكن أن تتفاعل نصوص 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"، اتّبِع الخطوات التالية:
افتح استوديو Android. وحدد الأدوات -> Firebase:
في جزء Firebase، انقر على تسجيل نص Robo البرمجي واستخدامه لتوجيه اختبار Robo
انقر على تسجيل نص Robo البرمجي. مربّع الحوار "اختيار هدف النشر" تظهر.
اختَر الجهاز الذي تريد تسجيل نص Robo البرمجي فيه.
بعد تسجيل نص Robo البرمجي في الجهاز، احفظ الملف كملف JSON. في الموقع المطلوب.
افتح صفحة Test Lab في وحدة تحكّم Firebase وحمِّل ملف JSON. ملف النص البرمجي وحزمة APK للتطبيق.
انقر على زر متابعة. سيُطلب منك اختيار الجهاز مستوى واجهة برمجة التطبيقات. بعد اكتمال النص البرمجي للاختبار، ينشئ Test Lab الملف تقرير الاختبار.
(اختياري) لنسخ أو تنزيل أداة Logcat لتقرير الاختبار والفيديو، انقر على عرض ملفات المصدر.
وفقًا للإعدادات التلقائية، تمنع آليات قوة نص Robo البرمجي من الإخفاق مبكرًا.
إذا اخترت وضع تنفيذ strict وتعذّر تشغيل نص Robo برمجي في أي وقت،
تتجاهل Test Lab جميع الخطوات الأخرى في النص البرمجي وتستأنف عملية
الزحف إلى Robo في أغلب الأحيان، تتعذّر نصوص Robo البرمجية بسبب عدم قدرة Robo على العثور على
العنصر على الشاشة. لتجنُّب الإخفاق، تأكَّد من ضبط التنقُّل في تطبيقك
إمكانية التنبؤ بها وأن شاشاتك تظهر بترتيب حاسم.
تنفيذ نص Robo برمجي في Test Lab
لتشغيل نص Robo برمجي في Test Lab، اتّبِع التعليمات التالية:
افتح صفحة "Test Lab" في وحدة تحكّم Firebase.
حمِّل حِزمة APK أو AAB للتطبيق في حقل AAB أو حزمة APK للتطبيق.
حمِّل ملف نص 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