ثبت دستگاه‌های iOS اضافی

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

وقتی آزمونگری دعوت آزمایش برنامه‌تان را می‌پذیرد، App Distribution اجازه می‌خواهد تا شناسه دستگاه آزمونگر را با شما، یعنی توسعه‌دهنده، هم‌رسانی کند. پیش‌از بارگیری ساخت ad hoc،‏ App Distribution از آزمایش‌کننده می‌خواهد دستگاهش را ثبت کند. اگر آزمایش‌کننده دستگاهش را ثبت کند، App Distribution شناسه UDID را از دستگاه جمع‌آوری می‌کند و ازطریق ایمیل شناسه UDID را به شما اطلاع می‌دهد.

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

صادر کردن دستی UDID

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

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

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

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

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

  2. دستگاه‌های ثبت‌شده را به نمایه تدارک اضافه کنید.
  3. نمایه تدارک را بارگیری کنید و از آن برای بازسازی برنامه‌تان استفاده کنید. اگر فقط برای به‌روزرسانی دستگاه‌های ثبت‌شده بازسازی می‌کنید، شماره ساخت یا نسخه را به‌روز نکنید.
  4. برنامه‌تان را از کنسول Firebase یا رابط خط فرمان دوباره توزیع کنید. اگر نسخه، شماره ساخت، یا کد برنامه‌تان را تغییر ندهید، App Distribution نسخه پخش جدیدی ایجاد نمی‌کند و به آزمایش‌کنندگان اطلاع نمی‌دهد. اگر قبلاً ساختی با همان شماره ساخت و نسخه توزیع کرده‌اید، فقط کاربران دستگاه‌های تازه ثبت‌شده ایمیل‌های اعلان دریافت می‌کنند.

صادر کردن UDID به‌صورت برنامه‌نویسی‌شده بااستفاده از fastlane

  1. همه UDIDهای دستگاه آزمایش‌کننده را به‌صورت فایل CSV از fastlane صادر کنید. برای مثال، یک مسیر download_udids جدید ایجاد و اجرا کنید:

    lane :download_udids do
    firebase_app_distribution_get_udids(
        app: "<your Firebase app ID>",
        output_file: "<path to output file>",
    )
end

  2. UDID(ها) را بااستفاده از گزینه ثبت چند دستگاه به حساب توسعه‌دهنده Apple خود وارد کنید. برای کسب اطلاعات بیشتر، به اسناد Apple مراجعه کنید. توجه داشته باشید که حساب توسعه‌دهنده Apple شما ممکن است فقط به شما اجازه دهد تعداد محدودی دستگاه در سال وارد کنید.

  3. دستگاه‌های ثبت‌شده را به نمایه آماده‌سازی {: .external} خود اضافه کنید.

  4. نمایه تدارک را بارگیری کنید و از آن برای بازسازی برنامه‌تان استفاده کنید. اگر بازسازی را فقط برای به‌روزرسانی دستگاه‌های ثبت‌شده انجام می‌دهید، شماره ساخت یا نسخه را به‌روز نکنید.

  5. برنامه‌تان را دوباره توزیع کنید. اگر نسخه، شماره ساخت، یا کد برنامه‌تان را تغییر ندهید، App Distribution نسخه پخش جدیدی ایجاد نمی‌کند و به آزمایش‌کنندگان اطلاع نمی‌دهد. اگر قبلاً ساخت با شماره ساخت و نسخه یکسان توزیع کرده‌اید، فقط کاربران دستگاه‌های تازه ثبت‌شده ایمیل‌های اعلان را دریافت خواهند کرد.

دریافت هشدارها

دریافت هشدارهای پیش‌فرض

به‌طور پیش‌فرض، Firebase می‌تواند App Distribution هشدار برای ثبت دستگاه iOS جدید بااستفاده از ایمیل ارسال کند.

برای دریافت هشدارهای App Distribution بااستفاده از این سازوکار پیش‌فرض، باید اجازه firebase.projects.update را داشته باشید. نقش‌های زیر به‌طور پیش‌فرض شامل این اجازه لازم هستند: سرپرست Firebase یا مالک یا ویرایشگر پروژه.

به‌طور پیش‌فرض، هر عضو پروژه (که اجازه‌های لازم را برای دریافت هشدارها دارد) هنگام ثبت دستگاه iOS جدید ایمیلی دریافت خواهد کرد.

روشن یا خاموش کردن هشدارها برای حساب خودتان

برای حساب خودتان، می‌توانید هشدارهای App Distribution را بدون تأثیر گذاشتن بر دیگر اعضای پروژه روشن/خاموش کنید. توجه داشته باشید که برای دریافت هشدارها، همچنان به اجازه‌های لازم نیاز دارید.

برای روشن یا خاموش کردن هشدارهای App Distribution، این مراحل را دنبال کنید:

  1. در کنسول Firebase، در گوشه بالا، به هشدارهای Firebase بروید.
  2. سپس به تنظیمات بروید و اولویت حسابتان را برای هشدارهای App Distribution تنظیم کنید.

راه‌اندازی هشدار پیشرفته برای سرویس‌های شخص ثالث

همچنین می‌توانید بااستفاده از Cloud Functions for Firebase، هشدارهای App Distribution را به کانال اعلان ترجیحی تیمتان ارسال کنید. برای مثال، می‌توانید تابعی بنویسید که رویداد هشدار را برای ثبت دستگاه iOS جدید ضبط کند و اطلاعات هشدار را در سرویس شخص ثالثی مثل Discord،‏ Slack، یا Jira پست کند.

برای خودکارسازی کامل آماده‌سازی آزمایش‌کنندگان جدید iOS، می‌توانید تابعی بنویسید که UDID دستگاه iOS جدید را به نمایه تدارک برنامه شما اضافه کند، برنامه را بازسازی کند، و برنامه را با نمایه تدارک به‌روزشده مجدداً توزیع کند.

برای راه‌اندازی قابلیت‌های هشدار پیشرفته بااستفاده از Cloud Functions for Firebase، این مراحل را دنبال کنید:

  1. راه‌اندازی کردن «توابع ابری ویژه Firebase»، که شامل تکالیف زیر می‌شود:

    1. محیط توسعه نرم‌افزار برای Node.js یا Python راه‌اندازی کنید.
    2. Firebase CLI را نصب کنید و به سیستم آن وارد شوید.
    3. Cloud Functions for Firebase را بااستفاده از Firebase CLI مقداردهی اولیه کنید.

  2. تابع را بنویسید و مستقر کنید که رویداد هشدار را از App Distribution ضبط می‌کند و بار داده رویداد را مدیریت می‌کند (برای مثال، اطلاعات هشدار را در پیامی در Discord پست می‌کند).

برای آشنایی با همه رویدادهای هشداری که می‌توانید ضبط کنید، به اسناد مرجع هشدارهای App Distribution بروید.

مراحل بعدی