با استفاده از Firebase CLI، برنامه‌های iOS را بین آزمایش‌کنندگان توزیع کنید

می‌توانید با استفاده از Firebase CLI ساخت‌ها را بین آزمایش‌کنندگان توزیع کنید. ابزار CLI به شما این امکان را می‌دهد که آزمایش‌کننده‌ها و یادداشت‌های انتشار را برای یک ساخت مشخص کنید و ساخت را بر اساس آن توزیع کنید.

برای توزیع برنامه خود بین آزمایشگران، فایل IPA را با استفاده از Firebase CLI آپلود کنید:

1. آخرین نسخه Firebase CLI را نصب یا به روز کنید (توصیه می کنیم باینری مستقل را برای CLI مخصوص سیستم عامل خود دانلود کنید). مطمئن شوید که وارد شوید و تست کنید که می توانید به پروژه های خود دسترسی داشته باشید.
2. در صفحه توزیع برنامه کنسول Firebase، برنامه‌ای را که می‌خواهید توزیع کنید انتخاب کنید، سپس روی شروع به کار کلیک کنید.

3. دستور appdistribution:distribute اجرا کنید تا برنامه خود را آپلود کرده و بین آزمایش کنندگان توزیع کنید. برای پیکربندی توزیع از پارامترهای زیر استفاده کنید:

   appdistribution: توزیع گزینه ها
   --app	مورد نیاز : شناسه برنامه Firebase برنامه شما. می‌توانید شناسه برنامه را در کنسول Firebase، در صفحه تنظیمات عمومی پیدا کنید. --app 1:1234567890:ios: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.ipa  \
       --app 1:1234567890:ios:0a1b2c3d4e5f67890  \
       --release-notes "Bug fixes and improvements" --testers-file testers.txt
   

   Firebase CLI پیوندهای زیر را پس از آپلود انتشار خروجی می دهد. این پیوندها به شما کمک می‌کنند فایل‌های باینری را مدیریت کنید و اطمینان حاصل کنید که آزمایش‌کنندگان و سایر توسعه‌دهندگان نسخه مناسبی دارند:

   • firebase_console_uri - پیوندی به کنسول Firebase که یک نسخه را نمایش می‌دهد. می توانید این پیوند را با سایر توسعه دهندگان در سازمان خود به اشتراک بگذارید.
   • testing_uri - پیوندی به نسخه در تجربه آزمایش‌کننده (کلیپ وب iOS) که به آزمایش‌کنندگان اجازه می‌دهد یادداشت‌های انتشار را مشاهده کرده و برنامه را روی دستگاه خود نصب کنند. آزمایش‌کننده برای استفاده از پیوند نیاز به دسترسی به انتشار دارد.
   • binary_download_uri - پیوند امضا شده ای که مستقیماً برنامه باینری (فایل IPA) را دانلود و نصب می کند. لینک بعد از یک ساعت منقضی می شود.

   علاوه بر توزیع نسخه‌ها، می‌توانید از 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 مشخص کنید.

هنگامی که ساخت خود را توزیع کردید، به مدت 150 روز (پنج ماه) در داشبورد توزیع برنامه کنسول Firebase در دسترس قرار می گیرد. وقتی ساخت 30 روز از انقضا می‌گذرد، یک اخطار انقضا هم در کنسول و هم در فهرست ساخت‌های آزمایش‌کننده شما در دستگاه آزمایشی ظاهر می‌شود.

آزمایش‌کنندگانی که برای آزمایش برنامه دعوت نشده‌اند، دعوت‌نامه‌های ایمیلی را برای شروع دریافت می‌کنند، و آزمایش‌کنندگان فعلی اعلان‌های ایمیلی مبنی بر آماده بودن ساخت جدید برای آزمایش دریافت می‌کنند. برای آشنایی با نحوه نصب برنامه آزمایشی، به راه اندازی به عنوان آزمایشگر مراجعه کنید. می‌توانید وضعیت هر آزمایش‌کننده را کنترل کنید - آیا دعوت‌نامه را پذیرفته‌اند و آیا برنامه را دانلود کرده‌اند یا خیر - در کنسول Firebase.

آزمایش‌کننده‌ها 30 روز فرصت دارند تا قبل از انقضا، دعوتنامه را برای آزمایش برنامه بپذیرند. وقتی دعوتنامه 5 روز از تاریخ انقضا می‌گذرد، در کنسول Firebase در کنار آزمایش‌کننده در نسخه‌ای که منتشر می‌شود، اعلان انقضا ظاهر می‌شود. یک دعوت نامه را می توان با ارسال مجدد آن با استفاده از منوی کشویی در ردیف آزمایشگر تمدید کرد.

مراحل بعدی

• برای ثبت دستگاه های بیشتر به صورت دستی یا برنامه ای، به ثبت دستگاه های iOS اضافی مراجعه کنید.

• با استفاده از CI/CD و fastlane، بهترین روش‌ها را برای توزیع برنامه‌های Apple به آزمایش‌کنندگان QA بیاموزید.