ثبت دستگاه‌های 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 یا 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 هشدارهای Firebase بروید.
2. سپس به settings تنظیمات بروید و اولویت حسابتان را برای هشدارهای App Distribution تنظیم کنید.

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

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

To fully automate onboarding new iOS testers, you can write a function that adds a new iOS device's UDID to the provisioning profile of your app, rebuilds the app, and redistributes the app with the updated provisioning profile.

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

1. راه‌اندازی کردن Cloud Functions برای Firebase، که شامل تکالیف زیر می‌شود:

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

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

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

مراحل بعدی

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

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