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

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

قبل ان تبدأ

إذا لم تكن قد قمت بذلك بالفعل، فأضف Firebase إلى مشروع Android الخاص بك .

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

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

قم بتوزيع تطبيقك على برنامج Automated Tester باستخدام وحدة تحكم Firebase

لتوزيع تطبيقك على Automated Tester، قم بتحميل ملف APK الخاص بك باستخدام وحدة تحكم Firebase:

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

قم بتوزيع تطبيقك على برنامج Automated Tester باستخدام Firebase CLI

قم بتشغيل الأمر appdistribution:distribute لتحميل تطبيقك وتوزيعه على المختبرين. استخدم المعلمات التالية لتكوين التوزيع الخاص بك لميزة الاختبار الآلي:

توزيع التطبيق: خيارات التوزيع
--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

يمكنك تكوين توزيع التطبيق عن طريق إضافة قسم firebaseAppDistribution واحد على الأقل واستخدام المعلمات التالية لتكوين التوزيع لميزة الاختبار الآلي:

معلمات بناء توزيع التطبيق
testDevices أو testDevicesFile

أجهزة الاختبار التي تريد توزيع الإصدارات عليها باستخدام الاختبارات الآلية .

يمكنك تحديد أجهزة الاختبار كقائمة مفصولة بفاصلة منقوطة لمواصفات الجهاز

testDevices="model=shiba, version=34, locale=en, orientation=portrait;model=b0p, 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/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 .

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

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

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