عیب‌یابی توزیع برنامه و سؤالات متداول

به دلیل گم شدن ایمیل تماس، نمی‌توان برنامه‌ای را توزیع کرد

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

"ما نتوانستیم یک ایمیل تماس برای برنامه <app-id> پیدا کنیم. لطفاً برای راه‌اندازی از توزیع برنامه در کنسول Firebase بازدید کنید."

در صورت وجود، یک ایمیل تماس در کنسول Firebase تنظیم کنید. اگر مشکل همچنان ادامه داشت، با پشتیبانی Firebase تماس بگیرید.

هنگام تهیه برنامه شما خطایی روی داد (400، 409 یا 500 خطا)

اگر در حین تهیه بارها با خطاهای 400، 409 یا 500 مواجه شدید، با پشتیبانی Firebase تماس بگیرید. شماره پروژه Firebase و شناسه برنامه خود را پشتیبانی کنید.

امکان آپلود IPA وجود ندارد

نمونه زیر نمونه ای از پاسخ شبکه مرورگر است:

{
"status": "IN_PROGRESS",
  "message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}

برای حل این مشکل مراحل زیر را دنبال کنید:

1. اندازه IPA را بررسی کنید. حداکثر اندازه فایل برای همه باینری ها 2048 مگابایت است که کمی بیش از 2 گیگابایت است.

2. اگر اندازه IPA در محدوده اندازه فایل است و قابل تکرار است، مراحل زیر را دنبال کنید:

   1. فایل Info.plist خود را بررسی کنید و تأیید کنید که آیا CFBundleDisplayName حاوی هر گونه جداکننده <array> است یا خیر.

   2. جداکننده های <array> را بردارید و برنامه خود را دوباره بسازید. آپلود باید با موفقیت انجام شود.

   3. اگر همچنان با مشکل مواجه هستید، با پشتیبانی Firebase تماس بگیرید.

3. اگر اندازه IPA بیش از حد مجاز اندازه فایل است، تغییرات لازم را برای کاهش اندازه فایل انجام دهید.

4. اگر کاهش اندازه فایل IPA مشکل را حل نکرد، با پشتیبانی Firebase تماس بگیرید و در مورد استفاده از Testflight سؤال کنید.

تستر حساب Google ندارد

هنگامی که یک کاربر یک حساب Google ایجاد می کند، به طور خودکار یک آدرس Gmail دریافت می کند.

اگر آزمایش‌کننده آدرس Google Workspace یا Gmail ندارد، یا اگر ترجیح می‌دهد از آدرس ایمیل دیگری برای ورود به سیستم استفاده کند، از آزمایش‌کننده بخواهید یک آدرس ایمیل غیر Gmail را به حساب مرتبط کند و از آن ایمیل برای ورود به سیستم استفاده کند.

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

• از آدرس جیمیل استفاده نکنید.
• از آدرس ایمیلی که قبلاً به حساب Google دیگری پیوند شده است استفاده نکنید.
• به یاد داشته باشید که هنگام ورود به سیستم با این آدرس ایمیل از رمز عبور حساب Google خود استفاده کنید.

برای اطلاعات بیشتر، با آدرس ایمیل دیگری وارد حساب Google خود شوید .

آزمایش‌کننده قادر به دیدن برنامه‌ها یا ساخت‌های مناسب نیست

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

ایمیلی که برنامه‌نویس برای آن دعوت‌نامه می‌فرستد و به ساخت‌های جدید اضافه می‌کند (ایمیل A) می‌تواند با ایمیلی که آزمایش‌کننده برای پذیرش دعوت استفاده می‌کند (ایمیل B) متفاوت باشد. این یک پیوند در پشت صحنه ایجاد می کند. هر زمان که ایمیل A به ساخت‌های جدید اضافه می‌شود، در واقع این ایمیل B است که دسترسی پیدا می‌کند.

اگر آزمایش‌کننده دعوت نامه ایمیل را با آدرس ایمیل دیگری پذیرفت، این مراحل را برای حل مشکل دنبال کنید:

1. آزمایش‌کننده را از بخش مشاهده همه آزمایش‌کنندگان در برگه آزمایش‌کنندگان و گروه‌ها در صفحه توزیع برنامه کنسول Firebase حذف کنید. دعوت‌نامه‌های موجود حذف می‌شوند.

2. دوباره آزمایش کننده را دعوت کنید تا برنامه شما را آزمایش کند. آزمایش‌کننده باید یک ایمیل دعوت دریافت کند.

3. مطمئن شوید که آزمایش کننده دعوت نامه را با همان آدرس ایمیل می پذیرد.

آزمایش‌کننده اعلان‌های ایمیلی را دریافت نمی‌کند

در صورت بروز یکی از موارد زیر، آزمایش‌کنندگان ممکن است اعلان‌های ایمیلی را دریافت نکنند:

• اعلان های ایمیل به پوشه های هرزنامه ارسال می شود.

• فیلترهای ایمیل تنظیم شده است.

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

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

راه حل 1

1. از آزمایش کننده بخواهید که پوشه هرزنامه و فیلترهای ایمیلی را که در سرویس ایمیل خود تنظیم کرده است بررسی کند.

2. اگر آزمایش‌کننده اشتراک ایمیل‌ها را لغو کرد، از آزمایش‌کننده بخواهید موارد زیر را انجام دهد:

   1. ایمیلی را پیدا کنید که آزمایش‌کننده قبلاً از برنامه دریافت کرده است.
   2. روی مدیریت تنظیمات ایمیل در پایین کلیک کنید و روی Allow emails to resubscribe کلیک کنید.

راه حل 2

1. آزمایش‌کننده را از بخش مشاهده همه آزمایش‌کنندگان در برگه آزمایش‌کنندگان و گروه‌ها در صفحه توزیع برنامه در کنسول Firebase حذف کنید. این عمل دعوت‌های موجود را حذف می‌کند.

2. دوباره آزمایش کننده را دعوت کنید تا برنامه شما را آزمایش کند. آزمایش‌کننده باید یک ایمیل دعوت دریافت کند. مطمئن شوید که آزمایش کننده دعوت نامه را با همان آدرس ایمیلی که دعوت نامه به آن ارسال شده است می پذیرد.

خطای «توسعه‌دهنده سازمانی غیرقابل اعتماد» هنگام تلاش برای اجرای برنامه آزمایشی

خطای Untrusted Enterprise Developer در صورتی ظاهر می شود که قبل از باز کردن برنامه به گواهی توسعه دهنده در دستگاه آزمایشی اعتماد نداشته باشید. در صفحه تنظیمات برنامه > نمایه‌ها و مدیریت دستگاه ، نام برنامه‌نویس برنامه را انتخاب کنید و به آن اعتماد کنید.

هنگام تلاش برای اجرای برنامه آزمایشی، خطای «حالت برنامه‌نویس مورد نیاز است».

خطای Developer Mode Required زمانی ظاهر می‌شود که می‌خواهید یک برنامه iOS اختصاصی را در iOS 16 یا جدیدتر اجرا کنید بدون اینکه ابتدا حالت برنامه‌نویس را فعال کنید.

برای فعال کردن Developer Mode و رفع این خطا، مراحل زیر را دنبال کنید:

1. در iPhone خود، برنامه Settings را باز کنید و سپس روی Privacy & Security ضربه بزنید.
2. به پایین بروید و به Security بروید و روی Developer Mode ضربه بزنید.
3. روی نوار لغزنده Developer Mode ضربه بزنید.
4. روی Restart ضربه بزنید.
5. پس از راه اندازی مجدد دستگاه، قفل دستگاه را باز کنید. حالت برنامه نویس روشن شود؟ گفتگو ظاهر می شود
6. روی روشن کردن ضربه بزنید. اکنون می توانید برنامه خود را راه اندازی کنید و شروع به آزمایش کنید.

"دستگاه ثبت شد، همه چیز آماده است! وقتی برنامه آماده آزمایش شد، ایمیلی دریافت خواهید کرد"

اگر در حال نصب یک توزیع Ad Hoc هستید، این پیام زمانی ظاهر می شود که توسعه دهنده هنوز برنامه خود را برای اجرا در دستگاه آزمایشی شما پیکربندی نکرده باشد. برای در دسترس قرار دادن برنامه در دسترس شما، برنامه‌نویس باید دستورالعمل‌ها را در ثبت دستگاه‌های اضافی تکمیل کند.

حساب Google به برنامه آزمایشی دسترسی ندارد

اگر حساب Google شما به برنامه آزمایشی که قبلاً نصب کرده اید (یا دعوت نامه را پذیرفته اید) دسترسی ندارد، احتمالاً به حساب Google اشتباهی وارد شده اید. برنامه‌هایی که به آن‌ها دسترسی دارید با حساب Google مرتبط هستند که هنگام پذیرش دعوت برای آزمایش برنامه استفاده می‌کردید. با ورود به حساب Google که قبلاً برای پذیرش دعوت استفاده می‌کردید، دوباره امتحان کنید.

خطای 403: "برای دسترسی با ادمین خود تماس بگیرید"

وقتی با خطای 403 مواجه می‌شوید، به این معنی است که حسابی که استفاده می‌کنید مجوز نصب و آزمایش برنامه‌ها را ندارد. دسترسی توسط سرپرست دامنه حساب شما در Google Workspace تعیین می شود.

اگر فکر می‌کنید باید مجوز نصب و آزمایش برنامه‌ها را داشته باشید، از سرپرست حساب Google Workspace خود بخواهید تنظیمات حساب شما را تغییر دهد. سرپرست شما باید دستورالعمل‌های مدیریت دسترسی به سرویس‌هایی را که به‌صورت جداگانه کنترل نمی‌شوند، دنبال کند.

اگر چندین حساب دارید، سعی کنید با حساب دیگری وارد شوید که محدودیتی برای نصب و آزمایش برنامه‌ها ندارد.

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

اگر قبلاً App Distribution iOS SDK را در برنامه خود راه‌اندازی کرده‌اید و آزمایش‌کنندگان هشدارهای درون‌برنامه‌ای را دریافت نمی‌کنند، بررسی کنید تا مطمئن شوید برنامه‌تان نسخه‌های جدید را دریافت می‌کند:

1. حالت اشکال زدایی را در برنامه خود فعال کنید. برای یادگیری نحوه انجام، به مستندات Google Analytics مراجعه کنید.

2. برنامه خود را در یک شبیه ساز اجرا کنید و رشته "[Firebase/AppDistribution]" را جستجو کنید.

3. بررسی کنید که آزمایش‌کننده به نسخه جدید دسترسی داشته باشد:

   • اگر یک شی انتشار معتبر برگردانده شود، احتمالاً مشکلی در چرخه حیات View Controller وجود دارد که در آن گفتگوی هشدار قبل از ظاهر شدن View بارگیری می شود.

   • اگر نسخه‌ای برگردانده نشد، آزمایش‌کننده شما ممکن است هنوز با نسخه جدید مرتبط نباشد. در داشبورد App Distribution کنسول Firebase، مطمئن شوید که تستر شما در توزیع ساخت شما گنجانده شده است و در وضعیت Accepted قرار دارد.

     اگر آزمایش‌کننده شما همچنان به‌روزرسانی‌ها را دریافت نمی‌کند، از او بخواهید نکات زیر را دنبال کند تا مطمئن شود که دعوت‌نامه آزمایش برنامه شما را پذیرفته و دستگاه آزمایشی خود را به درستی راه‌اندازی کرده است:

     1. در دستگاه آزمایشی، وارد کلیپ وب Firebase App Distribution شوید. به یاد داشته باشید که حساب Google را که برای اولین بار هنگام پذیرفتن دعوت برای آزمایش برنامه استفاده کردید، انتخاب کنید.

     2. مطمئن شوید که نسخه جدید برنامه در کلیپ وب موجود است.

آزمایشگر از شما خواسته است که پس از بستن برنامه دوباره وارد سیستم شوید

به‌طور پیش‌فرض، آزمایش‌کنندگان شما فقط باید یک بار وارد حساب Google خود شوند تا هشدارهای ساخت جدید را فعال کنند و ساخت‌های جدید را نصب کنند. اگر پس از بستن و باز کردن مجدد برنامه از آزمایش کنندگان شما خواسته می شود که دوباره به سیستم وارد شوند، این نکات را دنبال کنید تا مطمئن شوید که پیکربندی توزیع برنامه شما به درستی تنظیم شده است:

• بررسی کنید تا مطمئن شوید Firebase App Testers API را فعال کرده اید. برای اطلاعات بیشتر، به فعال کردن API تستر توزیع برنامه مراجعه کنید.

• تحت محدودیت‌های کلیدی ، مطمئن شوید که Firebase App Testers API در فهرست APIهای مجاز گنجانده شده است.

• اگر معمولاً هنگام خروج از سیستم، UserDefaults را پاک می‌کنید، ممکن است وضعیت آزمایش‌کننده خود را پاک کنید. App Distribution پرچمی را ذخیره می‌کند که نشان می‌دهد آزمایش‌کننده شما قبلاً وارد برنامه شده است یا خیر. برای اطلاعات بیشتر، به مخزن GitHub مراجعه کنید.

آیا محدودیت‌هایی برای افزودن آزمایش‌کنندگان به برنامه من وجود دارد؟

Firebase App Distribution دارای محدودیت‌های آزمایش‌کننده زیر است:

• حداکثر 500 آزمایش کننده را به پروژه Firebase اضافه کنید

• حداکثر 200 آزمایش کننده را به یک گروه توزیع برنامه اضافه کنید

برای افزودن آزمایشگرهای بیشتر، درخواست افزایش محدودیت بدون هزینه کنید.

آیا دعوتنامه آزمایشگر من منقضی می شود؟

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

چه زمانی نسخه جدیدی برای آپلودهای iOS ایجاد می شود؟

به ثبت دستگاه های اضافی مراجعه کنید.

چه مدت انتشار برنامه در دسترس است؟

در صورت بروز یکی از شرایط زیر، نسخه‌های برنامه از توزیع برنامه حذف می‌شوند:

• نسخه نسخه قدیمی تر از 150 روز است.
• شما از حد مجاز انتشار 1000 برنامه فراتر رفته اید و نسخه نسخه قدیمی تر از 1000 نسخه جدیدترین برنامه منتشر شده است.

برای اطلاعات بیشتر، ببینید توزیع برنامه حداکثر از 1000 نسخه پشتیبانی می‌کند .

پس از اینکه برنامه به محدودیت انقضای 150 روزه یا محدودیت انتشار 1000 برنامه رسید یا از آن فراتر رفت، نسخه از داشبورد توزیع برنامه و برنامه وب آزمایش کننده توزیع برنامه حذف می شود. اگر آزمایش‌کننده شما نسخه را نصب کرده باشد، نسخه محلی برنامه همچنان اجرا می‌شود.

برای در دسترس نگه داشتن نسخه برنامه برای مدت طولانی‌تری، از یکی از توصیه‌های زیر استفاده کنید:

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

انتشار برنامه پس از 150 روز منقضی می شود

وقتی نسخه‌ای از برنامه خود را در Firebase آپلود می‌کنید، این نسخه از تاریخ آپلود به مدت 150 روز در داشبورد توزیع برنامه ظاهر می‌شود. پس از آپلود نسخه، می‌توانید آن را بین آزمایش‌کنندگان توزیع کنید که نسخه را از برنامه وب آزمایش‌کننده توزیع App بر روی دستگاه آزمایشی خود نصب می‌کنند.

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

App Distribution حداکثر از 1000 نسخه را پشتیبانی می کند

توزیع برنامه حداکثر 1000 نسخه در هر برنامه را امکان پذیر می کند. وقتی برنامه شما به محدودیت انتشار 1000 برنامه رسید، توزیع برنامه به‌طور خودکار قدیمی‌ترین نسخه‌های بالاتر از حد مجاز را حذف می‌کند.

اگر می‌خواهید نسخه‌های برنامه خود را به‌صورت دستی مدیریت کنید، از App Distribution REST API برای فهرست کردن و حذف انبوه نسخه‌های برنامه استفاده کنید.

اگر سؤالی دارید، با پشتیبانی Firebase تماس بگیرید.

پروفایل Firebase چیست؟

نمایه Firebase یک نمایه پیکربندی است که به App Distribution اجازه می دهد:

• دستگاه تست را با جمع آوری شناسه دستگاه منحصر به فرد (UDID) ثبت کنید. اگر در حال آزمایش یک توزیع Ad Hoc هستید، Firebase ایمیلی شامل UDID دستگاه آزمایشی به همراه دستورالعمل‌هایی در مورد نحوه گنجاندن دستگاه در نمایه تهیه برنامه به توسعه‌دهنده برنامه می‌فرستد تا ساختن روی دستگاه شما آزمایش شود.

• یک کلیپ وب Firebase App Distribution را در صفحه اصلی دستگاه خود نصب کنید. کلیپ وب به شما امکان می دهد تمام برنامه های آزمایشی خود را در یک مکان نصب کرده و به آنها دسترسی داشته باشید. ساخت‌های جدیدی که برای آزمایش دعوت شده‌اید به‌طور خودکار به کلیپ وب اضافه می‌شوند.

برای راهنمایی در مورد نصب نمایه های پیکربندی در دستگاه iOS خود، به مستندات Apple مراجعه کنید.

چگونه می توانم به برنامه های آزمایشی که روی دستگاه خود نصب کرده ام دسترسی داشته باشم؟

اگر آزمایش‌کننده هستید، می‌توانید با کلیپ وب Firebase App Distribution به همه برنامه‌های آزمایشی خود دسترسی داشته باشید، که با نصب نمایه Firebase به طور خودکار به صفحه اصلی دستگاه آزمایشی شما اضافه می‌شود. اگر در حال آزمایش یک توزیع Ad Hoc هستید، ابتدا باید نمایه را نصب کنید تا بتوانید برنامه را آزمایش کنید.

اگر در حال آزمایش یک توزیع Enterprise هستید، می توانید نمایه را به صورت دستی نصب کنید:

1. اگر قبلاً این کار را نکرده‌اید، وارد Google شوید و دعوت را بپذیرید.

2. در بخش تست برنامه‌ها ، برنامه‌ای را که می‌خواهید آزمایش کنید انتخاب کنید.

3. در سمت راست بالای صفحه برنامه، روی mobile_screen_share ضربه بزنید.

4. دستورالعمل های نمایش داده شده را برای نصب نمایه Firebase دنبال کنید.

چگونه حساب آزمایشی خود را حذف کنم؟

برای حذف حساب آزمایش‌کننده توزیع برنامه و داده‌های مرتبط با آن، این مراحل را به ترتیب دنبال کنید:

1. از https://appdistribution.firebase.google.com دیدن کنید و با حساب Google خود وارد شوید.

2. در بالا سمت راست، روی settings ( مدیریت حساب ) کلیک کنید

   حذف اکانت

3. اختیاری: در مجوزهای حساب Google خود، دسترسی از Firebase App Distribution را لغو کنید. توجه داشته باشید که لغو دسترسی بدون حذف حساب App Distribution شما، حساب آزمایشگر یا داده‌های شما را حذف نمی‌کند .

به دلیل گم شدن ایمیل تماس، نمی‌توان برنامه‌ای را توزیع کرد

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

"ما نتوانستیم یک ایمیل تماس برای برنامه <app-id> پیدا کنیم. لطفاً برای راه‌اندازی از توزیع برنامه در کنسول Firebase بازدید کنید."

در صورت وجود، یک ایمیل تماس در کنسول Firebase تنظیم کنید. اگر مشکل همچنان ادامه داشت، با پشتیبانی Firebase تماس بگیرید.

هنگام تهیه برنامه شما خطایی روی داد (400، 409 یا 500 خطا)

اگر در حین تهیه بارها با خطاهای 400، 409 یا 500 مواجه شدید، با پشتیبانی Firebase تماس بگیرید. شماره پروژه Firebase و شناسه برنامه خود را پشتیبانی کنید.

امکان آپلود IPA وجود ندارد

نمونه زیر نمونه ای از پاسخ شبکه مرورگر است:

{
"status": "IN_PROGRESS",
  "message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}

برای حل این مشکل مراحل زیر را دنبال کنید:

1. اندازه IPA را بررسی کنید. حداکثر اندازه فایل برای همه باینری ها 2048 مگابایت است که کمی بیش از 2 گیگابایت است.

2. اگر اندازه IPA در محدوده اندازه فایل است و قابل تکرار است، مراحل زیر را دنبال کنید:

   1. فایل Info.plist خود را بررسی کنید و تأیید کنید که آیا CFBundleDisplayName حاوی هر گونه جداکننده <array> است یا خیر.

   2. جداکننده های <array> را بردارید و برنامه خود را دوباره بسازید. آپلود باید با موفقیت انجام شود.

   3. اگر همچنان با مشکل مواجه هستید، با پشتیبانی Firebase تماس بگیرید.

3. اگر اندازه IPA بیش از حد مجاز اندازه فایل است، تغییرات لازم را برای کاهش اندازه فایل انجام دهید.

4. اگر کاهش اندازه فایل IPA مشکل را حل نکرد، با پشتیبانی Firebase تماس بگیرید و در مورد استفاده از Testflight سؤال کنید.

تستر حساب Google ندارد

هنگامی که یک کاربر یک حساب Google ایجاد می کند، به طور خودکار یک آدرس Gmail دریافت می کند.

اگر آزمایش‌کننده آدرس Google Workspace یا Gmail ندارد، یا اگر ترجیح می‌دهد از آدرس ایمیل دیگری برای ورود به سیستم استفاده کند، از آزمایش‌کننده بخواهید یک آدرس ایمیل غیر Gmail را به حساب مرتبط کند و از آن ایمیل برای ورود به سیستم استفاده کند.

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

• از آدرس جیمیل استفاده نکنید.
• از آدرس ایمیلی که قبلاً به حساب Google دیگری پیوند شده است استفاده نکنید.
• به یاد داشته باشید که هنگام ورود به سیستم با این آدرس ایمیل از رمز عبور حساب Google خود استفاده کنید.

برای اطلاعات بیشتر، با آدرس ایمیل دیگری وارد حساب Google خود شوید .

آزمایش‌کننده قادر به دیدن برنامه‌ها یا ساخت‌های مناسب نیست

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

ایمیلی که برنامه‌نویس برای آن دعوت‌نامه می‌فرستد و به ساخت‌های جدید اضافه می‌کند (ایمیل A) می‌تواند با ایمیلی که آزمایش‌کننده برای پذیرش دعوت استفاده می‌کند (ایمیل B) متفاوت باشد. این یک پیوند در پشت صحنه ایجاد می کند. هر زمان که ایمیل A به ساخت‌های جدید اضافه می‌شود، در واقع این ایمیل B است که دسترسی پیدا می‌کند.

اگر آزمایش‌کننده دعوت نامه ایمیل را با آدرس ایمیل دیگری پذیرفت، این مراحل را برای حل مشکل دنبال کنید:

1. آزمایش‌کننده را از بخش مشاهده همه آزمایش‌کنندگان در برگه آزمایش‌کنندگان و گروه‌ها در صفحه توزیع برنامه کنسول Firebase حذف کنید. دعوت‌نامه‌های موجود حذف می‌شوند.

2. دوباره آزمایش کننده را دعوت کنید تا برنامه شما را آزمایش کند. آزمایش‌کننده باید یک ایمیل دعوت دریافت کند.

3. مطمئن شوید که آزمایش کننده دعوت نامه را با همان آدرس ایمیل می پذیرد.

آزمایش‌کننده اعلان‌های ایمیلی را دریافت نمی‌کند

در صورت بروز یکی از موارد زیر، آزمایش‌کنندگان ممکن است اعلان‌های ایمیلی را دریافت نکنند:

• اعلان های ایمیل به پوشه های هرزنامه ارسال می شود.

• فیلترهای ایمیل تنظیم شده است.

• دعوت به یک حساب ایمیل ارسال شد، اما آزمایش‌کننده با حساب ایمیل دیگری پذیرفت. The tester receives new release emails for the email account to which the invitation was originally sent.

• The tester was previously invited but did not accept the initial invitation. If the tester is added to subsequent releases, App Distribution won't automatically send release notifications to that tester because the tester didn't accept the initial invitation.

Solution 1

1. Ask the tester to check their spam folder and any email filters they set in their email service.

2. If the tester unsubscribed from the emails, ask the tester to do the following:

   1. Find an email that the tester previously received from the app.
   2. Click Manage email settings at the bottom and click Allow emails to resubscribe.

Solution 2

1. Delete the tester from the View all testers section of the Testers & Groups tab in the App Distribution page in the Firebase console. This action removes existing invitations.

2. Re-invite the tester to test your app. The tester should receive an invitation email. Make sure that the tester accepts the invitation with the same email address that the invitation was sent to.

"Untrusted Enterprise Developer" error when trying to run test app

The Untrusted Enterprise Developer error appears if you did not trust the developer certificate on the test device before opening the app. In the Settings app > Profiles & Device Management screen, select the app's developer name and trust it.

"Developer Mode Required" error when trying to run test app

The Developer Mode Required error appears when you try to launch an ad hoc-provisioned iOS app on iOS 16 or later without first enabling Developer Mode.

To enable Developer Mode and resolve this error, follow these steps:

1. On your iPhone, open the Settings app and then tap Privacy & Security .
2. Scroll down to Security and tap Developer Mode .
3. Tap the Developer Mode slider.
4. Tap Restart .
5. After the device restarts, unlock the device. The Turn on Developer Mode? dialog appears.
6. Tap Turn On . You can now launch your app and start testing.

"Device registered, you're all set! You'll get an email when the app is ready to test"

If you're installing an Ad Hoc distribution, this message appears when the developer hasn't yet configured their app to run on your test device. To make the app available to you, the developer must complete the instructions in Register additional devices .

Google account doesn't have access to test app

If your Google account does not have access to a test app you previously installed (or accepted an invitation for), it's likely that you signed in to the wrong Google account. The apps to which you have access are associated with the Google account you used when you first accepted the invitation to test the app. Try again by signing in with the Google account you previously used to accept the invitation.

403 error: "Contact your admin for access"

When you encounter a 403 error, this means that the account you're using doesn't have permission to install and test apps. Access is determined by the administrator of your account's domain in Google Workspace.

If you believe you should have permission to install and test apps, ask your Google Workspace account admin to change your account settings. Your admin should follow the instructions in Manage access to services that aren't controlled individually .

If you have multiple accounts, try logging in with a different account that is not restricted from installing and testing apps.

Tester isn't receiving in-app alerts

If you have already set up the App Distribution iOS SDK in your app and your testers aren't receiving in-app alerts, check to make sure your app is fetching new releases:

1. Enable debug mode in your app. To learn how, see the Google Analytics documentation .

2. Run your app in a simulator and search for the string "[Firebase/AppDistribution]".

3. Check that the tester has access to the new release:

   • If a valid release object is returned, it's likely that there's an issue in the View Controller lifecycle where the alert dialog is loaded before the View appears.

   • If no release is returned, your tester may not yet be associated with the new release. In the App Distribution dashboard of the Firebase console, make sure your tester is included in your build distribution and is in the Accepted state.

     If your tester still isn't receiving updates, ask them to follow the tips below to make sure they accepted the invitation to test your app and that they set up their testing device properly:

     1. On the test device, sign into the Firebase App Distribution web clip. Remember to select the Google account you first used when you accepted the invitation to test the app.

     2. Make sure that the new app release is available in the web clip.

Tester prompted to sign in again after closing app

By default, your testers only need to sign in to their Google account once to enable new build alerts and to install new builds. If your testers are being prompted to sign in again after closing and re-opening your app, follow these tips to make sure your App Distribution configuration is set up properly:

• Check to make sure you've enabled the Firebase App Testers API. For more information, see Enable the App Distribution Tester API .

• Under Key restrictions , make sure that the Firebase App Testers API is included in the list of allowed APIs.

• If you typically clear UserDefaults on signing out, you may be clearing your tester's state. App Distribution stores a flag that indicates whether your tester has already signed into the app. For more information, see the GitHub repository .

Are there limits for adding testers to my app?

Firebase App Distribution has the following tester limits:

• Add a maximum of 500 testers to a Firebase project

• Add a maximum of 200 testers to an App Distribution group

To add more testers, request a no-cost limit increase .

Do my tester invitations expire?

Testers have 30 days to accept an invitation to test the app before it expires. When an invitation is 5 days from expiring, an expiration notice appears in the Firebase console next to the tester on a release. An invitation can be renewed by resending it via the drop-down menu on the tester row.

When is a new release created for iOS uploads?

See Register additional devices .

How long are app releases available?

App releases are removed from App Distribution if one of the following conditions occurs:

• The app release is older than 150 days.
• You exceed the 1,000 app release limit, and the app release is older than the 1,000 most recent app releases.

For more information, see App Distribution supports a maximum of 1,000 releases .

After the app reaches or exceeds the 150-day expiration limit or the 1,000 app release limit, the release is removed from the App Distribution dashboard and the App Distribution tester web app. If your tester has installed the release, the local version of the app continues to run.

To keep the app release available longer, use one of the following recommendations:

• Before the app release expires or exceeds the release limit, download the IPA and delete the release from the App Distribution dashboard. Then, re-upload the IPA as a new build to App Distribution.
• Download the release and upload it to Cloud Storage for long-term archiving.

App releases expire after 150 days

When you upload a release of your app to Firebase, the release appears in the App Distribution dashboard for 150 days, starting from the upload date. After you upload the release, you can distribute it to testers, who install the release from the App Distribution tester web app on their testing device.

When the release is 30 days from the expiration date, an app release expiration notification appears on your release in the App Distribution page of the Firebase console and in the App Distribution tester web app.

App Distribution supports a maximum of 1,000 releases

App Distribution allows a maximum of 1,000 releases per app. When your app reaches the 1,000 app release limit, App Distribution automatically deletes the oldest releases above the limit.

If you want to manually manage your app releases, use the App Distribution REST API to list and delete app releases in bulk.

If you have questions, contact Firebase Support .

What is the Firebase profile?

The Firebase profile is a configuration profile that allows App Distribution to:

• Register the test device by collecting the device's unique device ID (UDID). If you're testing an Ad Hoc distribution, Firebase sends the app developer an email that includes the test device's UDID, along with instructions on how to include the device in the app's provisioning profile so that the build can be tested on your device.

• Install a Firebase App Distribution web clip to your device's home screen. The web clip allows you to install and access all your test apps in one place. New builds you're invited to test are automatically added to the web clip.

For help on installing configuration profiles on your iOS device, refer to Apple's documentation .

How can I access test apps I installed on my device?

If you're a tester, you can access all of your test apps with the Firebase App Distribution web clip , which is automatically added to your test device's home screen when you install the Firebase profile. If you're testing an Ad Hoc distribution, you must first install the profile before you can test the app.

If you're testing an Enterprise distribution, you can manually install the profile:

1. If you haven't already, sign in to Google and accept the invitation.

2. Under Test apps , select the app you want to test.

3. In the top right of the app's page, tap mobile_screen_share .

4. Follow the instructions displayed to install the Firebase profile.

How do I delete my tester account?

To delete your App Distribution tester account and its associated data, follow these steps in order:

1. Visit https://appdistribution.firebase.google.com and sign in with your Google account.

2. In the top-right, click settings ( Manage account )

   Delete account .

3. Optional: In your Google account permissions , revoke access from Firebase App Distribution. Note that revoking access without first deleting your App Distribution account does not delete your tester account or data.