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