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

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

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

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

قبل البدء

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

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

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

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

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

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

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

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

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