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

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

قبل از اینکه شروع کنی

اگر قبلاً این کار را نکرده‌اید، Firebase را به پروژه Apple خود اضافه کنید .

اگر از محصولات Firebase دیگر استفاده نمی کنید، فقط باید یک پروژه ایجاد کنید و برنامه خود را ثبت کنید. با این حال، اگر تصمیم به استفاده از محصولات اضافی در آینده دارید، مطمئن شوید که تمام مراحل را در صفحه لینک بالا انجام دهید.

مرحله 1 . اپلیکیشن خود را بسازید

هنگامی که آماده توزیع نسخه پیش از انتشار برنامه خود برای آزمایش کنندگان هستید، یک بایگانی توزیع امضا شده بسازید. تا زمانی که شرایط زیر را داشته باشید، می توانید از فرآیند ساخت عادی خود استفاده کنید:

  • برای توزیع برنامه خود فراتر از تیم توسعه، باید از نمایه توزیع Ad Hoc یا Enterprise خود استفاده کنید.
  • اگر برنامه شما از Game Center، APN (و با فرمت، Cloud Messaging )، یا iCloud استفاده می‌کند، مطمئن شوید که نمایه تأمین‌کننده شما از شناسه برنامه صریح استفاده می‌کند و نه از یک شناسه عام.
  • اگر از نمایه توزیع Ad Hoc استفاده می‌کنید، شناسه‌های منحصربه‌فرد دستگاه (UDID) دستگاه‌های آزمایش‌کنندگان خود را اضافه کنید. از آنجایی که آزمایش‌کنندگان جدید iOS در برنامه آزمایشی شما ثبت‌نام می‌کنند، باید نمایه تأمین را با UDID دستگاه‌هایشان به‌روزرسانی کنید. به ثبت دستگاه های آزمایشگر اضافی مراجعه کنید.
  • شما شماره نسخه قابل مشاهده برای کاربر ( نسخه ) و شماره ساخت منحصر به فرد ( ساخت ) را به روز کردید. اگر از آخرین بیلد تغییراتی در کد ایجاد کرده اید (یعنی فقط برای به روز رسانی دستگاه های ثبت شده بازسازی نمی کنید)، نیازی به آپدیت نسخه و شماره ساخت ندارید.

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

مرحله 2 . برنامه خود را بین آزمایش کنندگان توزیع کنید

برای توزیع برنامه خود بین آزمایشگران، فایل 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
    

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

مراحل بعدی