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