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

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

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

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

قبل البدء

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

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

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

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

تم دمج ميزة "المختبِر الآلي" الآن في وكيل اختبار التطبيق. لاستخدامها، شغِّل اختبارًا في وحدة تحكّم 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.

حالات الزحف للاختبارات الآلية

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

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