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

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

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

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

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

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

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

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

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

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

2. دستگاه‌های ثبت‌شده را به نمایه تدارک اضافه کنید.
3. نمایه تدارک را بارگیری کنید و از آن برای بازسازی برنامه‌تان استفاده کنید. اگر فقط برای به‌روزرسانی دستگاه‌های ثبت‌شده بازسازی می‌کنید، شماره ساخت یا نسخه را به‌روزرسانی نکنید.
4. برنامه‌تان را از کنسول Firebase یا CLI دوباره توزیع کنید. اگر نسخه، شماره ساخت، یا کد برنامه‌تان را تغییر ندهید، 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، در گوشه بالا، به notifications هشدارها بروید.
2. سپس به settings تنظیمات بروید و اولویت حساب خود را برای App Distribution هشدارها تنظیم کنید.

راه‌اندازی هشدار پیشرفته برای سرویس‌های طرف سوم

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

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

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

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

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

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

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

مراحل بعدی

• وارد کردن آزمایش‌کنندگان از فایل‌های CSV.

• برای آشنایی با نحوه افزایش پایگاه آزمایش داخلی، ایجاد پیوندهای دعوت را ببینید.