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