تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

موظّف دعم اختبار التطبيقات (لنظام التشغيل Android)

‫App Testing هو وكيل لإنشاء حالات الاختبار وإدارتها وتنفيذها، وهو يستند إلى Gemini في Firebase. يمكنك تحديد أهداف الاختبار بلغة طبيعية، ويستخدم الوكيل الذكاء الاصطناعي لفهم تطبيقك والتنقّل فيه ومحاكاة تفاعلات المستخدمين وتقديم نتائج اختبار تفصيلية.

الطريقة التي يستخدم بها وكيل "اختبار التطبيق" بياناتك

يتم توفير وكيل "اختبار التطبيقات" من خلال Gemini في Firebase ويخضع للأحكام نفسها. يمكنك الاطّلاع على كيفية استخدام Gemini في Firebase لبياناتك لمزيد من المعلومات حول كيفية استخدام Gemini في Firebase لبياناتك.

قبل البدء

سجِّل تطبيقك في Firebase إذا لم يسبق لك إجراء ذلك.

إذا كنت لا تستخدم أي منتجات أخرى من Firebase، عليك فقط إنشاء مشروع وتسجيل تطبيقك، ولن تحتاج إلى إضافة أي حِزم SDK إلى تطبيقك. ومع ذلك، إذا قرّرت استخدام منتجات إضافية في المستقبل، احرص على إكمال جميع الخطوات الواردة في مقالة إضافة Firebase باستخدام وحدة تحكّم Firebase.

عندما تكون مستعدًا لتوزيع إصدار تجريبي من تطبيقك على المختبِرين، أنشئ حِزمة APK أو AAB باستخدام طريقتك العادية، ثم حمِّلها إلى App Distribution في وحدة تحكّم Firebase. يجب توقيع حزمة APK باستخدام مفتاح تصحيح الأخطاء أو مفتاح توقيع التطبيق.

إنشاء حالة اختبار

لتشغيل الاختبارات الموجَّهة بالذكاء الاصطناعي، يستخدم وكيل "اختبار التطبيق" حالات الاختبار باللغة الطبيعية لتنفيذ الاختبارات على تطبيقك.

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

لإنشاء حالة اختبار، افتح صفحة App Distribution في Firebase وحدة التحكّم واتّبِع الخطوات التالية:

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

مثال على حالة اختبار

في ما يلي مثال على كيفية إنشاء حالة اختبار باستخدام وكيل App Testing:

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

إجراء اختبار

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

يمكنك أيضًا اختيار إجراء اختبار زحف عشوائي من خلال تغيير نوع الاختبار. تستخدم اختبارات الزحف العشوائي ميزة المختبِر الآلي.

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

اختبار إصداراتك تلقائيًا

لتنفيذ اختبارات وكيل "اختبار التطبيق" تلقائيًا على الإصدارات الجديدة، مثلاً من مسارات CI/CD، يمكنك توزيع الإصدارات على الوكيل باستخدام مكوّنات Gradle الإضافية أو fastlane أو واجهة سطر الأوامر (CLI) من Firebase.App Distribution

اختبار إصداراتك تلقائيًا باستخدام Firebase CLI

يجب تحديد جهاز اختبار واحد على الأقل ورقم تعريف حالة اختبار واحدة على الأقل لاستخدام ميزة "وكيل اختبار التطبيق". يمكن العثور على أرقام تعريف حالات الاختبار وتنزيلها من صفحة "حالات الاختبار" في وحدة تحكّم Firebase. لمزيد من المعلومات حول كيفية البدء في استخدام واجهة سطر الأوامر (CLI) من Firebase والطرق المختلفة لإعداد التوزيع، اطّلِع على توزيع تطبيقات Android على المختبِرين باستخدام واجهة سطر الأوامر (CLI) من Firebase.

نفِّذ الأمر appdistribution:distribute لتحميل تطبيقك، واستخدِم المَعلمات التالية لضبط عملية التوزيع على ميزة "وكيل اختبار التطبيق":

