在 Cloud Next 2025 大会上了解 Firebase 的最新资讯。了解详情。

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

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

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

كيفية استخدام موظّف دعم اختبار التطبيقات لبياناتك

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

قبل البدء

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

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

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

إنشاء نموذج اختبار

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

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

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

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

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

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

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

إجراء اختبار

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

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

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

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

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

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

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

شغِّل الأمر 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. لمزيد من المعلومات حول بدء استخدام IDE IDE Gradle والطُرق المختلفة لضبط عملية التوزيع، يُرجى الاطّلاع على مقالة توزيع تطبيقات Android على المختبِرين باستخدام IDE IDE 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 لنتائج الاختبار.

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

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

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

حصص الاختبار

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

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

لزيادة حصتك فوق الحدّ التلقائي، يُرجى التواصل مع فريق دعم Firebase وإرسال حالة الاستخدام.