عیب‌یابی و پرسشگان «توزیع برنامه»

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

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

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

درصورت دردسترس بودن، «ایمیل تماس» را در کنسول Firebase تنظیم کنید. اگر مشکل برطرف نشد، با پشتیبانی Firebase تماس بگیرید.

هنگام آماده‌سازی برنامه خطایی رخ داد (خطاهای ۴۰۰، ۴۰۹، یا ۵۰۰)

اگر به‌طور مکرر با خطاهای ۴۰۰، ۴۰۹، یا ۵۰۰ درطول آماده‌سازی مواجه شدید، با پشتیبانی 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 را درستی‌سنجی کنید. حداکثر حد اندازه فایل برای همه فایل‌های باینری ‫۲۰۴۸ مگابایت است که کمی بیشتر از ۲ گیگابایت است.

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

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

   2. جداکننده‌های <array> را بردارید و برنامه‌تان را بازسازی کنید. بارگذاری باید موفقیت‌آمیز باشد.

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

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

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

آزمونگر حساب Google ندارد

وقتی کاربری «حساب Google» ایجاد می‌کند، به‌طور خودکار نشانی Gmail دریافت می‌کند.

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

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

• از نشانی Gmail استفاده نکنید.
• از نشانی ایمیلی که قبلاً به «حساب Google» دیگری پیوند شده است استفاده نکنید.
• یادتان باشد که هنگام وارد شدن به سیستم با این نشانی ایمیل باید از گذرواژه «حساب Google» استفاده کنید.

برای اطلاعات بیشتر، وارد شدن به سیستم «حساب Google» با نشانی ایمیل دیگر را ببینید.

آزمونگر نمی‌تواند برنامه‌ها یا ساختارهای صحیح را ببیند

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

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

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

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

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

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

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

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

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

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

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

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

راه‌حل ۱

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

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

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

راهکار ۲

اگر آزمایشگر علاقه‌ای به دریافت اعلان‌های ایمیلی ندارد و فقط می‌خواهد بتواند دعوت‌های برنامه را بپذیرد، می‌تواند دعوت‌های برنامه معلقه را مستقیماً در کلیپ وب Firebase App Distribution ببیند: appdistribution.firebase.google.com.

راه‌حل ۳

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

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

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

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

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

خطای «حالت توسعه‌دهنده الزامی است» زمانی ظاهر می‌شود که بخواهید برنامه iOS آماده‌سازی‌شده موردی را در iOS 16 یا نسخه‌های جدیدتر بدون فعال کردن «حالت توسعه‌دهنده» اجرا کنید.

برای فعال کردن «حالت توسعه‌دهنده» و رفع این خطا، این مراحل را دنبال کنید:

1. در iPhone، برنامه «تنظیمات» را باز کنید و سپس روی حریم خصوصی و امنیت تک‌ضرب بزنید.
2. به پایین پیمایش کنید و روی «امنیت» و سپس حالت توسعه‌دهنده تک‌ضرب بزنید.
3. روی لغزنده حالت توسعه‌دهنده تک‌ضرب بزنید.
4. روی بازراه‌اندازی تک‌ضرب بزنید.
5. پس‌از بازراه‌اندازی دستگاه، قفل دستگاه را باز کنید. کادر گفتگوی «حالت توسعه‌دهنده روشن شود؟» نمایان می‌شود.
6. روی روشن کردن تک‌ضرب بزنید. اکنون می‌توانید برنامه‌تان را راه‌اندازی کنید و آزمایش را شروع کنید.

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

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

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

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

خطای ۴۰۳: «برای دسترسی با سرپرستتان تماس بگیرید»

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• بررسی کنید که «میانای برنامه‌سازی کاربردی آزمایش‌گران برنامه Firebase» را فعال کرده باشید. برای اطلاعات بیشتر، به فعال کردن App Distribution Tester API مراجعه کنید.

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

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

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

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

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

• حداکثر ۲۰۰ آزمایش‌گر به گروه App Distribution اضافه کنید

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

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

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

نسخه پخش جدید برای بارگذاری‌های iOS چه زمانی ایجاد می‌شود؟

ثبت دستگاه‌های اضافی را ببینید.

نسخه‌های پخش برنامه تا چه مدت دردسترس هستند؟

نسخه‌های پخش برنامه در App Distribution درصورت وقوع یکی از شرایط زیر برداشته می‌شوند:

• انتشار برنامه قدیمی‌تر از ۱۵۰ روز است.
• از حد مجاز ۱٬۰۰۰ نسخه پخش برنامه فراتر رفته‌اید و نسخه پخش برنامه قدیمی‌تر از ۱٬۰۰۰ نسخه پخش برنامه اخیر است.

برای اطلاعات بیشتر، به App Distribution حداکثر از ۱٬۰۰۰ نسخه پشتیبانی می‌کند مراجعه کنید.

پس‌از اینکه برنامه به حد مجاز انقضای ۱۵۰ روزه یا حد مجاز انتشار ۱٬۰۰۰ برنامه رسید یا از آن فراتر رفت، نسخه پخش از داشبورد App Distribution و برنامه تحت وب آزمونگر App Distribution برداشته می‌شود. اگر آزمونگرتان نسخه پخش را نصب کرده باشد، نسخه محلی برنامه همچنان اجرا می‌شود.

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

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

نسخه‌های پخش برنامه پس‌از ۱۵۰ روز منقضی می‌شوند

وقتی نسخه پخش برنامه‌تان را در Firebase بارگذاری می‌کنید، نسخه پخش در داشبوردApp Distribution به‌مدت ۱۵۰ روز از تاریخ بارگذاری نشان داده می‌شود. پس‌از بارگذاری نسخه پخش، می‌توانید آن را دراختیار آزمایش‌گران قرار دهید. آزمایش‌گران نسخه پخش را از برنامه وب آزمایش‌گر App Distribution در دستگاه آزمایشی‌شان نصب می‌کنند.

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

‫App Distribution حداکثر از ۱٬۰۰۰ نسخه پخش پشتیبانی می‌کند

‫App Distribution حداکثر ۱٬۰۰۰ نسخه پخش برای هر برنامه مجاز است. وقتی برنامه شما به حد مجاز ۱٬۰۰۰ نسخه پخش برنامه برسد، App Distribution به‌طور خودکار قدیمی‌ترین نسخه‌های پخش فراتر از حد مجاز را حذف می‌کند.

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

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

نمایه Firebase چیست؟

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

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

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

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

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

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

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

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

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

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

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

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

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

1. به https://appdistribution.firebase.google.com بروید و با «حساب Google» خود به سیستم وارد شوید.

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

   حذف حساب.

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