يصف هذا الدليل كيفية توزيع ملفات APK على المختبرين باستخدام Firebase CLI. تتيح لك أداة CLI تحديد المختبرين وملاحظات الإصدار للإصدار، ثم توزيع الإصدار وفقًا لذلك.
قبل ان تبدأ
إذا لم تكن قد قمت بذلك بالفعل، فأضف Firebase إلى مشروع Android الخاص بك .
إذا كنت لا تستخدم أي منتجات Firebase أخرى، فما عليك سوى إنشاء مشروع وتسجيل تطبيقك. ومع ذلك، إذا قررت استخدام منتجات إضافية في المستقبل، فتأكد من إكمال جميع الخطوات الموجودة على الصفحة المرتبطة أعلاه.
الخطوة 1. أنشئ تطبيقك
عندما تكون مستعدًا لتوزيع نسخة تجريبية من تطبيقك على المختبرين، قم بإنشاء ملف APK الخاص بك باستخدام العملية العادية. يجب عليك توقيع APK باستخدام مفتاح التصحيح أو مفتاح توقيع التطبيق.
الخطوة 2. قم بتوزيع تطبيقك على المختبرين
لتوزيع تطبيقك على المختبرين، قم بتحميل ملف تطبيقك باستخدام Firebase CLI:
- قم بالتثبيت أو التحديث إلى أحدث إصدار من Firebase CLI (نوصي بتنزيل الملف الثنائي المستقل لواجهة سطر الأوامر الخاصة بنظام التشغيل لديك). تأكد من تسجيل الدخول واختبار أنه يمكنك الوصول إلى مشاريعك.
- في صفحة توزيع التطبيق بوحدة تحكم Firebase، حدد التطبيق الذي تريد توزيعه، ثم انقر على البدء .
قم بتشغيل الأمر
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
علامة يمكنك تضمينها لطباعة مخرجات السجل المطول.
على سبيل المثال:
firebase appdistribution:distribute test.apk \ --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 بجوار أداة الاختبار في الإصدار. يمكن تجديد الدعوة عن طريق إعادة إرسالها باستخدام القائمة المنسدلة في صف الاختبار.
الخطوات التالية
قم بتنفيذ التعليقات داخل التطبيق لتسهل على المختبرين إرسال تعليقات حول تطبيقك (بما في ذلك لقطات الشاشة).
تعرف على كيفية عرض التنبيهات داخل التطبيق للمختبرين عندما تكون الإصدارات الجديدة من تطبيقك متاحة للتثبيت.
تعرف على أفضل الممارسات لتوزيع تطبيقات Android على مختبري ضمان الجودة باستخدام CI/CD .