يوضِّح هذا الدليل كيفية توزيع مجموعات حزمات تطبيق Android (AAB) على المختبِرين. باستخدام واجهة سطر الأوامر Firebase. تتيح لك أداة CLI تحديد المختبِرين واطلاعهم على ملاحظات الإصدار الخاصة بالإصدار، ثم توزيع الإصدار وفقًا لذلك.
يتكامل تطبيق App Distribution مع خدمة مشاركة التطبيقات الداخلية من Google Play لتنفيذ ما يلي: معالجة ملفات AAB التي تحمِّلها وعرض حِزم APK المحسَّنة للمختبِرين إعدادات الأجهزة. يتيح لك توزيع AAB إجراء ما يلي:
يمكنك تشغيل حِزم APK المحسّنة (التي يعرضها Google Play) والمُحسَّنة لتعمل على أجهزة المختبِرين.
رصد المشاكل المتعلّقة بالأجهزة وتصحيحها
اختبِر ميزات حِزم التطبيقات، مثل عرض الميزات في Play وعرض مواد العرض في Play.
يُرجى تقليل حجم المحتوى الذي يتم تنزيله للمختبِرين.
الأذونات المطلوبة
لتحميل ملفات AAB إلى App Distribution، عليك ربط تطبيق 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
|
أحد الأدوار التالية: | –– |
قبل البدء
أضِف Firebase إلى جهاز Android إذا لم يسبق لك إجراء ذلك. مشروعك. في نهاية سير العمل هذا، سيكون لديك تطبيق Android على Firebase في مشروعك على Firebase.
إذا لم تكن تستخدِم أي منتجات أخرى من Firebase، ما عليك سوى إنشاء مشروع وتسجيل تطبيقك. وإذا قرّرت استخدام منتجات إضافية، احرص على إكمال جميع الخطوات الواردة في مقالة إضافة Firebase إلى مشروع Android.
لإنشاء رابط Firebase إلى Google Play وتحميل ملفات AAB، تأكد من يستوفي تطبيقك المتطلبات التالية:
أن يكون التطبيق على Google Play وتطبيق Firebase لنظام التشغيل Android مسجَّلاً باستخدام اسم الحزمة نفسه
تم إعداد التطبيق في لوحة بيانات التطبيق على Google Play وتوزيعه على أحد مسارات الإصدار على Google Play (اختبار داخلي أو اختبار مغلق أو اختبار مفتوح أو إصدار علني).
اكتملت مراجعة التطبيق في Google Play وتم نشره. يتم نشر تطبيقك إذا كان عمود حالة التطبيق يعرض إحدى الحالات التالية: اختبار داخلي (وليس اختبارًا داخليًا لمسوّدة) أو اختبار مغلق أو اختبار مفتوح أو إصدار.
ربط تطبيق Android على Firebase بحساب المطوِّر الخاص بك على Google Play:
في وحدة تحكّم Firebase، انتقِل إلى
، ثم اختَر علامة التبويب عمليات الدمج. إعدادات المشروع في بطاقة Google Play، انقر على ربط.
إذا كان لديك روابط تؤدي إلى Google Play، انقر على إدارة. بدلاً من ذلك.اتّبِع التعليمات الظاهرة على الشاشة لتفعيل App Distribution. التكامل واختيار تطبيقات Firebase Android المطلوب ربطها بـ Google اللعب.
مزيد من المعلومات حول ربط الحساب بمتجر Google Play.
الخطوة 1: إنشاء تطبيقك
عندما تكون مستعدًا لتوزيع إصدار تجريبي من تطبيقك على المختبِرين، أنشئ حِزمة تطبيق مُعدّة للنشر (AAB) (يمكنك الانتقال إلى مستندات "استوديو Android" للاطّلاع على التعليمات).
الخطوة 2: توزيع تطبيقك على المختبِرين
لتوزيع تطبيقك على المختبِرين، حمِّل ملف تطبيقك باستخدام واجهة برمجة التطبيقات Firebase:
- تثبيت Firebase CLI أو تحديثه إلى آخر إصدار (ننصحك بتنزيل البرنامج الثنائي المستقل الذي يخص واجهة سطر الأوامر الخاصة بنظام التشغيل لديك). احرص على تسجيل الدخول واختبار إمكانية الوصول إلى projects.
- في صفحة App Distribution في وحدة تحكّم Firebase، اختَر التطبيق الذي تريد توزيعه، ثم انقر على البدء.
-
يمكنك تنفيذ الأمر
appdistribution:distribute
لتحميل تطبيقك و توزيعه على المختبِرين. استخدِم المَعلمات التالية لضبط توزيع المحتوى:appdistribution:خيارات توزيع التطبيقات --app
مطلوب: رقم تعريف تطبيق Firebase لتطبيقك. يمكنك العثور على التطبيق رقم التعريف في وحدة تحكُّم Firebase، على عام صفحة الإعدادات
--app 1:1234567890:android:0a1b2c3d4e5f67890
--token
رمز إعادة التنشيط الذي يتم طباعته عند مصادقة بيئة التكامل المستمر باستخدام واجهة سطر أوامر Firebase (اطّلِع على استخدام واجهة سطر الأوامر مع أنظمة التكامل المستمر للحصول على مزيد من المعلومات).
--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 CLI الروابط التالية بعد تحميل الإصدار. تساعدك هذه الروابط في إدارة الملفات الثنائية وضمان حصول المختبِرين وغيرهم من المطوّرين على الإصدار المناسب:
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
بعد توزيع الإصدار، سيصبح متوفّرًا في App Distribution هي لوحة بيانات وحدة تحكّم Firebase لمدة 150 يومًا (خمسة أشهر). عندما تنتهي صلاحية الإصدار بعد 30 يومًا من انتهاء صلاحيته، يظهر إشعار انتهاء الصلاحية في وحدة التحكم وقائمة الإصدارات الخاصة بالمختبِرين على جهاز الاختبار الخاص بهم.
يتلقّى المختبِرون الذين لم تتم دعوتهم لاختبار التطبيق دعوات عبر البريد الإلكتروني لبدء الاختبار، ويتلقّى المختبِرون الحاليون إشعارات عبر البريد الإلكتروني تفيد بأنّ الإصدار الجديد جاهز للاختبار (اطّلِع على دليل إعداد المختبِر للحصول على تعليمات حول كيفية تثبيت الإصدار الاختباري من التطبيق). يمكنك مراقبة حالة كل مختبِر، وما إذا كان قد قبل وما إذا كانوا نزّلوا التطبيق في وحدة تحكّم Firebase أم لا.
أمام المختبِرين 30 يومًا لقبول دعوة اختبار التطبيق قبل أن تنتهي صلاحيتها. عندما تبقى 5 أيام على انتهاء صلاحية الدعوة، يظهر إشعار بانتهاء الصلاحية في وحدة تحكّم Firebase بجانب المختبِر في الإصدار. يمكن تجديد الدعوة من خلال إعادة إرسالها باستخدام القائمة المنسدلة في صف المختبِر.
الخطوات التالية
تنفيذ الملاحظات داخل التطبيق لتسهّل على المختبِرين إرسال ملاحظات حول تطبيقك (بما في ذلك لقطات الشاشة).
تعرَّف على كيفية عرض تنبيهات داخل التطبيق. إلى المختبِرين عند توفُّر إصدارات جديدة من تطبيقك للتثبيت.
تعرَّف على أفضل الممارسات لتوزيع تطبيقات Android على مختبِري ضمان الجودة باستخدام ميزة "التكامل والنشر".