اختبار تطبيقات Android تلقائيًا

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

قبل البدء

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

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

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

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

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

  1. افتح App Distribution الصفحة في وحدة تحكُّم Firebase. اختَر مشروعك على Firebase عندما يُطلب منك ذلك.
  2. في صفحة الإصدارات، اختَر التطبيق الذي تريد توزيعه من القائمة المنسدلة.
  3. اسحب ملف APK الخاص بتطبيقك إلى وحدة التحكّم لتحميله.
  4. عند اكتمال عملية التحميل، اختَر المختبِر الآلي في شريط البحث إضافة مختبِرين أو مجموعات.
  5. لتخصيص الاختبار المبرمَج، انقر على رمز تعديل واختَر التخصيصات في مربّع الحوار تخصيص الاختبار المبرمَج.
  6. (اختياري) في مربّع حوار إعدادات الجهاز، اختَر مستوى واجهة برمجة التطبيقات، ووضع الجهاز، واللغة التي تستوفي مواصفات الاختبار.
  7. (اختياري) انقر على القائمة المنسدلة بيانات اعتماد تسجيل الدخول لإنشاء اسم مستخدم وكلمة مرور مخصّصَين يمكن استخدامهما أثناء الاختبار إذا كان تطبيقك يتطلّب بيانات اعتماد تسجيل الدخول.
  8. انقر على توزيع. يمكنك أيضًا إضافة ملاحظة اختيارية حول الإصدار لتطبيقك.

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

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

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

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