این صفحه راهنمایی عیبیابی و پاسخهایی به سؤالات متداول درباره توزیع و آزمایش برنامهها با App Distribution ارائه میدهد.
توزیع برنامه ها
از نکات زیر برای عیب یابی مشکلاتی که ممکن است هنگام توزیع برنامه ها بین آزمایش کنندگان خود با آن مواجه شوید، استفاده کنید.
هنگام آپلود یک برنامه، ممکن است با این خطا مواجه شوید:
"ما نتوانستیم یک ایمیل تماس برای برنامه <app-id>
پیدا کنیم. لطفاً برای راهاندازی از App Distribution در کنسول Firebase بازدید کنید."
در صورت وجود، یک ایمیل تماس در کنسول Firebase تنظیم کنید. اگر مشکل همچنان ادامه داشت، با پشتیبانی Firebase تماس بگیرید.
اگر در حین تهیه بارها با خطاهای 400، 409 یا 500 مواجه شدید، با پشتیبانی Firebase تماس بگیرید. شماره پروژه Firebase و شناسه برنامه خود را پشتیبانی کنید.
نمونه زیر نمونه ای از پاسخ شبکه مرورگر است:
{
"status": "IN_PROGRESS",
"message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}
برای حل این مشکل مراحل زیر را دنبال کنید:
اندازه IPA را بررسی کنید. حداکثر اندازه فایل برای همه باینری ها 2048 مگابایت است که کمی بیش از 2 گیگابایت است.
اگر اندازه IPA در محدوده اندازه فایل است و قابل تکرار است، مراحل زیر را دنبال کنید:
فایل
Info.plist
خود را بررسی کنید و تأیید کنید که آیاCFBundleDisplayName
حاوی هر گونه جداکننده<array>
است یا خیر.جداکننده های
<array>
را بردارید و برنامه خود را دوباره بسازید. آپلود باید با موفقیت انجام شود.اگر همچنان با مشکل مواجه هستید، با پشتیبانی Firebase تماس بگیرید.
اگر اندازه IPA بیش از حد مجاز اندازه فایل است، تغییرات لازم را برای کاهش اندازه فایل انجام دهید.
اگر کاهش اندازه فایل IPA مشکل را حل نکرد، با پشتیبانی Firebase تماس بگیرید و در مورد استفاده از Testflight سؤال کنید.
نصب و تست اپلیکیشن ها
از نکات زیر برای عیب یابی مشکلاتی که آزمایش کنندگان شما ممکن است هنگام نصب و آزمایش برنامه های شما با آن مواجه شوند، استفاده کنید.
هنگامی که یک کاربر یک حساب Google ایجاد می کند، به طور خودکار یک آدرس Gmail دریافت می کند.
اگر آزمایشکننده آدرس Google Workspace یا Gmail ندارد، یا اگر ترجیح میدهد از آدرس ایمیل دیگری برای ورود به سیستم استفاده کند، از آزمایشکننده بخواهید یک آدرس ایمیل غیر Gmail را به حساب مرتبط کند و از آن ایمیل برای ورود به سیستم استفاده کند.
هنگام انتخاب ایمیل جایگزین، آزمایشکننده باید این دستورالعملها را دنبال کند:
- از آدرس جیمیل استفاده نکنید.
- از آدرس ایمیلی که قبلاً به حساب Google دیگری پیوند شده است استفاده نکنید.
- به یاد داشته باشید که هنگام ورود به سیستم با این آدرس ایمیل از رمز عبور حساب Google خود استفاده کنید.
برای اطلاعات بیشتر، با آدرس ایمیل دیگری وارد حساب Google خود شوید .
اگر آزمایشکننده دعوت نامه رایانامه را با آدرس ایمیل متفاوتی با آدرس ایمیلی که دعوتنامه به آن ارسال شده است بپذیرد، آزمایشکننده ممکن است نتواند برنامهها یا ساختهای مناسب را ببیند.
ایمیلی که برنامهنویس برای آن دعوتنامه میفرستد و به ساختهای جدید اضافه میکند (ایمیل A) میتواند با ایمیلی که آزمایشکننده برای پذیرش دعوت استفاده میکند (ایمیل B) متفاوت باشد. این یک پیوند در پشت صحنه ایجاد می کند. هر زمان که ایمیل A به ساختهای جدید اضافه میشود، در واقع این ایمیل B است که دسترسی پیدا میکند.
اگر آزمایشکننده دعوت نامه ایمیل را با آدرس ایمیل دیگری پذیرفت، این مراحل را برای حل مشکل دنبال کنید:
آزمایشکننده را از بخش مشاهده همه آزمایشکنندگان در برگه آزمایشکنندگان و گروهها در صفحه App Distribution کنسول Firebase حذف کنید. دعوتنامههای موجود حذف میشوند.
دوباره آزمایش کننده را دعوت کنید تا برنامه شما را آزمایش کند. آزمایشکننده باید یک ایمیل دعوت دریافت کند.
مطمئن شوید که آزمایش کننده دعوت نامه را با همان آدرس ایمیل می پذیرد.
در صورت بروز یکی از موارد زیر، آزمایشکنندگان ممکن است اعلانهای ایمیلی را دریافت نکنند:
اعلان های ایمیل به پوشه های هرزنامه ارسال می شود.
فیلترهای ایمیل تنظیم شده است.
دعوت به یک حساب ایمیل ارسال شد، اما آزمایشکننده با حساب ایمیل دیگری پذیرفت. آزمایشکننده ایمیلهای نسخه جدید را برای حساب ایمیلی که دعوتنامه ابتدا به آن ارسال شده است، دریافت میکند.
آزمایشکننده قبلاً دعوت شده بود، اما دعوت اولیه را نپذیرفت. اگر آزمایشکننده به نسخههای بعدی اضافه شود، App Distribution بهطور خودکار اعلانهای انتشار را برای آن آزمایشکننده ارسال نمیکند زیرا آزمایشکننده دعوت اولیه را نپذیرفت.
راه حل 1
از آزمایش کننده بخواهید که پوشه هرزنامه و فیلترهای ایمیلی را که در سرویس ایمیل خود تنظیم کرده است بررسی کند.
اگر آزمایشکننده اشتراک ایمیلها را لغو کرد، از آزمایشکننده بخواهید موارد زیر را انجام دهد:
- ایمیلی را پیدا کنید که آزمایشکننده قبلاً از برنامه دریافت کرده است.
- روی مدیریت تنظیمات ایمیل در پایین کلیک کنید و روی Allow emails to resubscribe کلیک کنید.
راه حل 2
اگر آزمایشکننده به دریافت اعلانهای ایمیل اهمیتی نمیدهد و فقط میخواهد دعوتهای برنامه را بپذیرد، میتواند دعوتهای برنامه در انتظار را مستقیماً در کلیپ وب Firebase App Distribution مشاهده کند: appdistribution.firebase.google.com .
راه حل 3
آزمایشکننده را از بخش مشاهده همه آزمایشکنندگان در برگه آزمایشکنندگان و گروهها در صفحه App Distribution در کنسول Firebase حذف کنید. این عمل دعوتهای موجود را حذف میکند.
دوباره آزمایش کننده را دعوت کنید تا برنامه شما را آزمایش کند. آزمایشکننده باید یک ایمیل دعوت دریافت کند. مطمئن شوید که آزمایش کننده دعوت نامه را با همان آدرس ایمیلی که دعوت نامه به آن ارسال شده است می پذیرد.
خطای Untrusted Enterprise Developer در صورتی ظاهر می شود که قبل از باز کردن برنامه به گواهی توسعه دهنده در دستگاه آزمایشی اعتماد نداشته باشید. در صفحه تنظیمات برنامه > نمایهها و مدیریت دستگاه ، نام برنامهنویس برنامه را انتخاب کنید و به آن اعتماد کنید.
خطای Developer Mode Required زمانی ظاهر میشود که میخواهید یک برنامه iOS اختصاصی را در iOS 16 یا جدیدتر اجرا کنید بدون اینکه ابتدا حالت برنامهنویس را فعال کنید.
برای فعال کردن Developer Mode و رفع این خطا، مراحل زیر را دنبال کنید:
- در iPhone خود، برنامه Settings را باز کنید و سپس روی Privacy & Security ضربه بزنید.
- به پایین بروید و به Security بروید و روی Developer Mode ضربه بزنید.
- روی نوار لغزنده Developer Mode ضربه بزنید.
- روی Restart ضربه بزنید.
- پس از راه اندازی مجدد دستگاه، قفل دستگاه را باز کنید. حالت برنامه نویس روشن شود؟ گفتگو ظاهر می شود
- روی روشن کردن ضربه بزنید. اکنون می توانید برنامه خود را راه اندازی کنید و شروع به آزمایش کنید.
اگر در حال نصب یک توزیع Ad Hoc هستید، این پیام زمانی ظاهر می شود که توسعه دهنده هنوز برنامه خود را برای اجرا در دستگاه آزمایشی شما پیکربندی نکرده باشد. برای در دسترس قرار دادن برنامه در دسترس شما، برنامهنویس باید دستورالعملها را در ثبت دستگاههای اضافی تکمیل کند.
اگر حساب Google شما به برنامه آزمایشی که قبلاً نصب کرده اید (یا دعوت نامه را پذیرفته اید) دسترسی ندارد، احتمالاً به حساب Google اشتباهی وارد شده اید. برنامههایی که به آنها دسترسی دارید با حساب Google مرتبط هستند که هنگام پذیرش دعوت برای آزمایش برنامه استفاده میکردید. با ورود به حساب Google که قبلاً برای پذیرش دعوت استفاده میکردید، دوباره امتحان کنید.
وقتی با خطای 403 مواجه میشوید، به این معنی است که حسابی که استفاده میکنید مجوز نصب و آزمایش برنامهها را ندارد. دسترسی توسط سرپرست دامنه حساب شما در Google Workspace تعیین می شود.
اگر فکر میکنید باید مجوز نصب و آزمایش برنامهها را داشته باشید، از سرپرست حساب Google Workspace خود بخواهید تنظیمات حساب شما را تغییر دهد. سرپرست شما باید دستورالعملهای مدیریت دسترسی به سرویسهایی را که بهصورت جداگانه کنترل نمیشوند، دنبال کند.
اگر چندین حساب دارید، سعی کنید با حساب دیگری وارد شوید که محدودیتی برای نصب و آزمایش برنامهها ندارد.
فعال کردن هشدارهای درون برنامه ای با App Distribution iOS SDK
از نکات زیر برای عیب یابی مشکلاتی استفاده کنید که شامل فعال کردن هشدارهای ساخت جدید درون برنامه با استفاده از App Distribution iOS SDK است.
اگر قبلاً App Distribution iOS SDK را در برنامه خود راهاندازی کردهاید و آزمایشکنندگان هشدارهای درونبرنامهای را دریافت نمیکنند، بررسی کنید تا مطمئن شوید برنامهتان نسخههای جدید را دریافت میکند:
حالت اشکال زدایی را در برنامه خود فعال کنید. برای یادگیری نحوه انجام، به مستندات Google Analytics مراجعه کنید.
برنامه خود را در یک شبیه ساز اجرا کنید و رشته "[Firebase/AppDistribution]" را جستجو کنید.
بررسی کنید که آزمایشکننده به نسخه جدید دسترسی داشته باشد:
اگر یک شی انتشار معتبر برگردانده شود، احتمالاً مشکلی در چرخه حیات View Controller وجود دارد که در آن گفتگوی هشدار قبل از ظاهر شدن View بارگیری می شود.
اگر نسخهای برگردانده نشد، آزمایشکننده شما ممکن است هنوز با نسخه جدید مرتبط نباشد. در داشبورد App Distribution کنسول Firebase ، مطمئن شوید که تستر شما در توزیع ساخت شما گنجانده شده است و در وضعیت Accepted قرار دارد.
اگر آزمایشکننده شما همچنان بهروزرسانیها را دریافت نمیکند، از او بخواهید نکات زیر را دنبال کند تا مطمئن شود که دعوتنامه آزمایش برنامه شما را پذیرفته و دستگاه آزمایشی خود را به درستی راهاندازی کرده است:
در دستگاه آزمایشی، وارد کلیپ وب Firebase App Distribution شوید. به یاد داشته باشید که حساب Google را که برای اولین بار هنگام پذیرفتن دعوت برای آزمایش برنامه استفاده کردید، انتخاب کنید.
مطمئن شوید که نسخه جدید برنامه در کلیپ وب موجود است.
بهطور پیشفرض، آزمایشکنندگان شما فقط باید یک بار وارد حساب Google خود شوند تا هشدارهای ساخت جدید را فعال کنند و ساختهای جدید را نصب کنند. اگر پس از بستن و باز کردن مجدد برنامه از آزمایش کنندگان شما خواسته می شود که دوباره به سیستم وارد شوند، این نکات را دنبال کنید تا مطمئن شوید که پیکربندی App Distribution شما به درستی تنظیم شده است:
بررسی کنید تا مطمئن شوید Firebase App Testers API را فعال کرده اید. برای اطلاعات بیشتر، به فعال کردن API تستر توزیع برنامه مراجعه کنید.
تحت محدودیتهای کلیدی ، مطمئن شوید که Firebase App Testers API در فهرست APIهای مجاز گنجانده شده است.
اگر معمولاً هنگام خروج از سیستم، UserDefaults را پاک میکنید، ممکن است وضعیت آزمایشکننده خود را پاک کنید. App Distribution پرچمی را ذخیره میکند که نشان میدهد آزمایشکننده شما قبلاً وارد برنامه شده است یا خیر. برای اطلاعات بیشتر، به مخزن GitHub مراجعه کنید.
سوالات متداول
Firebase App Distribution دارای محدودیتهای آزمایشکننده زیر است:
حداکثر 500 آزمایش کننده را به پروژه Firebase اضافه کنید
حداکثر 200 آزمایش کننده را به یک گروه App Distribution اضافه کنید
برای افزودن آزمایشگرهای بیشتر، درخواست افزایش محدودیت بدون هزینه کنید.
آزمایشکنندهها 30 روز فرصت دارند تا قبل از انقضا، دعوتنامه را برای آزمایش برنامه بپذیرند. وقتی دعوتنامه 5 روز از تاریخ انقضا میگذرد، در کنسول Firebase در کنار آزمایشکننده در نسخهای که منتشر میشود، اعلان انقضا ظاهر میشود. دعوتنامه را می توان با ارسال مجدد آن از طریق منوی کشویی در ردیف آزمایشگر تمدید کرد.
به ثبت دستگاه های اضافی مراجعه کنید.
در صورت بروز یکی از شرایط زیر، نسخههای برنامه از App Distribution حذف میشوند:
- نسخه نسخه قدیمی تر از 150 روز است.
- شما از محدودیت 1000 انتشار برنامه فراتر رفته اید و نسخه نسخه قدیمی تر از 1000 نسخه جدیدترین نسخه برنامه است.
برای اطلاعات بیشتر، ببینید App Distribution حداکثر از 1000 نسخه پشتیبانی میکند .
پس از اینکه برنامه به محدودیت انقضای 150 روزه یا محدودیت انتشار 1000 برنامه رسید یا از آن فراتر رفت، نسخه از داشبورد App Distribution و برنامه وب آزمایش کننده App Distribution حذف می شود. اگر آزمایشکننده شما نسخه را نصب کرده باشد، نسخه محلی برنامه همچنان اجرا میشود.
برای در دسترس نگه داشتن نسخه برنامه برای مدت طولانیتری، از یکی از توصیههای زیر استفاده کنید:
- قبل از اینکه نسخه برنامه منقضی شود یا از محدودیت انتشار فراتر رود، IPA را دانلود کنید و نسخه را از داشبورد App Distribution حذف کنید. سپس، IPA را به عنوان یک ساخت جدید در App Distribution بارگذاری کنید.
- نسخه را دانلود کنید و برای بایگانی طولانی مدت در Cloud Storage آپلود کنید.
انتشار برنامه پس از 150 روز منقضی می شود
وقتی نسخهای از برنامه خود را در Firebase آپلود میکنید، این نسخه از تاریخ آپلود به مدت 150 روز در داشبورد App Distribution ظاهر میشود. پس از آپلود نسخه، میتوانید آن را بین آزمایشکنندگان توزیع کنید که نسخه را از برنامه وب آزمایشکننده App Distribution بر روی دستگاه آزمایشی خود نصب میکنند.
وقتی انتشار 30 روز از تاریخ انقضا میگذرد، یک اعلان انقضای انتشار برنامه در نسخه شما در صفحه App Distribution کنسول Firebase و در برنامه وب آزمایشکننده App Distribution ظاهر میشود.
App Distribution حداکثر از 1000 نسخه را پشتیبانی می کند
App Distribution حداکثر 1000 نسخه در هر برنامه را امکان پذیر می کند. وقتی برنامه شما به محدودیت انتشار 1000 برنامه رسید، App Distribution بهطور خودکار قدیمیترین نسخههای بالاتر از حد مجاز را حذف میکند.
اگر میخواهید نسخههای برنامه خود را بهصورت دستی مدیریت کنید، از App Distribution REST API برای فهرست کردن و حذف انبوه نسخههای برنامه استفاده کنید.
اگر سؤالی دارید، با پشتیبانی Firebase تماس بگیرید.
نمایه Firebase یک نمایه پیکربندی است که به App Distribution اجازه می دهد:
دستگاه تست را با جمع آوری شناسه دستگاه منحصر به فرد (UDID) ثبت کنید. اگر در حال آزمایش یک توزیع Ad Hoc هستید، Firebase ایمیلی شامل UDID دستگاه آزمایشی به همراه دستورالعملهایی در مورد نحوه گنجاندن دستگاه در نمایه تهیه برنامه به توسعهدهنده برنامه میفرستد تا ساختن روی دستگاه شما آزمایش شود.
یک کلیپ وب Firebase App Distribution در صفحه اصلی دستگاه خود نصب کنید. کلیپ وب به شما امکان می دهد تمام برنامه های آزمایشی خود را در یک مکان نصب کرده و به آنها دسترسی داشته باشید. ساختهای جدیدی که برای آزمایش دعوت شدهاید بهطور خودکار به کلیپ وب اضافه میشوند.
برای راهنمایی در مورد نصب نمایه های پیکربندی در دستگاه iOS خود، به مستندات Apple مراجعه کنید.
اگر آزمایشکننده هستید، میتوانید با کلیپ وب Firebase App Distribution به همه برنامههای آزمایشی خود دسترسی داشته باشید، که با نصب نمایه Firebase به طور خودکار به صفحه اصلی دستگاه آزمایشی شما اضافه میشود. اگر در حال آزمایش یک توزیع Ad Hoc هستید، ابتدا باید نمایه را نصب کنید تا بتوانید برنامه را آزمایش کنید.
اگر در حال آزمایش یک توزیع Enterprise هستید، می توانید نمایه را به صورت دستی نصب کنید:
اگر قبلاً این کار را نکردهاید، وارد Google شوید و دعوت را بپذیرید.
در بخش تست برنامهها ، برنامهای را که میخواهید آزمایش کنید انتخاب کنید.
در سمت راست بالای صفحه برنامه، روی mobile_screen_share ضربه بزنید.
دستورالعمل های نمایش داده شده را برای نصب نمایه Firebase دنبال کنید.
برای حذف حساب آزمایشکننده App Distribution و دادههای مرتبط با آن، این مراحل را به ترتیب دنبال کنید:
از https://appdistribution.firebase.google.com دیدن کنید و با حساب Google خود وارد شوید.
در بالا سمت راست، روی
( مدیریت حساب ) کلیک کنیدحذف اکانت
اختیاری: در مجوزهای حساب Google خود، دسترسی از Firebase App Distribution را لغو کنید. توجه داشته باشید که لغو دسترسی بدون حذف حساب App Distribution شما، حساب آزمایشگر یا دادههای شما را حذف نمیکند .
این صفحه راهنمایی عیبیابی و پاسخهایی به سؤالات متداول درباره توزیع و آزمایش برنامهها با App Distribution ارائه میدهد.
توزیع برنامه ها
از نکات زیر برای عیب یابی مشکلاتی که ممکن است هنگام توزیع برنامه ها بین آزمایش کنندگان خود با آن مواجه شوید، استفاده کنید.
هنگام آپلود یک برنامه، ممکن است با این خطا مواجه شوید:
"ما نتوانستیم یک ایمیل تماس برای برنامه <app-id>
پیدا کنیم. لطفاً برای راهاندازی از App Distribution در کنسول Firebase بازدید کنید."
در صورت وجود، یک ایمیل تماس در کنسول Firebase تنظیم کنید. اگر مشکل همچنان ادامه داشت، با پشتیبانی Firebase تماس بگیرید.
اگر در حین تهیه بارها با خطاهای 400، 409 یا 500 مواجه شدید، با پشتیبانی Firebase تماس بگیرید. شماره پروژه Firebase و شناسه برنامه خود را پشتیبانی کنید.
نمونه زیر نمونه ای از پاسخ شبکه مرورگر است:
{
"status": "IN_PROGRESS",
"message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}
برای حل این مشکل مراحل زیر را دنبال کنید:
اندازه IPA را بررسی کنید. حداکثر اندازه فایل برای همه باینری ها 2048 مگابایت است که کمی بیش از 2 گیگابایت است.
اگر اندازه IPA در محدوده اندازه فایل است و قابل تکرار است، مراحل زیر را دنبال کنید:
فایل
Info.plist
خود را بررسی کنید و تأیید کنید که آیاCFBundleDisplayName
شامل هرگونه محدود کننده<array>
است.محدود کننده های
<array>
را حذف کرده و برنامه خود را بازسازی کنید. بارگذاری باید موفق شود.اگر هنوز مشکل دارید ، با پشتیبانی Firebase تماس بگیرید.
اگر اندازه IPA بیش از حد اندازه پرونده است ، هرگونه تغییر لازم را برای کاهش اندازه پرونده ایجاد کنید.
اگر کاهش اندازه پرونده IPA مسئله را برطرف نمی کند ، با پشتیبانی Firebase تماس بگیرید و از استفاده از TestFlight سؤال کنید.
نصب و آزمایش برنامه ها
از نکات زیر برای عیب یابی مواردی که آزمایش کنندگان شما هنگام نصب و تست برنامه های شما با آنها روبرو هستند استفاده کنید.
وقتی کاربر یک حساب Google ایجاد می کند ، آنها به طور خودکار یک آدرس Gmail دریافت می کنند.
اگر یک تستر از فضای کاری Google یا آدرس Gmail برخوردار نیست ، یا اگر ترجیح می دهند از آدرس ایمیل دیگری برای ورود به سیستم استفاده کنند ، از تستر بخواهید که یک آدرس ایمیل غیر GMAIL را به حساب پیوند داده و از آن ایمیل برای ورود به سیستم استفاده کند.
هنگام انتخاب یک ایمیل متناوب ، تستر باید این دستورالعمل ها را دنبال کند:
- از آدرس gmail استفاده نکنید.
- از آدرس ایمیل استفاده نکنید که قبلاً به یک حساب Google دیگر مرتبط است.
- به یاد داشته باشید هنگام ورود به این آدرس ایمیل از رمز عبور حساب Google خود استفاده کنید.
برای اطلاعات بیشتر ، با آدرس ایمیل دیگری به حساب Google خود وارد شوید .
اگر تستر دعوت نامه الکترونیکی را با آدرس ایمیل متفاوت از آنچه دعوت شده برای آن ارسال شده بود ، پذیرفت ، ممکن است تستر نتواند برنامه های مناسب یا ساخت را ببیند.
ایمیلی که توسعه دهنده دعوت نامه ها را به آن ارسال می کند و به New Builds (ایمیل A) اضافه می کند می تواند با ایمیلی که تستر برای پذیرش دعوت استفاده می کند متفاوت باشد (ایمیل B). این پیوندی در پشت صحنه ایجاد می کند. هر وقت ایمیل A به ساختهای جدید اضافه شود ، در واقع ایمیل B است که دسترسی پیدا می کند.
اگر تستر دعوت نامه ایمیل را با آدرس ایمیل متفاوت پذیرفت ، برای حل مسئله این مراحل را دنبال کنید:
تستر را از بخش مشاهده همه آزمایش کنندگان برگه Testers & Groups در صفحه App Distribution کنسول Firebase حذف کنید. دعوت های موجود حذف می شوند.
برای آزمایش برنامه خود مجدداً تست کننده را دوباره وارد کنید. تستر باید یک ایمیل دعوت دریافت کند.
اطمینان حاصل کنید که تستر دعوت را با همان آدرس ایمیل قبول می کند.
در صورت بروز یکی از موارد زیر ، آزمایش کنندگان ممکن است اعلان های ایمیل دریافت نکنند:
اعلان های ایمیل به پوشه های هرزنامه ارسال می شوند.
فیلترهای ایمیل تنظیم شده اند.
دعوت نامه به یک حساب ایمیل ارسال شد ، اما تستر با یک حساب ایمیل متفاوت پذیرفته شد. تست کننده ایمیل های نسخه جدیدی را برای حساب ایمیل که در ابتدا دعوت نامه برای آن ارسال شده است ، دریافت می کند.
تستر قبلاً دعوت شده بود اما دعوت اولیه را قبول نکرد. اگر تستر به نسخه های بعدی اضافه شود ، App Distribution به طور خودکار اعلان های انتشار را به آن تستر ارسال نمی کند زیرا تستر دعوت اولیه را قبول نکرده است.
راه حل 1
از تستر بخواهید پوشه هرزنامه خود و هر فیلتر ایمیلی را که در سرویس ایمیل خود تنظیم کرده است ، بررسی کند.
اگر تست کننده از ایمیل ها مشترک نیست ، از تستر بخواهید که موارد زیر را انجام دهد:
- ایمیلی را پیدا کنید که تست کننده قبلاً از برنامه دریافت کرده است.
- روی مدیریت تنظیمات ایمیل در پایین کلیک کنید و روی اجازه ایمیل برای ارسال مجدد کلیک کنید.
راه حل 2
اگر تستر به دریافت اعلان های ایمیل اهمیتی نمی دهد و فقط می خواهد دعوت نامه های برنامه را بپذیرد ، می تواند دعوت نامه های در انتظار برنامه را به طور مستقیم در کلیپ وب Firebase App Distribution مشاهده کند: AppDistribution.firebase.google.com .
راه حل 3
تستر را از بخش مشاهده همه آزمایش کنندگان برگه Testers & Groups در صفحه App Distribution در کنسول Firebase حذف کنید. این عمل دعوت های موجود را حذف می کند.
برای آزمایش برنامه خود مجدداً تست کننده را دوباره وارد کنید. تستر باید یک ایمیل دعوت دریافت کند. اطمینان حاصل کنید که تستر دعوت را با همان آدرس ایمیل که دعوت نامه برای آن ارسال شده است ، قبول کند.
اگر قبل از باز کردن برنامه به گواهی توسعه دهنده در دستگاه تست اعتماد نکنید ، خطای توسعه دهنده سازمانی غیر قابل اعتماد ظاهر می شود. در برنامه Settings > Profiles & Screen Management Management ، نام توسعه دهنده برنامه را انتخاب کرده و به آن اعتماد کنید.
هنگامی که سعی می کنید یک برنامه iOS AD-HOC-Provisioned را در iOS 16 یا بعد از آن بدون فعال کردن حالت توسعه دهنده ، خطای مورد نیاز توسعه دهنده ظاهر شود.
برای فعال کردن حالت توسعه دهنده و حل این خطا ، این مراحل را دنبال کنید:
- در آیفون خود ، برنامه تنظیمات را باز کنید و سپس روی حریم خصوصی و امنیت ضربه بزنید.
- به سمت امنیت بروید و روی حالت توسعه دهنده ضربه بزنید.
- روی کشویی حالت توسعه دهنده ضربه بزنید.
- روی Restart ضربه بزنید.
- بعد از راه اندازی مجدد دستگاه ، دستگاه را باز کنید. حالت روشن کننده را روشن کنید؟ گفتگو ظاهر می شود
- روی روشن کردن ضربه بزنید. اکنون می توانید برنامه خود را راه اندازی کرده و آزمایش را شروع کنید.
اگر در حال نصب توزیع موقت هستید ، این پیام زمانی ظاهر می شود که توسعه دهنده هنوز برنامه خود را برای اجرای روی دستگاه تست خود تنظیم نکرده است. برای اینکه برنامه در دسترس شما باشد ، توسعه دهنده باید دستورالعمل های موجود در ثبت دستگاه های اضافی را تکمیل کند.
اگر حساب Google شما به یک برنامه آزمایشی که قبلاً نصب کرده اید دسترسی نداشته باشد (یا دعوت نامه ای را برای آن پذیرفته اید) ، به احتمال زیاد شما به حساب Google اشتباه وارد شده اید. برنامه هایی که به آنها دسترسی دارید با حساب Google که هنگام اولین بار از دعوت برای آزمایش برنامه استفاده کرده اید ، در ارتباط است. با ورود به حساب Google که قبلاً برای پذیرش دعوت استفاده کرده اید ، دوباره امتحان کنید.
هنگامی که با یک خطای 403 روبرو می شوید ، این بدان معنی است که حسابی که استفاده می کنید اجازه نصب و آزمایش برنامه ها را ندارد. دسترسی توسط مدیر دامنه حساب شما در فضای کاری Google تعیین می شود.
اگر فکر می کنید مجوز نصب و آزمایش برنامه ها را دارید ، از مدیر حساب کاربری Google خود بخواهید تا تنظیمات حساب خود را تغییر دهد. مدیر شما باید دستورالعمل های مدیریت دسترسی به خدماتی را که به صورت جداگانه کنترل نمی شوند ، دنبال کنند.
اگر چندین حساب دارید ، سعی کنید با یک حساب کاربری متفاوت وارد شوید که از نصب و آزمایش برنامه ها محدود نیست.
فعال کردن هشدارهای درون برنامه ای با App Distribution iOS SDK
از نکات زیر برای عیب یابی موضوعاتی که شامل فعال کردن هشدارهای جدید در برنامه با استفاده از App Distribution iOS SDK است ، استفاده کنید.
اگر قبلاً App Distribution iOS SDK را در برنامه خود تنظیم کرده اید و آزمایش کنندگان شما هشدارهای درون برنامه ای دریافت نمی کنند ، بررسی کنید تا مطمئن شوید برنامه شما در حال انتشار نسخه های جدید است:
حالت اشکال زدایی را در برنامه خود فعال کنید. برای یادگیری چگونگی ، به مستندات Google Analytics مراجعه کنید.
برنامه خود را در یک شبیه ساز اجرا کنید و رشته "[Firebase/AppDistribution]" را جستجو کنید.
بررسی کنید که تستر به نسخه جدید دسترسی دارد:
اگر یک شیء نسخه معتبر برگردانده شود ، به احتمال زیاد مشکلی در چرخه عمر کنترل مشاهده وجود دارد که قبل از نمایش ، گفتگوی هشدار بارگذاری می شود.
در صورت عدم انتشار ، تستر شما هنوز ممکن است با نسخه جدید همراه نباشد. در داشبورد App Distribution کنسول Firebase ، اطمینان حاصل کنید که تستر شما در توزیع ساخت شما گنجانده شده است و در حالت پذیرفته شده قرار دارد.
اگر تست کننده شما هنوز به روزرسانی نمی کند ، از آنها بخواهید که نکات زیر را دنبال کنند تا مطمئن شوند که دعوت برای آزمایش برنامه شما را پذیرفته اند و دستگاه تست خود را به درستی تنظیم کرده اند:
در دستگاه تست ، وارد کلیپ وب توزیع برنامه Firebase شوید. به یاد داشته باشید که هنگام پذیرش دعوت برای آزمایش برنامه ، حساب Google را که برای اولین بار استفاده کرده اید انتخاب کنید.
اطمینان حاصل کنید که انتشار برنامه جدید در کلیپ وب موجود است.
به طور پیش فرض ، آزمایش کنندگان شما فقط باید یک بار وارد حساب Google خود شوند تا هشدارهای ساخت جدید را فعال کرده و ساختهای جدید را نصب کنند. اگر از آزمایش کنندگان شما خواسته می شود پس از بسته شدن و مجدداً برنامه خود را دوباره وارد کنند ، این نکات را دنبال کنید تا مطمئن شوید که پیکربندی App Distribution شما به درستی تنظیم شده است:
بررسی کنید تا مطمئن شوید که API API APP Firebase را فعال کرده اید. برای اطلاعات بیشتر ، به API تستر توزیع برنامه مراجعه کنید.
تحت محدودیت های کلیدی ، اطمینان حاصل کنید که API API Testers Firebase در لیست API های مجاز قرار دارد.
اگر به طور معمول UserDefaults را در زمینه ورود به سیستم پاک کنید ، ممکن است وضعیت تستر خود را پاک کنید. App Distribution پرچمی را ذخیره می کند که نشان می دهد آیا تستر شما قبلاً وارد برنامه شده است یا خیر. برای اطلاعات بیشتر ، به مخزن GitHub مراجعه کنید.
سوالات متداول
Firebase App Distribution محدودیت های تستر زیر را دارد:
حداکثر 500 آزمایشگر را به یک پروژه Firebase اضافه کنید
حداکثر 200 آزمایش کننده را به یک گروه App Distribution اضافه کنید
برای افزودن آزمایش کننده های بیشتر ، درخواست افزایش بدون هزینه را درخواست کنید.
آزمایش کنندگان 30 روز فرصت دارند تا دعوت نامه ای را برای آزمایش برنامه قبل از انقضا بپذیرند. هنگامی که یک دعوت 5 روز از زمان انقضا است ، یک اعلامیه انقضا در کنسول Firebase در کنار تستر در هنگام انتشار ظاهر می شود. با تغییر مجدد آن از طریق منوی کشویی در ردیف تستر ، می توان یک دعوت را تجدید کرد.
به ثبت نام دستگاه های اضافی مراجعه کنید.
در صورت بروز یکی از شرایط زیر ، انتشار برنامه از App Distribution حذف می شود:
- انتشار برنامه قدیمی تر از 150 روز است.
- شما بیش از حد 1000 برنامه انتشار برنامه هستید و انتشار برنامه قدیمی تر از 1000 نسخه جدید برنامه است.
برای اطلاعات بیشتر ، به App Distribution حداکثر 1000 نسخه پشتیبانی می کند .
پس از رسیدن برنامه یا فراتر از حد انقضا 150 روزه یا حد 1000 برنامه انتشار برنامه ، نسخه از داشبورد App Distribution و برنامه وب تست کننده App Distribution حذف می شود. اگر تستر شما نسخه را نصب کرده است ، نسخه محلی برنامه همچنان اجرا می شود.
برای طولانی نگه داشتن انتشار برنامه ، از یکی از توصیه های زیر استفاده کنید:
- قبل از اتمام انتشار برنامه یا بیش از حد انتشار ، IPA را بارگیری کرده و نسخه را از داشبورد App Distribution حذف کنید. سپس ، IPA را به عنوان ساخت جدید برای App Distribution بارگذاری کنید.
- نسخه را بارگیری کرده و آن را برای بایگانی طولانی مدت در Cloud Storage بارگذاری کنید.
انتشار برنامه پس از 150 روز منقضی می شود
هنگامی که نسخه ای از برنامه خود را در Firebase بارگذاری می کنید ، این نسخه به مدت 150 روز در داشبورد App Distribution ظاهر می شود و از تاریخ بارگذاری شروع می شود. پس از بارگذاری نسخه ، می توانید آن را به آزمایش کنندگان توزیع کنید ، که نسخه را از برنامه Web Tester App Distribution Tester در دستگاه تست خود نصب می کنند.
هنگامی که این نسخه 30 روز از تاریخ انقضا فاصله دارد ، یک اعلان انقضا انتشار برنامه در انتشار شما در صفحه App Distribution کنسول Firebase و در برنامه Web Tester App Distribution ظاهر می شود.
App Distribution از حداکثر 1000 نسخه پشتیبانی می کند
App Distribution حداکثر 1000 نسخه در هر برنامه را فراهم می کند. هنگامی که برنامه شما به حد 1000 برنامه انتشار برنامه رسید ، App Distribution به طور خودکار قدیمی ترین نسخه های بالاتر از حد مجاز را حذف می کند.
اگر می خواهید نسخه های برنامه خود را به صورت دستی مدیریت کنید ، از API REST App Distribution برای لیست و حذف نسخه های برنامه به صورت عمده استفاده کنید.
اگر سوالی دارید ، با پشتیبانی Firebase تماس بگیرید.
نمایه Firebase یک نمایه پیکربندی است که App Distribution اجازه می دهد تا:
دستگاه تست را با جمع آوری شناسه دستگاه منحصر به فرد دستگاه (UDID) ثبت کنید. اگر در حال آزمایش توزیع موقت هستید ، Firebase ایمیلی را که شامل UDID دستگاه تست است ، به همراه دستورالعمل هایی در مورد نحوه قرار دادن دستگاه در نمایه تهیه برنامه ، به توسعه دهنده برنامه ارسال می کند تا ساخت آن بر روی دستگاه شما آزمایش شود.
کلیپ وب Firebase App Distribution را در صفحه اصلی دستگاه خود نصب کنید. کلیپ وب به شما امکان می دهد همه برنامه های تست خود را در یک مکان نصب و دسترسی داشته باشید. ساختهای جدیدی که برای آزمایش دعوت شده اید به طور خودکار به کلیپ وب اضافه می شوند.
برای کمک به نصب پروفایل های پیکربندی در دستگاه iOS خود ، به اسناد اپل مراجعه کنید.
اگر تست کننده هستید ، می توانید با کلیپ وب Firebase App Distribution ، که هنگام نصب نمایه Firebase به طور خودکار به صفحه اصلی دستگاه تست شما اضافه می شود ، به تمام برنامه های تست خود دسترسی پیدا کنید. اگر در حال آزمایش توزیع موقت هستید ، ابتدا باید مشخصات را نصب کنید تا بتوانید برنامه را آزمایش کنید.
اگر در حال آزمایش توزیع شرکت هستید ، می توانید به صورت دستی نمایه را نصب کنید:
اگر قبلاً این کار را نکرده اید ، وارد Google شوید و دعوت را بپذیرید.
در برنامه های تست ، برنامه مورد نظر برای آزمایش را انتخاب کنید.
در سمت راست بالای صفحه برنامه ، روی mobile_screen_share ضربه بزنید.
دستورالعمل های نمایش داده شده را برای نصب پروفایل Firebase دنبال کنید.
برای حذف حساب تستر App Distribution و داده های مرتبط با آن ، این مراحل را به ترتیب دنبال کنید:
به https://appdistribution.firebase.google.com مراجعه کرده و با حساب Google خود وارد شوید.
در بالا سمت راست ، بر روی
کلیک کنید ( مدیریت حساب )حذف حساب
اختیاری: در مجوزهای حساب Google خود ، دسترسی از Firebase App Distribution را لغو کنید. توجه داشته باشید که ابطال دسترسی بدون حذف اولین حساب App Distribution شما ، حساب یا داده های تستر شما را حذف نمی کند .