وكيل اختبار التطبيقات هو وكيل لإنشاء أُطر الاختبار وإدارتها وتنفيذها، وهو مستنِد إلى Gemini في Firebase. يمكنك تحديد أهداف الاختبار بلغة طبيعية، ويستخدم الوكيل الذكاء الاصطناعي لفهم تطبيقك والتنقّل فيه، ومحاكاة تفاعلات المستخدمين، وتقديم نتائج اختبار مفصّلة.
كيفية استخدام وكيل اختبار التطبيقات لبياناتك
يتم توفير وكيل اختبار التطبيقات من خلال Gemini في Firebase ويخضع للأحكام نفسها. يمكنك الاطّلاع على كيفية استخدام "Gemini في Firebase" لبياناتك لمزيد من المعلومات حول كيفية استخدام "Gemini في Firebase" لبياناتك.
قبل البدء
سجِّل تطبيقك في Firebase، إذا لم يسبق لك إجراء ذلك.
إذا لم تكن تستخدم أي منتجات أخرى من Firebase، ما عليك سوى إنشاء مشروع وتسجيل تطبيقك. ولن تحتاج إلى إضافة أي حزم تطوير برامج (SDK) إلى تطبيقك. ومع ذلك، إذا قررت استخدام منتجات إضافية في المستقبل، تأكَّد من إكمال جميع الخطوات الواردة في مقالة إضافة Firebase باستخدام وحدة تحكّم Firebase.
إنشاء إطار اختبار
لإجراء اختبارات موجَّهة بالذكاء الاصطناعي، يستخدم وكيل اختبار التطبيقات أُطر الاختبار باللغة الطبيعية لإجراء الاختبارات على تطبيقك.
يتم تقسيم كل إطار اختبار إلى خطوات يتم تنفيذها بالتسلسل. تتيح لك الخطوات تقسيم إطار الاختبار إلى مراحل، لكل منها تأكيدها الخاص. قد يتّخذ الوكيل العديد من الإجراءات خلال أي خطوة واحدة.
هناك طريقتان لإنشاء إطار اختبار: باستخدام ملف YAML أو باستخدام وحدة تحكّم Firebase. تتيح لك ملفات YAML إدارة إطارات الاختبار بنفسك، عادةً في مستودع رموز مصدر تم تحديد إصداره. بدلاً من ذلك، يمكن أن تخزّن "وحدة تحكُّم Firebase" أُطر الاختبار عن بُعد مع بيانات App Distribution.
استخدام ملفات YAML
يوضّح المثال التالي ملف YAML يحدّد إطارَي اختبار:
tests:
- displayName: Login as guest
id: login-as-guest
steps:
- goal: Log in as a guest
finalScreenAssertion: The home screen is visible
- displayName: View biography card birth date
prerequisiteTestCaseId: login-as-guest
steps:
- goal: Open the article on "Bob Dylan"
hint: Use the search function to find it
finalScreenAssertion: >-
The article is opened and the title "Bob Dylan" is visible.
- goal: Find Bob Dylan's birthday in the article
hint: >-
Look for the "Born" section in the infobox on the right side of the page.
finalScreenAssertion: >-
The text "May 24, 1941" is visible on the screen.
يمكنك تنظيم مجموعات من الاختبارات في ملف واحد وفصل هذه الحزم الاختبارية
في ملفات متعددة. يمكنك إضافة إطار اختبار شرط أساسي من خلال إضافة معرّف إلى
الاختبار ثم الإشارة إلى هذا المعرّف باستخدام prerequisiteTestCaseId.
استخدام وحدة تحكّم "App Distribution"
بدلاً من ذلك، يمكنك إنشاء أُطر الاختبار وإدارتها في وحدة تحكُّم Firebase. لإنشاء إطار اختبار، افتح صفحة App Distribution في وحدة تحكّم Firebase واتّبِع الخطوات التالية:
- في علامة التبويب إطارات الاختبار، انقر على إطار اختبار جديد. إذا كنت لا تريد إنشاء إطار اختبار خاص بك، يمكنك تعديل أو استخدام مثال إطار الاختبار المقدَّم.
- في مربّع الحوار إضافة إطار اختبار، أدخِل اسمًا لإطار الاختبار. يُستخدَم هذا الحقل لتحديد الاختبار، ولكن يتجاهله الوكيل.
- (اختياري) اختَر إطار اختبار أساسي يحتوي على خطوات الإعداد التي يجب تنفيذها قبل الاختبار الرئيسي. إذا تعذّر الاختبار الأساسي، سيتم وضع علامة على الاختبار بأكمله على أنّه تعذّر. سيتم عرض الخطوات والنتائج من الاختبارات الأساسية والرئيسية معًا في نتائج الاختبار.
- ننصحك بتقسيم الاختبار إلى خطوات متعددة، وذلك بالنقر على الزر إضافة خطوة أخرى.
- حدِّد لكل خطوة هدفًا يصف ما يجب أن يفعله وكيل اختبار التطبيقات خلال هذه الخطوة.
- (اختياري) أضِف تلميحًا لتقديم معلومات إضافية تساعد "وكيل اختبار التطبيقات" في فهم تطبيقك والتنقّل فيه خلال هذه الخطوة.
- أضِف تأكيد الشاشة النهائية لمساعدة وكيل اختبار التطبيقات في تحديد وقت إكمال الخطوة بنجاح. يجب أن يشير هذا التأكيد فقط إلى ما يظهر على الشاشة.
- انقر على حفظ بعد الانتهاء من تخصيص الاختبار.
مثال على إطار الاختبار
في ما يلي مثال على كيفية إنشاء إطار اختبار باستخدام وكيل "اختبار التطبيقات":
عنوان تجريبي |
عمليات تحميل الصفحة الرئيسية |
الهدف |
تحميل الصفحة الرئيسية |
تلميح |
تخطَّ أي شاشات إعداد. أغلِق أي نوافذ منبثقة. عدم تسجيل الدخول |
تأكيد الشاشة النهائية |
تظهر الصفحة الرئيسية للتطبيق على الشاشة، وتم تحميل جميع الصور، ولا تظهر أي أخطاء. |
إجراء بث تجريبي
تعتمد طريقة إجراء الاختبارات على كيفية إنشاء أُطر الاختبار وإدارتها. إذا حدّدت حالات الاختبار باستخدام ملفات YAML، فستُجري هذه الاختبارات باستخدام Firebase CLI. إذا أنشأت أُطر الاختبار في وحدة تحكّم App Distribution، سيتم تشغيلها من وحدة التحكّم أو من خلال إحدى أدوات سطر أوامر App Distribution.
استخدام ملفات YAML
يمكن تنفيذ أُطر الاختبار المحدّدة في ملفات YAML باستخدام Firebase CLI.
- ثبِّت أحدث إصدار من Firebase CLI أو حدِّثه. ننصحك بتنزيل الملف الثنائي المستقل لواجهة سطر الأوامر (CLI) المخصّص لنظام التشغيل لديك.
- سجِّل الدخول وتأكَّد من إمكانية الوصول إلى مشاريعك. يُرجى العِلم أنّه في حال استخدام Firebase CLI في بيئة CI، يمكنك أيضًا المصادقة باستخدام حساب خدمة أو باستخدام login:ci.
نفِّذ الأمر
apptesting:execute. على سبيل المثال:firebase apptesting:execute \ --app=1:1234567890:android:0a1b2c3d4e5f67890 \ --test-dir=./mytests \ ./app/build/outputs/apk/debug/app-debug.apk
| apptesting:execute [options] [/path/to/app/binary] | |
|---|---|
--app
|
مطلوب: معرّف تطبيق Firebase الخاص بتطبيقك. يمكنك العثور على معرّف التطبيق في وحدة تحكّم "Firebase"، في صفحة الإعدادات العامة.
|
--test-dir
|
المسار إلى دليل يحتوي على ملفات YAML لإطار الاختبار. سيبحث الأمر بشكل متكرر ضمن هذا الدليل، لذا يمكن تنظيم الملفات في أدلة فرعية بشكل اختياري. وفي حال ترك هذه السياسة بدون ضبط، يتم استخدام "./tests" بشكل تلقائي. |
--test-devices أو --test-devices-file
|
الأجهزة التي سيتم إجراء الاختبارات عليها يمكنك تحديد أجهزة الاختبار كقائمة بمواصفات الأجهزة مفصولة بفواصل منقوطة: --test-devices
"model=tokay,version=36,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"
أو يمكنك تحديد المسار إلى ملف نص عادي يحتوي على قائمة بمواصفات الأجهزة مفصولة بفواصل منقوطة: --test-devices-file
"/path/to/test-devices.txt" يمكنك البحث عن طُرز الأجهزة المتاحة باستخدام gcloud CLI. |
--test-username
|
اسم المستخدم لتسجيل الدخول التلقائي الذي سيتم استخدامه أثناء الاختبارات |
--test-password أو --test-password-file
|
كلمة المرور لتسجيل الدخول التلقائي التي سيتم استخدامها أثناء الاختبارات أو يمكنك تحديد المسار إلى ملف نص عادي يحتوي على كلمة مرور: --test-password-file: "/path/to/test-password.txt"
|
--test-non-blocking
|
في حال ضبط هذا الخيار، سيبدأ الأمر الاختبارات ثم يعود فورًا بدلاً من انتظار اكتمالها. للاطّلاع على نتائج الاختبار، يُرجى الانتقال إلى وحدة تحكُّم Firebase. إذا لم يتم ضبط هذه العلامة، سيتم حظر الأمر إلى أن تكتمل الاختبارات، وسيتم الخروج برمز تعذُّر في حال تعذُّر أي من الاختبارات. |
--results-bucket
|
حزمة Google Cloud Storage (GCS) مخصّصة يتم فيها تخزين نتائج الاختبارات. وفي حال ترك هذا الحقل فارغًا، يتم استخدام الحزمة التلقائية. يجب أن يكون الحزمة مملوكًا لمشروع تم تفعيل الفوترة فيه، ويؤدي تحديد حزمة إلى فرض رسوم فوترة على مساحة التخزين المستخدَمة. |
--test-file-pattern
|
نمط تعبير عادي سيتم تنفيذ الاختبارات المضمّنة في الملفات التي تتطابق مع هذا النمط فقط. |
--test-name-pattern
|
نمط تعبير عادي سيتم تنفيذ الاختبارات التي تتطابق أسماؤها المعروضة مع هذا النمط فقط. |
/path/to/app/binary
|
اختياري: مسار الملف الثنائي لتطبيقك في حال عدم تحديد الإصدار، سيستخدم الوكيل آخر إصدار تم تحميله إلى App Distribution للتطبيق المحدّد. |
استخدام وحدة تحكّم "App Distribution"
لتشغيل إطارات الاختبار المخزَّنة في App Distribution، يمكنك استخدام وحدة تحكّم Firebase أو Firebase CLI أو المكوّنات الإضافية Gradle أو fastlane في App Distribution.
استيراد أُطر الاختبار وتصديرها باستخدام ملفات YAML
يُعدّ استيراد أُطر الاختبار من ملفات YAML مفيدًا عندما تريد إدارة أُطر الاختبار خارج وحدة تحكّم Firebase. قد يكون من المفيد أيضًا تصدير أُطر الاختبار لنقلها بين المشاريع. يمكنك استخدام نموذج لغوي كبير لتحسين أُطر الاختبار الحالية أو إنشاء أُطر اختبار جديدة. يمكنك استيراد أُطر الاختبار وتصديرها من صفحة "أُطر الاختبار" في وحدة تحكّم "Firebase" أو آليًا باستخدام Firebase CLI. للاطّلاع على مثال على إطار اختبار YAML، يُرجى مراجعة إنشاء إطار اختبار YAML.
عرض نتائج الاختبار
يمكنك الاطّلاع على نتائج الاختبارات من صفحة الإصدارات في علامة التبويب وكيل اختبار التطبيقات ضمن أحد الإصدارات. سيؤدي النقر على زر عرض التفاصيل إلى فتح مربّع حوار "نتائج الاختبار" وعرض أي مشاكل ولقطات شاشة للتطبيق والإجراءات التي اتّخذها Gemini أثناء الاختبار.
إذا كان الاختبار يتضمّن إجراءات مُعادة، يمكنك الاطّلاع على الاختبار الأصلي الموجَّه بالذكاء الاصطناعي أو محو ذاكرة التخزين المؤقت.
لمزيد من المعلومات حول نتائج الاختبار، استخدِم الجدول التالي:
| الرمز | الاسم | الوصف |
|---|---|---|
| spark | إجراء الذكاء الاصطناعي | يشير ذلك إلى أنّ وكيل اختبار التطبيقات استخدم Gemini لاتخاذ قرار بشأن تنفيذ إجراء أو إنهاء الخطوة. |
| إعادة التشغيل | تمت إعادة تشغيل الإجراء | يشير ذلك إلى أنّ وكيل اختبار التطبيقات أعاد تنفيذ إجراء من عملية تشغيل سابقة ناجحة للاختبار. |
| spark | تأكيد الذكاء الاصطناعي | يشير ذلك إلى أنّ "وكيل اختبار التطبيقات" استخدم Gemini للتحقّق من صحة تأكيد الشاشة النهائية، بعد إعادة تنفيذ الإجراءات من عملية تشغيل سابقة ناجحة للاختبار نفسه. |
تصحيح أخطاء نتائج الاختبار
إذا كانت نتائج الاختبار مختلفة عمّا توقّعته، يمكنك تصحيح أخطاء الاختبار باستخدام زر التبديل عرض الوكيل ضمن عرض التفاصيل في صفحة "نتائج الاختبار". تعرض لك طريقة عرض الوكيل العناصر التي تظهر على الشاشة والتي تمكّن وكيل اختبار التطبيقات من رصدها عند استخدام معلومات تسهيل الاستخدام في التطبيق. إذا كنت ترغب في إلقاء نظرة فاحصة على ما رآه الوكيل، يمكنك تنزيل هذه المعلومات من قائمة تجاوز الإجراءات.
يمكنك أيضًا استخدام زر عرض العناصر في صفحة "نتائج الاختبار" للاطّلاع على جميع الفيديوهات والسجلّات وعناصر Cloud الأخرى لنتائج الاختبار.
الحدود والمشاكل المعروفة
تتضمّن النسخة الحصرية من "وكيل اختبار التطبيقات" بعض القيود المعروفة:
- الحد الأقصى لمدة الاختبارات الموجَّهة بالذكاء الاصطناعي هو 5 دقائق. بعد بدء الاختبار، يجب أن ينجح خلال هذه المدة، وإلا سينتهي مبكرًا ويتم احتسابه على أنّه تعذّر الاختبار.
- بما أنّ وكيل اختبار التطبيقات يستخدم الذكاء الاصطناعي التوليدي لاختبار تطبيقك، سيتّخذ أحيانًا إجراءات مختلفة مع الالتزام بالتعليمات نفسها.
- لا يتيح "وكيل اختبار التطبيقات" سوى الإجراءات التالية: النقر، وإدخال النص، والتمرير السريع للأعلى/للأسفل/لليسار/لليمين، والضغط مع الاستمرار، والسحب والإفلات، والرجوع، والانتظار.
- يواجه وكيل اختبار التطبيقات مشكلة في تنفيذ الاختبارات التي تحتوي على خطوة واحدة فقط تتطلّب تنفيذ العديد من الإجراءات لإنجازها. ويكون أداؤه أفضل عندما يتم تقسيم المهام المعقّدة إلى خطوات متعددة أقصر.
- في بعض الأحيان، لا يمرّر وكيل اختبار التطبيقات الشاشة لعرض العناصر الأخرى غير الظاهرة. يحدث هذا غالبًا عندما لا يكون هناك مؤشر مرئي لإمكانية التمرير. كحل بديل، يمكن استخدام حقل "التلميحات" لاقتراح التمرير.
- يواجه وكيل اختبار التطبيقات أحيانًا مشكلة في العدّ، مثل تنفيذ إجراء لعدد معيّن من المرات.
- لا يمكن لوكيل اختبار التطبيقات التنقّل في تطبيقك إذا كان
FLAG_SECUREمفعَّلاً. وبدلاً من لقطات الشاشة لتطبيقك، لن يرى سوى شاشة فارغة.
حصص الاختبار
خلال فترة المعاينة، سيتم تقديم الاختبارات الموجَّهة بالذكاء الاصطناعي بدون أي تكلفة ضمن حدّ الحصة. الحدّ الأقصى التلقائي للحصة هو 200 اختبار شهريًا لكل مشروع على Firebase.
يُرجى العِلم أنّه إذا اخترت تشغيل عدة أُطر اختبار أو تشغيل إطار الاختبار نفسه على أجهزة متعددة، سيتم احتساب ذلك كاختبارات متعددة. على سبيل المثال، إذا أجريت إطارَي اختبار على جهازَين، سيتم احتساب ذلك كإجمالي 4 اختبارات.
لزيادة حصتك عن الحدّ التلقائي، يُرجى التواصل مع فريق دعم Firebase مع توضيح حالة الاستخدام.