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

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

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

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

قبل البدء

أضِف 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.

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

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

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