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

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

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

  • قم بتشغيل ملفات APK المحسنة (التي يقدمها Google Play) والتي تم تحسينها لأجهزة المختبرين لديك.

  • كشف وتصحيح المشكلات الخاصة بالجهاز.

  • اختبار ميزات حزمة التطبيقات مثل Play Features Delivery و Play Asset Delivery .

  • تقليل حجم التنزيلات للمختبرين لديك.

الأذونات المطلوبة

لتحميل AABs إلى App Distribution، يجب عليك ربط تطبيق Firebase الخاص بك بتطبيق في Google Play . يجب أن يكون لديك مستوى الوصول المطلوب لتنفيذ هذه الإجراءات.

إذا لم يكن لديك حق الوصول اللازم إلى Firebase، فيمكنك أن تطلب من مالك مشروع Firebase أن يعين لك الدور المناسب عبر إعدادات IAM لوحدة تحكم Firebase . إذا كانت لديك أسئلة حول الوصول إلى مشروع Firebase، بما في ذلك البحث عن مالك أو تعيينه، فراجع الأسئلة الشائعة حول "الأذونات والوصول إلى مشاريع Firebase" .

ينطبق الجدول التالي على ربط تطبيق Firebase بتطبيق في Google Play، بالإضافة إلى تحميل AABs.

الإجراء في وحدة تحكم Firebase مطلوب إذن IAM دور (أدوار) IAM التي تتضمن الأذونات المطلوبة بشكل افتراضي الأدوار الإضافية المطلوبة
ربط تطبيق Firebase بتطبيق في Google Play firebase.playLinks.update أحد الأدوار التالية: الوصول إلى حساب مطور Google Play كمسؤول
تحميل AABs لتوزيع التطبيق firebaseappdistro.releases.update أحد الأدوار التالية: ——

قبل ان تبدأ

  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، انتقل إلى ملف إعدادات المشروع ، ثم حدد علامة التبويب عمليات التكامل .

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

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

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

الخطوة 1. أنشئ تطبيقك

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

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

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

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

    توزيع التطبيق: خيارات التوزيع
    --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

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

    --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 appdistribution:distribute test.aab  \
        --app 1:1234567890:android:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file testers.txt
    

    تقوم واجهة سطر أوامر Firebase بإخراج الروابط التالية بعد تحميل الإصدار. تساعدك هذه الروابط في إدارة الثنائيات والتأكد من حصول المختبرين والمطورين الآخرين على الإصدار الصحيح:

    • firebase_console_uri - رابط لوحدة تحكم Firebase يعرض إصدارًا واحدًا. يمكنك مشاركة هذا الرابط مع المطورين الآخرين في مؤسستك.
    • testing_uri - رابط للإصدار في تجربة المختبر (تطبيق Android الأصلي) يتيح للمختبرين عرض ملاحظات الإصدار وتثبيت التطبيق على أجهزتهم. يحتاج المُختبر إلى الوصول إلى الإصدار حتى يتمكن من استخدام الرابط.
    • binary_download_uri - رابط موقّع يقوم بتنزيل التطبيق الثنائي وتثبيته مباشرةً (ملف APK أو AAB). تنتهي صلاحية الرابط بعد ساعة واحدة.

    إدارة المختبرين والمجموعات

    بالإضافة إلى توزيع الإصدارات، يمكنك أيضًا استخدام appdistribution:testers:add و 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 .

    إذا كان لديك عدد كبير من المختبرين، فيجب عليك التفكير في استخدام المجموعات: يمكنك استخدام appdistribution:group:create و appdistribution:group:delete لإنشاء مجموعات أو حذفها في مشروع Firebase الخاص بك.

    استخدم --group-alias لتحديد مجموعة لأوامر appdistribution:testers:add و appdistribution:testers:remove .

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

    firebase appdistribution:group:create "QA team" qa-team
    
    firebase appdistribution:testers:add --group-alias=qa-team anothertester@email.com moretesters@email.com
    
    firebase appdistribution:testers:remove --group-alias=qa-team anothertester@email.com moretesters@email.com
    
    firebase appdistribution:group:delete qa-team
    

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

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

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

الخطوات التالية