توزيع تطبيقات Android على المختبِرين باستخدام واجهة سطر الأوامر في Firebase

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

تتكامل ميزة "توزيع التطبيقات" مع خدمة مشاركة التطبيقات الداخلية من Google Play لتنفيذ ما يلي: معالجة ملفات AAB التي تحمِّلها وعرض حِزم APK المحسَّنة للمختبِرين إعدادات الأجهزة. يتيح لك توزيع AAB إجراء ما يلي:

  • يمكنك تشغيل حِزم APK محسّنة (معروضة من خلال Google Play) تم تحسينها لتناسب احتياجاتك. للمختبِرين الأجهزة.

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

  • اختبار ميزات حِزم التطبيقات مثل عرض الميزات في Play وعرض المواد في Play

  • يُرجى تقليل حجم المحتوى الذي يتم تنزيله للمختبِرين.

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

لتحميل ملفات AAB إلى ميزة "توزيع التطبيقات"، عليك ربط تطبيقك على Firebase بأحد التطبيقات. في Google Play يجب أن يكون لديك مستوى الوصول المطلوب لتنفيذ هذه الإجراءات.

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

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

الإجراء في وحدة تحكُّم Firebase الإذن المطلوب لإدارة الهوية وإمكانية الوصول أدوار "إدارة الهوية وإمكانية الوصول" التي تتضمّن الأذونات المطلوبة من قِبل تلقائي الأدوار الإضافية المطلوبة
ربط تطبيق على Firebase بتطبيق في Google Play firebase.playLinks.update أحد الأدوار التالية: الوصول إلى حساب مطوِّر على Google Play باستخدام المشرف
تحميل ملفات AAB إلى ميزة App Distribution firebaseappdistro.releases.update أحد الأدوار التالية: ––

قبل البدء

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

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

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

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

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

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

  3. اربط تطبيق Android على Firebase بحساب المطوِّر على Google Play:

    1. في "وحدة تحكُّم Firebase"، انتقِل إلى إعدادات المشروع، ثم اختَر علامة التبويب عمليات الدمج.

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

    3. اتّبِع التعليمات الظاهرة على الشاشة لتفعيل ميزة "توزيع التطبيقات" التكامل واختيار تطبيقات Firebase Android المطلوب ربطها بـ Google اللعب.

    مزيد من المعلومات حول ربط الحساب بمتجر Google Play.

الخطوة 1: إنشاء تطبيقك

عندما تكون مستعدًا لتوزيع إصدار تجريبي من تطبيقك على المختبِرين: إنشاء AAB (انتقل إلى مستندات "استوديو Android" للحصول على التعليمات).

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

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

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

  3. شغِّل الأمر appdistribution:distribute لتحميل تطبيقك و وتوزيعه على المختبرين. استخدام المعلمات التالية لضبط التوزيع:

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

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

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

    رمز مميّز لإعادة التحميل تتم طباعته عند مصادقة CI بيئة مستقلة باستخدام واجهة سطر الأوامر في Firebase (قراءة استخدام واجهة سطر الأوامر مع 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 بجانب المختبِر في أحد الإصدارات. يمكن أن تكون الدعوة تجديده من خلال إعادة إرساله باستخدام القائمة المنسدلة في صف المختبر.

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