ميزة "أداة الاختبار الآلية" هي إصدار معاينة. لا يخضع إصدار المعاينة لأي اتفاقية مستوى خدمة أو سياسة إيقاف نهائي، وقد يتلقّى دعمًا محدودًا أو لا يتلقّى أي دعم. أثناء المعاينة، تنطبق Test Lab. نحن ملتزمون بتوفير أسعار شفافة لميزة Automated Tester وسنشارك جميع التفاصيل قبل أن تصبح متاحة للجميع.
يوضّح هذا الدليل كيفية اختبار تطبيقك تلقائيًا باستخدام ميزة App Distribution"أداة الاختبار الآلية" في Firebase. تنفّذ "أداة الاختبار الآلية" زحفًا عشوائيًا في تطبيقك وتُبلغ عن أي مشاكل تعثر عليها.
إذا كنت تبحث عن اختبار مستند إلى الذكاء الاصطناعي، اطّلِع على وكيل اختبار التطبيق بدلاً من ذلك.
قبل البدء
أضِف Firebase إلى مشروع Android الخاص بك، في حال لم يسبق لك إجراء ذلك.
إذا كنت لا تستخدم أي منتجات أخرى من Firebase، عليك فقط إنشاء مشروع وتسجيل تطبيقك. ومع ذلك، إذا قرّرت استخدام منتجات إضافية في المستقبل، احرص على إكمال جميع الخطوات الواردة في إضافة Firebase باستخدام وحدة تحكّم Firebase.
عندما تكون مستعدًا لتوزيع إصدار تجريبي من تطبيقك على المختبِرين، أنشئ حِزمة APK باستخدام طريقتك العادية. يجب توقيع حزمة APK باستخدام مفتاح تصحيح الأخطاء أو مفتاح توقيع التطبيق.
توزيع تطبيقك على أداة Automated Tester باستخدام "وحدة تحكّم Firebase"
تم الآن دمج ميزة "المختبِر الآلي" في وكيل اختبار التطبيق. لاستخدام هذه الميزة، عليك إجراء اختبار في وحدة تحكّم Firebase واختيار "الزحف العشوائي".
توزيع تطبيقك على "المختبِر الآلي" باستخدام واجهة سطر الأوامر (CLI) في Firebase
نفِّذ الأمر 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" للاطّلاع على نتائج الاختبار التلقائي. |
لمزيد من المعلومات عن كيفية بدء استخدام واجهة سطر الأوامر (CLI) في Firebase والطرق المختلفة لإعداد عملية التوزيع، اطّلِع على مقالة توزيع تطبيقات Android على المختبِرين باستخدام واجهة سطر الأوامر (CLI) في Firebase.
توزيع تطبيقك على "أداة الاختبار الآلية" باستخدام 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.
حالات الزحف التجريبي التلقائي
لمساعدتك في تفسير نتائج الاختبار، تعرض علامة التبويب نتائج الاختبار الآلي أي مشاكل في الاختبار، ولقطات شاشة للتطبيق، وفيديو لعملية الزحف أثناء الاختبار لكل جهاز. يمكنك الاطّلاع على حالة الاختبار في صفحة نتائج الاختبار:
| حالة الزحف | الوصف |
|---|---|
| في انتظار المراجعة | لا يزال الاختبار التلقائي قيد التنفيذ، وستتوفّر النتائج قريبًا. |
| تم بنجاح | زحف الاختبار التلقائي إلى تطبيقك بنجاح ولم يعثر على أي أعطال. |
| فشل | تعذّر إجراء الاختبار التلقائي لأنّ تطبيقك تعطّل أثناء الاختبار. |
| غير حاسمة | تعذّر إجراء الاختبار التلقائي بسبب حدوث أخطاء في البنية الأساسية. |