وزع تطبيقات Android على المختبرين باستخدام Firebase CLI

يصف هذا الدليل كيفية توزيع حِزم تطبيقات Android (AABs) على المختبرين باستخدام Firebase CLI. تتيح لك أداة CLI تحديد المختبرين وملاحظات الإصدار للإصدار ، ثم توزيع الإصدار وفقًا لذلك.

لاتباع هذا الدليل ، تحتاج إلى المتطلبات الأساسية التالية: الوصول إلى مشروع Firebase ( المالك أو مسؤول Firebase ) ، والوصول إلى حساب مطور Google Play ( المالك أو المسؤول ) ، وتطبيق في حالة منشور في Google Play.

حول توزيع حِزم تطبيقات Android

يتكامل توزيع التطبيقات مع خدمة مشاركة التطبيقات الداخلية في Google Play لمعالجة AABs التي تقوم بتحميلها وتقديم ملفات APK المحسّنة لتكوينات جهاز المختبرين. عندما تقوم بتوزيع AABs ، يمكنك:

  • قم بتشغيل ملفات APK المحسّنة (التي يقدمها Google Play) والتي تم تحسينها لأجهزة المختبرين.
  • الكشف عن المشكلات الخاصة بالجهاز وتصحيحها.
  • اختبار ميزات حزمة التطبيقات مثل Play Feature Delivery و Play Asset Delivery
  • تقليل حجم التنزيلات للمختبرين.

قبل ان تبدأ

  1. أضف Firebase إلى مشروع Android ، إذا لم تكن قد قمت بذلك بالفعل. في نهاية سير العمل هذا ، سيكون لديك تطبيق Firebase Android في مشروع Firebase.

    إذا كنت لا تستخدم أي منتجات Firebase أخرى ، فأنت تحتاج فقط إلى إنشاء مشروع وتسجيل تطبيقك. إذا قررت استخدام منتجات إضافية ، فتأكد من إكمال جميع الخطوات في إضافة Firebase إلى مشروع Android الخاص بك .

  2. لإنشاء رابط Firebase إلى Google Play وتحميل AABs ، تأكد من أن تطبيقك يلبي المتطلبات التالية:

    • تم تسجيل التطبيق في Google Play وتطبيق Firebase Android باستخدام نفس اسم الحزمة.

    • يتم إعداد التطبيق في Google Play على لوحة معلومات التطبيق ويتم توزيعه على أحد مسارات Google Play (الاختبار الداخلي أو الاختبار المغلق أو الاختبار المفتوح أو الإنتاج).

    • اكتملت مراجعة التطبيق في Google Play وتم نشر التطبيق. يتم نشر تطبيقك إذا كان عمود حالة التطبيق يعرض إحدى الحالات التالية: الاختبار الداخلي (ليس مسودة اختبار داخلي) ، أو اختبار مغلق ، أو اختبار مفتوح ، أو إنتاج.

  3. اربط تطبيق Firebase Android بحساب مطوّر برامج Google Play:

    1. في وحدة تحكم Firebase ، انتقل إلى Project settings ، ثم حدد علامة التبويب Integrations .

    2. في بطاقة Google Play ، انقر فوق ارتباط .
      إذا كان لديك بالفعل روابط إلى Google Play ، فانقر فوق إدارة بدلاً من ذلك.

    3. اتبع التعليمات التي تظهر على الشاشة لتمكين تكامل توزيع التطبيقات وحدد تطبيقات Firebase Android لربطها بـ Google Play.

    تعرف على المزيد حول الربط بـ Google Play .

الخطوة الأولى: بناء التطبيق الخاص بك

عندما تكون جاهزًا لتوزيع إصدار ما قبل الإصدار من تطبيقك على المختبرين ، قم بإنشاء AAB الخاص بك (قم بزيارة وثائق Android Studio للحصول على الإرشادات).

الخطوة الثانية. وزع تطبيقك على المختبرين

