این سند روال‌های مطلوب استفاده از Firebase App Distribution را برای پایدار و تکرارپذیر کردن گردش‌های کار آزمایش پیش‌انتشار Android در محیط CI/CD معرفی می‌کند. راه‌حل‌ها شامل Gradle و fastlane می‌شود، اما برای اینکه انعطاف‌پذیری بیشتری به شما بدهیم، راه‌حل‌های دردسترس ازطریق Firebase کنسول، Firebase CLI، و Firebase App Distribution API عمومی را نیز اضافه کرده‌ایم. همچنین محدودیت‌های انتشار و آزمایش‌کننده را توضیح می‌دهیم تا بتوانید ازقبل برای تجربه بهینه برنامه‌ریزی کنید.
اگر از پلاتفرم‌های Apple نیز استفاده می‌کنید، روال‌های مطلوب برای توزیع برنامه‌های Apple به آزمایش‌کنندگان تضمین کیفیت بااستفاده از CI/CD و fastlane را ببینید.
قبل از شروع
قبل‌از اینکه روال‌های مطلوب را در این سند پیاده‌سازی کنید، حتماً App Distribution را در کنسول Firebase برای هر برنامه فعال کنید. اگر App Distribution را فعال نکرده باشید، خطای ۴۰۴ دریافت خواهید کرد.
برای فعال کردن App Distribution، این مراحل را دنبال کنید:
- صفحه App Distribution را در کنسول Firebase باز کنید.
- برنامه Android خود را انتخاب کنید.
- روی شروع به کار کلیک کنید.
ازآنجایی‌که قالب Android App Bundle (AAB) درحال تبدیل شدن به رایج‌ترین قالب بسته Android است، توصیه می‌کنیم با پیوند دادن به Google Play�
خودکارسازی گردش کار آزمایش پیش‌انتشار بااستفاده از خط لوله CI/CD
اگر می‌خواهید ساخت و انتشار برنامه‌ها برای آزمایش‌کنندگان را خودکارسازی کنید و از CI/CD استفاده می‌کنید، توصیه می‌کنیم از fastlane یا Gradle استفاده کنید. گزینه دیگر استفاده از Firebase CLI است که به شما امکان می‌دهد به طیف گسترده‌ای از محصولات Firebase دسترسی داشته باشید.
استفاده از fastlane
بااستفاده از fastlane، ابزار متن‌باز که ساخت و انتشار برنامه‌های iOS و Android را خودکارسازی می‌کند، App Distribution را در خط لوله CI/CD خود ادغام کنید. با ساختن و توزیع خودکار جدیدترین نسخه‌های پخش خود برای آزمایشگران، مطمئن می‌شوید که آزمایشگران همیشه به‌روزترین نسخه آزمایشی برنامه شما را دراختیار دارند.
برای آشنایی با نحوه ادغام App Distribution با fastlane، به توزیع برنامه‌های Android برای آزمایشگران بااستفاده از fastlane مراجعه کنید.
استفاده از Gradle
از Gradle برای ادغام App Distribution در فرایند ساخت Android خود
بااستفاده از
افزایه Gradle App Distribution استفاده کنید. افزایه به شما امکان می‌دهد آزمایشگران و
یادداشت‌های انتشار را در فایل build.gradle برنامه‌تان مشخص کنید، که به شما امکان می‌دهد
توزیع‌ها را برای انواع ساخت و گونه‌های مختلف برنامه‌تان پیکربندی کنید.
برای آشنایی با نحوه ادغام App Distribution با Gradle، به توزیع برنامه‌های Android برای آزمایشگران بااستفاده از Gradle مراجعه کنید.
استفاده از Firebase CLI
از ابزارهای Firebase CLI که App Distribution ارائه می‌دهد برای توزیع ساخت‌ها به آزمونگران به‌صورت برنامه‌نویسی استفاده کنید. می‌توانید آزمونگران و یادداشت‌های انتشار را برای ساختمانی مشخص کنید.
جدیدترین ساخت Android خود را با مشخص کردن «شناسه برنامه Firebase» برنامه توزیع کنید، به‌صورت اختیاری یادداشت انتشار و فایلی حاوی ایمیل‌های آزمایشگران اضافه کنید:
firebase appdistribution:distribute test.aab \
--app 1:1234567890:android:0a1b2c3d4e5f67890 \
--release-notes "Bug fixes and improvements" --testers-file testers.txt
برای کسب اطلاعات بیشتر درباره استفاده از Firebase CLI برای خودکارسازی ساخت‌ها، به توزیع برنامه‌های Android برای آزمایشگران بااستفاده از Firebase CLI مراجعه کنید.
استفاده از اعتبارنامه‌های سرویس برای اصالت‌سنجی
از App Distribution افزایه fastlane، افزایه Gradle، یا Firebase CLI با حساب‌های سرویس استفاده کنید. حساب خدمات نوعی «حساب Google» است که نشان‌دهنده برنامه‌ها است (درمقایسه با کاربران). سیستم CI شما می‌تواند از حساب‌های سرویس برای اجرای App Distribution بار کاری استفاده کند. برای کسب اطلاعات بیشتر، به احراز هویت با حساب سرویس مراجعه کنید.
اگر از فدراسیون هویت بار کاری استفاده می‌کنید، می‌توانید به‌جای کلید حساب سرویس، فایل پیکربندی اطلاعات اعتباری تولید و استفاده کنید.
محدودیت‌های انتشار را درنظر داشته باشید
App Distribution حداکثر از ۱٬۰۰۰ نسخه پخش برای هر برنامه پشتیبانی می‌کند. این یعنی وقتی از حد مجاز نسخه پخش فراتر بروید، App Distribution به‌طور خودکار قدیمی‌ترین نسخه‌های پخش بالاتر از حد مجاز را حذف می‌کند. برای آشنایی با نحوه مدیریت محدودیت‌های انتشار، به انتشارهای برنامه تا چه مدت دردسترس هستند؟ مراجعه کنید.
افزودن مجموعه یکسانی از آزمایشگران به چند نسخه پخش
اگر می‌خواهید تعداد زیادی آزمایش‌گر به نسخه‌های پخش خود اضافه کنید، از عملکرد مدیریت آزمایش‌گر انبوه App Distribution استفاده کنید.
توصیه می‌کنیم از گروه‌ها برای افزودن آزمایش‌کنندگان یکسان به چندین نسخه پخش استفاده کنید. گروه به‌عنوان فهرست کنترل دسترسی عمل می‌کند؛ وقتی آزمایشگری را از گروهی بردارید، او دسترسی به همه نسخه‌های پخش توزیع‌شده برای آن گروه را ازدست می‌دهد. برای کسب اطلاعات بیشتر، به افزودن و برداشتن آزمایش‌کنندگان از گروه مراجعه کنید.
اگر آزمونگران زیادی برای مدیریت کردن دارید، می‌توانید آزمونگران را به‌صورت انبوه اضافه و حذف کنید بااستفاده از کنسول Firebase. برای خودکارسازی افزودن و برداشتن آزمایش‌کنندگان، از Firebase CLI، fastlane، Gradle، یا API عمومی Firebase App Distribution استفاده کنید.
محدودیت‌های آزمایش‌گر را به‌خاطر داشته باشید
App Distribution تعداد آزمایش‌گرانی را که می‌توانید به پروژه Firebase یا گروه App Distribution اضافه کنید محدود می‌کند. وقتی از این محدودیت‌ها فراتر بروید، نمی‌توانید برنامه‌تان را برای آزمونگران بیشتری توزیع کنید. برای کسب اطلاعات بیشتر درباره محدودیت‌های آزمایش‌کننده، به آیا برای افزودن آزمایش‌کننده به برنامه‌ام محدودیت‌هایی وجود دارد؟ مراجعه کنید.
فعال کردن امکان ثبت‌نام خودکار برای آزمایشگران بالقوه
برای اینکه توزیع برنامه‌تان بین آزمایشگران بیشتر آسان‌تر شود، توصیه می‌کنیم از پیوندهای دعوت استفاده کنید. پیوند دعوت نشانی وب یکتایی است که به آزمایشگران امکان می‌دهد نشانی‌های ایمیل خود را برای ثبت‌نام در آزمایش برنامه وارد کنند. فعال کردن امکان افزودن کاربران به فهرست آزمایشگران برنامه روشی یکپارچه برای افزایش پایگاه آزمایش داخلی شما است.
موارد استفاده از پیوندهای دعوت شامل برنامه‌های تست داخلی شرکت، سازمان‌هایی با تیم‌های بزرگ تضمین کیفیت، و گروه‌های توسعه‌دهنده‌ای است که می‌خواهند مشتریان فردی بتوانند دسترسی آزمایش‌کننده را کنترل کنند.
توصیه می‌کنیم پیوند دعوتی برای گروه ایجاد کنید. هر آزمایشگری که بااستفاده از پیوند دعوت ثبت‌نام کند، به‌طور خودکار به نسخه‌های بعدی اضافه می‌شود.
برای کسب اطلاعات بیشتر، ایجاد پیوندهای دعوت و افزودن و برداشتن آزمایش‌کنندگان از گروه را ببینید.
مطمئن شوید که آزمایشگران نسخه‌ای را که برایتان مهم است آزمایش می‌کنند
وقتی نسخه جدیدی بارگذاری می‌شود، آزمایشگران شما ازطریق ایمیل مطلع می‌شوند. برای تکمیل این اعلان، می‌توانید از ویژگی‌های زیر – پیوندهای انتشار و هشدارهای درون‌برنامه‌ای – استفاده کنید تا مطمئن شوید آزمایش‌کنندگان شما نسخه برنامه موردنظر شما را آزمایش می‌کنند:
- پیوندهای نسخه پخش: وقتی می‌خواهید نسخه خاصی را با آزمونگران هم‌رسانی کنید از این ویژگی استفاده کنید. برای آشنایی با نحوه استفاده از پیوندهای نسخه پخش، به توزیع برنامه‌های Android برای آزمونگران بااستفاده از کنسول Firebase مراجعه کنید. این پیوندها همچنین با ابزارهای خط فرمان (CLI) ما Firebase، fastlane، و Gradle برای استفاده با ابزارهای خودکارسازی ساخت دردسترس هستند.
- هشدارهای درون‌برنامه‌ای: از این هشدارها زمانی استفاده کنید که می‌خواهید مطمئن شوید آزمایش‌کنندگان شما جدیدترین نسخه برنامه را آزمایش می‌کنند. با ادغام کردن کیت توسعه نرم‌افزار Firebase App Distribution Android، می‌توانید وقتی ساخت‌های جدید برنامه دردسترس قرار می‌گیرد، هشدارها را مستقیماً در برنامه به آزمایش‌کنندگان نمایش دهید. برای آشنایی با نحوه افزودن هشدارهای درون‌برنامه، اعلان کردن ساخت‌های جدید به آزمایش‌کنندگان را ببینید.
برداشتن خودکار دسترسی آزمونگرانی که شرکت را ترک می‌کنند
وقتی جریان آزمایش داخلی CI/CD شما راه‌اندازی و اجرا شد، باید مطمئن شوید که افرادی که شرکت را ترک می‌کنند دیگر به ساخت‌های داخلی شما دسترسی ندارند. برای کمک به شما در مدیریت دسترسی آزمایش‌کنندگان به ساخت‌ها، App Distribution گزینه‌های زیر را ارائه می‌دهد:
- fastlane: از فایل Fastfile خود استفاده کنید یا کنش‌های fastlane را مستقیماً اجرا کنید. برای کسب اطلاعات بیشتر، توزیع برنامه‌های Android برای آزمایشگران بااستفاده از fastlane را ببینید.
- Firebase CLI: از
firebase appdistribution:testers:removeکنش استفاده کنید. برای کسب اطلاعات بیشتر، به توزیع برنامه‌های Android برای آزمایشگران بااستفاده از Firebase CLI مراجعه کنید. - Gradle: اگر از Gradle برای برداشتن آزمایش‌کنندگان استفاده می‌کنید،
appDistributionRemoveTestersرا با آرگومان‌های--PROJECT_NUMBER --EMAILS build.gradleخود بگذرانید. برای کسب اطلاعات بیشتر، به توزیع برنامه‌های Android برای آزمایشگران بااستفاده از Gradle مراجعه کنید. - **عمومی
Firebase App Distribution API:
** از نقطه پایان
testers.batchRemoveاستفاده کنید.