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