لتوزيع تطبيقك على المختبرين ، حمِّل ملف تطبيقك باستخدام Firebase CLI:

  1. قم بتثبيت أو تحديث أحدث إصدار من Firebase CLI (نوصي بتنزيل الملف الثنائي المستقل لـ CLI الخاص بنظام التشغيل الخاص بك). تأكد من تسجيل الدخول واختبر أنه يمكنك الوصول إلى مشاريعك.
  2. في صفحة توزيع التطبيق بوحدة تحكم Firebase ، حدد التطبيق الذي تريد توزيعه ، ثم انقر على البدء .
  3. قم بتشغيل appdistribution:distribute الأمر لتحميل تطبيقك وتوزيعه على المختبرين. استخدم المعلمات التالية لتكوين التوزيع:

    appdistribution: توزيع الخيارات
    --app

    مطلوب : معرّف تطبيق Firebase لتطبيقك. يمكنك العثور على معرف التطبيق في وحدة تحكم Firebase ، في صفحة الإعدادات العامة .

    --app 1:1234567890:android:0a1b2c3d4e5f67890
    --token

    رمز تحديث يُطبع عند مصادقة بيئة CI الخاصة بك باستخدام Firebase CLI (اقرأ استخدام CLI مع أنظمة CI لمزيد من المعلومات).

    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    ملاحظات الإصدار لهذا البناء.

    يمكنك إما تحديد ملاحظات الإصدار مباشرة:

    --release-notes "Text of release notes"

    أو حدد المسار لملف نص عادي:

    --release-notes-file "/path/to/release-notes.txt"
    --testers
    --testers-file

    عناوين البريد الإلكتروني للمختبرين الذين تريد دعوتهم.

    يمكنك تحديد المختبرين كقائمة عناوين بريد إلكتروني مفصولة بفواصل:

    --testers "ali@example.com, bri@example.com, cal@example.com"

    أو يمكنك تحديد المسار إلى ملف نص عادي يحتوي على قائمة مفصولة بفواصل من عناوين البريد الإلكتروني:

    --testers-file "/path/to/testers.txt"
    --groups
    --groups-file

    مجموعات المختبرين التي تريد دعوتها (راجع إدارة المختبرين ). يتم تحديد المجموعات باستخدام مجموعة الأسماء المستعارة ، والتي يمكنك البحث عنها في وحدة تحكم Firebase.

    يمكنك تحديد المجموعات كقائمة مفصولة بفواصل:

    --groups "qa-team, trusted-testers"

    أو يمكنك تحديد المسار إلى ملف نص عادي يحتوي على قائمة مفصولة بفواصل لأسماء المجموعات:

    --groups-file "/path/to/groups.txt"
    --debug

    علامة يمكنك تضمينها لطباعة إخراج السجل المطول.

    علي سبيل المثال:

    firebase appdistribution:distribute test.aab  \
        --app 1:1234567890:android:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file testers.txt
    

    بالإضافة إلى توزيع الإصدارات ، يمكنك أيضًا استخدام appdistribution:testers:add and appdistribution:testers:remove لدعوة المختبرين الجدد أو إزالة المختبرين الحاليين من مشروع Firebase. بمجرد إضافة أحد المختبرين إلى مشروع Firebase ، يمكنك إضافته إلى الإصدارات الفردية. بمجرد إزالة أحد المختبرين ، لن يعود بإمكانه الوصول إلى الإصدارات في مشروعك. لاحظ أنه لا يزال بإمكان المختبرين الذين تمت إزالتهم مؤخرًا الاحتفاظ بإمكانية الوصول إلى إصداراتك لفترة زمنية.

    علي سبيل المثال:

    firebase appdistribution:testers:add anothertester@email.com moretesters@email.com
    
    firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com
    

    يجب فصل رسائل البريد الإلكتروني الخاصة بالاختبار بمسافة. يمكنك أيضًا تحديد المختبرين باستخدام --file /path/to/testers.txt .

بمجرد توزيع التصميم الخاص بك ، يصبح متاحًا في لوحة معلومات توزيع التطبيقات لوحدة تحكم Firebase لمدة 150 يومًا (خمسة أشهر). عند مرور 30 ​​يومًا على انتهاء صلاحية الإصدار ، يظهر إشعار انتهاء الصلاحية في كل من وحدة التحكم وقائمة البنيات الخاصة بالمختبرين على جهاز الاختبار الخاص بهم.

يتلقى المختبِرون الذين لم تتم دعوتهم لاختبار التطبيق دعوات بالبريد الإلكتروني للبدء ، ويتلقى المختبِرون الحاليون إشعارات بالبريد الإلكتروني تفيد بأن البناء الجديد جاهز للاختبار (اقرأ دليل إعداد المُختبِر للحصول على إرشادات حول كيفية تثبيت التطبيق التجريبي). يمكنك مراقبة حالة كل مختبِر - سواء قبلوا الدعوة وما إذا كانوا قد قاموا بتنزيل التطبيق - في وحدة تحكم Firebase.

لدى المختبرين 30 يومًا لقبول دعوة لاختبار التطبيق قبل انتهاء صلاحيته. عندما تنتهي صلاحية الدعوة بعد 5 أيام من انتهاء صلاحيتها ، يظهر إشعار انتهاء الصلاحية في وحدة تحكم Firebase بجوار المُختبِر في الإصدار. يمكن تجديد الدعوة عن طريق إعادة إرسالها باستخدام القائمة المنسدلة في صف المختبر.