المختبِر المبرمَج (Android)

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

يشرح هذا الدليل كيفية اختبار تطبيقك تلقائيًا باستخدام ميزة App Distribution المختبِر الآلي في وحدة تحكّم Firebase. يُجري "المختبِر الآلي" زحفًا عشوائيًا في تطبيقك ويبلغ عن أي مشاكل يعثر عليها.

إذا كنت تبحث عن اختبار يستند إلى الذكاء الاصطناعي، يمكنك الاطّلاع على برنامج App Testing agent بدلاً من ذلك.

قبل البدء

أضِف Firebase إلى مشروع Android الخاص بك، في حال لم يسبق لك إجراء ذلك.

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

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

توزيع تطبيقك على "المختبِر الآلي" باستخدام وحدة تحكّم Firebase

تم الآن دمج ميزة "المختبِر الآلي" في برنامج App Testing agent. لاستخدامها، شغِّل اختبارًا في وحدة تحكّم Firebase واختَر "زحف عشوائي".

توزيع تطبيقك على "المختبِر الآلي" باستخدام Firebase CLI

شغِّل الأمر appdistribution:distribute لتحميل تطبيقك و توزيعه على المختبِرين. استخدِم المَعلمات التالية لضبط عملية التوزيع على ميزة "المختبِر الآلي":

خيارات الأمر appdistribution:distribute
--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-username-resource

اسم المورد لحقل اسم المستخدم لتسجيل الدخول التلقائي الذي سيتم استخدامه أثناء الاختبارات المبرمَجة.

--test-password-resource

اسم المورد لحقل كلمة المرور لتسجيل الدخول التلقائي الذي سيتم استخدامه أثناء الاختبارات المبرمَجة.

--test-non-blocking

تشغيل الاختبارات المبرمَجة بشكل غير متزامن. يمكنك الاطّلاع على نتائج الاختبارات التلقائية في وحدة تحكّم Firebase.

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

توزيع تطبيقك على "المختبِر الآلي" باستخدام 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

اسم المستخدم لتسجيل الدخول التلقائي الذي سيتم استخدامه أثناء الاختبارات المبرمَجة.

testUsernameResource

اسم المورد لحقل اسم المستخدم لتسجيل الدخول التلقائي الذي سيتم استخدامه أثناء الاختبارات المبرمَجة.

testPassword أو testPasswordFile

كلمة المرور لتسجيل الدخول التلقائي التي سيتم استخدامها أثناء الاختبارات المبرمَجة.

أو يمكنك تحديد مسار ملف نصي عادي يحتوي على كلمة مرور:

testPasswordFile="/path/to/testPassword.txt"
testPasswordResource

اسم المورد لحقل كلمة المرور لتسجيل الدخول التلقائي الذي سيتم استخدامه أثناء الاختبارات المبرمَجة.

testNonBlocking

تشغيل الاختبارات المبرمَجة بشكل غير متزامن. يمكنك الاطّلاع على نتائج الاختبارات التلقائية في وحدة تحكّم Firebase.

لمزيد من المعلومات حول كيفية البدء باستخدام Gradle والطرق المختلفة لضبط عملية التوزيع، يُرجى الاطّلاع على مقالة توزيع تطبيقات Android على المختبِرين باستخدام Gradle.

توزيع تطبيقك على "المختبِر الآلي" باستخدام 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_username_resource

اسم المورد لحقل اسم المستخدم لتسجيل الدخول التلقائي الذي سيتم استخدامه أثناء الاختبارات المبرمَجة.

test_password_resource

اسم المورد لحقل كلمة المرور لتسجيل الدخول التلقائي الذي سيتم استخدامه أثناء الاختبارات المبرمَجة.

test_non_blocking

تشغيل الاختبارات المبرمَجة بشكل غير متزامن. يمكنك الاطّلاع على نتائج الاختبارات التلقائية في وحدة تحكّم Firebase.

لمزيد من المعلومات حول كيفية البدء باستخدام fastlane والطرق المختلفة لضبط عملية التوزيع، يُرجى الاطّلاع على مقالة توزيع تطبيقات Android على المختبِرين باستخدام fastlane.

حالات الزحف للاختبار التلقائي

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

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