Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

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

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

اگر شما در حال حاضر نیست، اضافه فایربیس به پروژه های iOS خود را .

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

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

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

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

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

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

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

  1. نصب و یا به روز رسانی به آخرین نسخه از فایربیس CLI (توصیه می کنیم دانلود باینری مستقل برای خاص CLI به سیستم عامل خود را). اطمینان حاصل کنید که به سیستم وارد شوید و آزمون که شما می توانید پروژه های خود را دسترسی داشته باشید.
  2. در صفحه توزیع برنامه از فایربیس کنسول، برنامه شما می خواهید برای توزیع را انتخاب کنید، سپس با کلیک آغاز شده است.
  3. اجرای appdistribution:distribute فرمان برای آپلود برنامه های خود و توزیع آن را به تست. برای پیکربندی توزیع از پارامترهای زیر استفاده کنید:

    appdistribution: توزیع گزینه ها
    --app

    مورد نیاز: برنامه شما فایربیس شناسه برنامه. شما می توانید ID برنامه در فایربیس کنسول در پیدا کردن، صفحه تنظیمات عمومی .

    --app 1:1234567890:ios:0a1b2c3d4e5f67890
    --token

    تازه کردن رمز که چاپ شده در هنگامی تأیید اعتبار شما محیط CI خود را با فایربیس 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 appdistribution:testers:add anothertester@email.com moretesters@email.com
    
    firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com
    

    ایمیل های تست کننده باید با فاصله از هم جدا شوند. شما همچنین می توانید با استفاده از تست مشخص --file /path/to/testers.txt .

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

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

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

مرحله 3. دستگاههای اضافی را ثبت کنید

هنگامی که آزمایش کنندگان دعوت برای آزمایش ساختاری که با نمایه Enterprise امضا نشده است را می پذیرند ، از آنها اجازه می شود تا شناسه دستگاه خود را با شما به اشتراک بگذارند. در صورت موافقت ، App Distribution UDID را از دستگاه جمع آوری کرده و UDID را از طریق ایمیل به شما اطلاع می دهد.

هنگامی که یکی از این ایمیل ها را دریافت می کنید ، نمایه تأمین خود را با UDID به روز کنید و با دنبال کردن این مراحل ، یک نسخه جدید بین آزمایش کنندگان خود توزیع کنید:

  1. دستگاه ها را به درگاه توسعه دهندگان Apple خود اضافه کنید.
    • گزینه 1: وارد UDID ها دستگاه به عنوان یک فایل CSV.

      در تب آزمایشکنندگان و گروه داشبورد توزیع برنامه، را انتخاب کنید همه تست، سپس با کلیک صادرات اپل به UDID برای دانلود یک فایل CSV. در مرحله بعد فایل را به خود حساب برنامهنویس اپل با استفاده از گزینه دستگاه های چندگانه ثبت نام. برای اشاره مستندات اپل برای کسب اطلاعات بیشتر.

      توجه داشته باشید که حساب برنامه نویس اپل شما فقط به شما اجازه می دهد تعداد محدودی دستگاه در سال وارد کنید.

    • گزینه 2: جمع آوری و وارد UDID ها از طریق ایمیل.

      در اضافه کردن دستگاه های صفحه از توسعه پورتال اپل، ثبت نام UDID جدید مشخص شده که در ایمیل خود دریافت کرده است.

  2. اضافه کردن دستگاه های ثبت به خود مشخصات تأمین .
  3. نمایه تأمین را بارگیری کرده و از آن برای بازسازی برنامه خود استفاده کنید. اگر فقط برای به روز رسانی دستگاه های ثبت شده در حال بازسازی هستید ، شماره یا نسخه بیلد را به روز نکنید.
  4. توزیع مجدد برنامه خود را از فایربیس کنسول و یا CLI. اگر قبلاً یک بیلد با همان شماره نسخه و نسخه توزیع کرده اید ، فقط کاربران دستگاههای تازه ثبت شده ایمیل های اعلان دریافت می کنند.