يوضِّح هذا الدليل كيفية توزيع حِزم APK على المختبِرين. باستخدام واجهة سطر الأوامر Firebase. تتيح لك أداة CLI تحديد المختبرين ملاحظات الإصدار الخاصة بأحد الإصدارات، ثم توزيع الإصدار وفقًا لذلك.
قبل البدء
أضِف Firebase إلى جهاز Android إذا لم يسبق لك إجراء ذلك. مشروعك.
إذا كنت لا تستخدم أي منتجات أخرى من منتجات Firebase، ما عليك سوى إنشاء للمشروع وتسجيل تطبيقك. ومع ذلك، إذا قررت استخدام ميزات منتجاتك في المستقبل، احرص على إكمال جميع الخطوات الواردة في الصفحة المرتبطة أعلاه.
الخطوة 1: إنشاء تطبيقك
عندما تكون مستعدًا لتوزيع إصدار تجريبي من تطبيقك على المختبِرين: وإنشاء APK باستخدام عمليتك المعتادة. يجب توقيع حزمة APK باستخدام تصحيح الأخطاء. أو مفتاح توقيع التطبيق.
الخطوة 2: توزيع تطبيقك على المختبِرين
لتوزيع تطبيقك على المختبِرين، حمِّل ملف تطبيقك باستخدام واجهة سطر الأوامر Firebase:
- تثبيت Firebase CLI أو تحديثه إلى آخر إصدار (ننصحك بتنزيل البرنامج الثنائي المستقل الذي يخص واجهة سطر الأوامر الخاصة بنظام التشغيل لديك). احرص على تسجيل الدخول واختبار إمكانية الوصول إلى مماثلة.
- في صفحة App Distribution من وحدة تحكُّم Firebase، اختَر التطبيق الذي تريد توزيعه، ثم انقر على البدء.
-
شغِّل الأمر
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.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
بعد توزيع الإصدار، سيصبح متوفّرًا في App Distribution هي لوحة بيانات وحدة تحكّم Firebase لمدة 150 يومًا (خمسة أشهر). عندما تنتهي صلاحية الإصدار بعد 30 يومًا من انتهاء صلاحيته، يظهر إشعار انتهاء الصلاحية في وحدة التحكم وقائمة الإصدارات الخاصة بالمختبِرين على جهاز الاختبار الخاص بهم.
يتلقّى المختبِرون الذين لم تتم دعوتهم لاختبار التطبيق دعوات بالبريد الإلكتروني إلى وسيتلقّى المختبِرون الحاليون إشعارات عبر البريد الإلكتروني تفيد بأنّ إصدارًا جديدًا على استعداد للاختبار (يُرجى قراءة دليل إعداد المختبِر للحصول على تعليمات حول طريقة تثبيت الاختبار التطبيق). يمكنك مراقبة حالة كل مختبِر، وما إذا كان قد قبل وما إذا كانوا نزّلوا التطبيق في وحدة تحكّم Firebase أم لا.
ويكون لدى المختبِرين 30 يومًا لقبول الدعوة لاختبار التطبيق قبل انتهاء صلاحيته. عندما تنتهي صلاحية الدعوة بعد 5 أيام من انتهاء صلاحيتها، يظهر إشعار انتهاء الصلاحية في وحدة تحكُّم Firebase بجانب المختبِر في أحد الإصدارات يمكن أن تكون الدعوة تجديده من خلال إعادة إرساله باستخدام القائمة المنسدلة في صف المختبر.
الخطوات التالية
تنفيذ الملاحظات داخل التطبيق لتسهّل على المختبِرين إرسال ملاحظات حول تطبيقك (بما في ذلك لقطات الشاشة).
تعرَّف على كيفية عرض تنبيهات داخل التطبيق. إلى المختبِرين عند توفُّر إصدارات جديدة من تطبيقك للتثبيت.
تعرَّف على أفضل الممارسات لتوزيع تطبيقات Android إلى مختبِري ضمان الجودة باستخدام CI/CD.