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