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