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

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

قبل البدء

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

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

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

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

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

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

توزيع تطبيقك على مختبِر مبرمَج باستخدام واجهة سطر الأوامر في Firebase

شغِّل الأمر appdistribution:distribute لتحميل تطبيقك و وتوزيعه على المختبرين. استخدِم المَعلمات التالية من أجل: اضبط التوزيع على ميزة "المختبِر المبرمَج":

appdistribution:خيارات توزيع التطبيقات
--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 والطرق المختلفة لضبط التوزيع، يُرجى الاطّلاع على توزيع تطبيقات Android على المختبِرين باستخدام واجهة سطر الأوامر في 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.

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

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

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