appdistribution:distribute options
‫`--test-devices` أو `--test-devices-file`	الأجهزة الاختبارية التي تريد توزيع الإصدارات عليها من خلال ميزة "وكيل اختبار التطبيق" يمكنك تحديد أجهزة الاختبار كقائمة مفصولة بفواصل منقوطة: `--test-devices: "model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"` أو يمكنك تحديد مسار إلى ملف نص عادي يحتوي على قائمة بالأجهزة الاختبارية مفصولة بفواصل منقوطة: `--test-devices-file: "/path/to/test-devices.txt"`
`--test-username`	اسم المستخدم الذي سيتم استخدامه لتسجيل الدخول تلقائيًا أثناء الاختبارات
‫`--test-password` أو `--test-password-file`	كلمة المرور التي سيتم استخدامها أثناء الاختبارات لتسجيل الدخول تلقائيًا أو يمكنك تحديد مسار إلى ملف نص عادي يحتوي على كلمة مرور: `--test-password-file: "/path/to/test-password.txt"`
`--test-non-blocking`	إجراء الاختبارات بشكل غير متزامن انتقِل إلى "وحدة تحكّم Firebase" للاطّلاع على نتائج الاختبارات التلقائية.
‫`--test-case-ids` أو `--test-case-ids-file`	قائمة مفصولة بفواصل تتضمّن أرقام تعريف حالات الاختبار لتنفيذ الاختبارات المبرمَجة المستندة إلى الذكاء الاصطناعي: `--test-case-ids: "load-app,play-the-first-level"` أو يمكنك تحديد مسار إلى ملف نص عادي يحتوي على قائمة بمعرّفات حالات الاختبار مفصولة بفواصل أو أسطر جديدة: `--test-case-ids-file: "/path/to/test-case-ids.txt"`

اختبار الإصدارات تلقائيًا باستخدام Gradle

يجب تحديد جهاز اختبار واحد على الأقل ورقم تعريف حالة اختبار واحدة على الأقل لاستخدام ميزة "وكيل اختبار التطبيق". يمكن العثور على أرقام تعريف حالات الاختبار وتنزيلها من صفحة "حالات الاختبار" في وحدة تحكّم Firebase. لمزيد من المعلومات حول كيفية البدء باستخدام Gradle والطرق المختلفة لإعداد التوزيع، يمكنك الاطّلاع على مقالة توزيع تطبيقات Android على المختبِرين باستخدام Gradle.

يمكنك ضبط App Distribution من خلال إضافة قسم واحد على الأقل firebaseAppDistribution واستخدام المَعلمات التالية لضبط التوزيع على ميزة "وكيل اختبار التطبيق":

App Distribution مَعلمات الإنشاء
‫`testDevices` أو `testDevicesFile`	الأجهزة الاختبارية التي تريد توزيع الإصدارات عليها من خلال ميزة "وكيل اختبار التطبيق" يمكنك تحديد الأجهزة الاختبارية كقائمة بمواصفات الأجهزة مفصولة بفواصل منقوطة. `testDevices="model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"` أو يمكنك تحديد مسار إلى ملف يحتوي على قائمة بمواصفات الأجهزة مفصولة بفواصل منقوطة: `testDevicesFile="/path/to/testDevices.txt"`
`testUsername`	اسم المستخدم الذي سيتم استخدامه لتسجيل الدخول تلقائيًا أثناء الاختبارات
‫`testPassword` أو `testPasswordFile`	كلمة المرور التي سيتم استخدامها أثناء الاختبارات لتسجيل الدخول تلقائيًا أو يمكنك تحديد مسار إلى ملف نص عادي يحتوي على كلمة مرور: testPasswordFile="/path/to/testPassword.txt"
`testNonBlocking`	إجراء الاختبارات بشكل غير متزامن انتقِل إلى وحدة تحكّم Firebase للاطّلاع على نتائج الاختبار التلقائي.
‫`testCases`أو `testCasesFile`	قائمة مفصولة بفواصل تتضمّن أرقام تعريف حالات الاختبار لتنفيذ الاختبارات المبرمَجة المستندة إلى الذكاء الاصطناعي: `testCases: "load-app,play-the-first-level"` أو يمكنك تحديد مسار إلى ملف نص عادي يحتوي على قائمة بمعرّفات حالات الاختبار مفصولة بفواصل أو أسطر جديدة: `testCasesFile: "/path/to/test-case-ids.txt"`

