دستگاه های iOS اضافی را ثبت کنید

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

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

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

UDID ها را به صورت دستی صادر کنید

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

      در برگه آزمایش‌کنندگان و گروه‌های داشبورد App Distribution ، همه آزمایش‌کنندگان را انتخاب کنید، سپس روی Export Apple UDIDs کلیک کنید تا یک فایل CSV دانلود شود. سپس، فایل را با استفاده از گزینه Register Multiple Devices به حساب توسعه دهنده اپل خود وارد کنید. برای کسب اطلاعات بیشتر، به توزیع برنامه خود در دستگاه های ثبت شده مراجعه کنید.

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

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

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

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

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

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

    lane :download_udids do
        firebase_app_distribution_get_udids(
            app: "<your Firebase app ID>",
            output_file: "<path to output file>",
        )
    end
    
  2. با استفاده از گزینه Register Multiple Devices، UDID(ها) را به حساب توسعه دهنده اپل خود وارد کنید. برای کسب اطلاعات بیشتر، به مستندات اپل مراجعه کنید. توجه داشته باشید که حساب توسعه دهنده اپل شما ممکن است تنها به شما اجازه دهد تعداد محدودی دستگاه را در سال وارد کنید.

  3. دستگاه های ثبت شده را به نمایه تامین کننده خود اضافه کنید.

  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. Cloud Functions را برای Firebase تنظیم کنید که شامل وظایف زیر است:

    1. یک محیط توسعه برای Node.js یا Python تنظیم کنید.
    2. Firebase CLI را نصب کرده و وارد آن شوید.
    3. با استفاده از Firebase CLI، Cloud Functions for Firebase راه اندازی کنید.
  2. تابعی را بنویسید و مستقر کنید که یک رویداد هشدار را از App Distribution ضبط می کند و بار رویداد را مدیریت می کند (به عنوان مثال، اطلاعات هشدار را در پیامی در Discord پست می کند).

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

مراحل بعدی