اختبار إصداراتك تلقائيًا باستخدام fastlane

يجب تحديد جهاز اختبار واحد على الأقل ورقم تعريف حالة اختبار واحدة على الأقل لاستخدام ميزة "وكيل اختبار التطبيق". يمكن العثور على أرقام تعريف حالات الاختبار وتنزيلها من صفحة "حالات الاختبار" في وحدة تحكّم Firebase. لمزيد من المعلومات حول كيفية البدء في استخدام fastlane والطرق المختلفة لإعداد التوزيع، يُرجى الاطّلاع على مقالة توزيع تطبيقات Android على المختبِرين باستخدام fastlane.

في مسار ./fastlane/Fastfile، أضِف مجموعة firebase_app_distribution. استخدِم المَعلمات التالية لضبط إعدادات توزيع تطبيقك على ميزة "وكيل اختبار التطبيق":

مَعلمات Firebase App Distribution
‫`test_devices` أو `test_devices_file`	الأجهزة الاختبارية التي تريد توزيع الإصدارات عليها من خلال ميزة "وكيل اختبار التطبيق" يمكنك تحديد أجهزة الاختبار كقائمة مفصولة بفواصل منقوطة: `test_devices: "model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"` أو يمكنك تحديد مسار إلى ملف نص عادي يحتوي على قائمة بالأجهزة الاختبارية مفصولة بفواصل منقوطة: `test_devices_file: "/path/to/test-devices.txt"`
`test_username`	اسم المستخدم الذي سيتم استخدامه لتسجيل الدخول تلقائيًا أثناء الاختبارات
‫`test_password` أو `test_password_file`	كلمة المرور التي سيتم استخدامها أثناء الاختبارات لتسجيل الدخول تلقائيًا أو يمكنك تحديد مسار إلى ملف نص عادي يحتوي على كلمة مرور: `test_password_file: "/path/to/test-password.txt"`
`test_non_blocking`	إجراء الاختبارات بشكل غير متزامن انتقِل إلى "وحدة تحكّم Firebase" للاطّلاع على نتائج الاختبارات التلقائية.
‫`--test_case_ids` أو `--test_case_ids_file`	قائمة مفصولة بفواصل تتضمّن أرقام تعريف حالات الاختبار لتنفيذ الاختبارات المبرمَجة المستندة إلى الذكاء الاصطناعي: `--test_case_ids: "load-app,play-the-first-level"` أو يمكنك تحديد مسار إلى ملف نص عادي يحتوي على قائمة بمعرّفات حالات الاختبار مفصولة بفواصل أو أسطر جديدة: `--test_case_ids_file: "/path/to/test-case-ids.txt"`

تصحيح أخطاء نتائج الاختبار

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

يمكنك أيضًا استخدام الزر عرض العناصر في صفحة "نتائج الاختبار" للاطّلاع على جميع الفيديوهات والسجلات وغيرها من عناصر Cloud الخاصة بنتائج الاختبار.

المشاكل والقيود المعروفة

تتضمّن معاينة "وكيل اختبار التطبيق" بعض القيود المعروفة:

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

حصص الاختبار

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

يُرجى العِلم أنّه في حال اختيار تنفيذ عدّة حالات اختبار أو تنفيذ حالة الاختبار نفسها على أجهزة متعدّدة، سيتم احتساب ذلك على أنّه اختبارات متعدّدة. على سبيل المثال، إذا نفّذت حالتي اختبار على جهازَين، سيتم احتساب ذلك على أنّه إجمالي 4 اختبارات.

لزيادة حصتك عن الحدّ التلقائي، تواصَل مع فريق دعم Firebase وأخبره بحالة الاستخدام.