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

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

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

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

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

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

اگر به‌طور مکرر با خطاهای ۴۰۰، ۴۰۹، یا ۵۰۰ درطول آماده‌سازی مواجه شدید، با پشتیبانی Firebase تماس بگیرید. با شماره پروژه Firebase و شناسه برنامه خود پشتیبانی ارائه دهید.

فایل APK بارگذاری نشد

1. اندازه APK را به‌تأیید برسانید. حداکثر حد اندازه فایل برای همه فایل‌های باینری ‫۲۰۴۸ مگابایت است که کمی بیشتر از ۲ گیگابایت است.

2. اگر اندازه APK در محدوده اندازه فایل است و قابل‌تولید مجدد است، با پشتیبانی Firebase تماس بگیرید.

‫APK با fastlane بارگذاری نشد. ‫APK امضا نشده است.

تأیید کنید که APK بااستفاده از موارد زیر امضا شده است:

apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk

دریافت خطا با ورود به سیستم اجتماعی/ارائه‌دهندگان API طرف سوم

وقتی AAB را در App Distribution بارگذاری می‌کنید، Google Play به‌طور خودکار فایل APK تولیدشده را بااستفاده از گواهینامه کلید امضای برنامه آزمایشی مجدداً امضا می‌کند. درصورت درخواست، اگر می‌خواهید به استفاده از سرویس‌های طرف سوم آن‌ها ادامه دهید، باید برنامه‌تان را در ارائه‌دهندگان میانای برنامه‌سازی کاربردی ثبت کنید. پس‌از امضا شدن، گواهینامه آزمایشی برنامه‌تان را می‌توانید در کنسول Firebase مشاهده کنید.

آیا AABهایی که بارگذاری می‌کنم در Google Play هم نشان داده می‌شود؟

ساختمان‌های AAB که در App Distribution بارگذاری می‌کنید در حساب توسعه‌دهنده Google Play شما نشان داده نمی‌شود (این شامل «کاشف دسته برنامه» و هم‌رسانی داخلی برنامه می‌شود).

اگر پیوند Firebase را از Google Play لغو کنم چه اتفاقی می‌افتد؟

اگر پیوند «برنامه Android Firebase» از Google Play لغو شود، موارد زیر اتفاق می‌افتد:

• نمی‌توانید دسته‌های برنامه جدید را در App Distribution بارگذاری کنید و آن‌ها را ازطریق ادغام App Distribution با Google Play به Google Play صادر کنید.

• ساخت‌های موجود همچنان در داشبورد Firebase App Distribution و برای آزمایش‌گران شما دردسترس خواهند بود.

• هر داده‌ای که قبلاً بین Firebase و Google Play صادر شده باشد در هر دو محصول دردسترس باقی خواهد ماند.

آیا می‌توانم پیوند دادن برنامه به Google Play را دوباره امتحان کنم؟

برای توزیع «بسته برنامه Android»‏ (AAB) ازطریق App Distribution و پیوند دادن خودکار AABهای بارگذاری‌شده به پروژه Firebase و حساب توسعه‌دهنده Google Play، مطمئن شوید که شرایط زیر را دارید:

• حساب توسعه‌دهنده Google Play شما یکی از سطوح دسترسی زیر را داشته باشد: مالک یا سرپرست.

• برای پروژه Firebase خود، یکی از نقش‌های زیر را دارید: مالک یا سرپرست Firebase.

• برنامه‌تان در Firebase و حساب توسعه‌دهنده Google Play شما ثبت شده باشد. این یعنی هم برنامه Firebase Android و هم برنامه Google Play دارید.

• برنامه موجود در Google Play و برنامه Firebase Android هر دو بااستفاده از نام بسته یکسان ثبت شده باشند.

• برنامه در Google Play در داشبورد برنامه راه‌اندازی شده باشد و در یکی از دسته‌های هدف Google Play (آزمایش داخلی، آزمایش بسته، آزمایش باز، یا تولید) توزیع شده باشد.

• مرور برنامه در Google Play تکمیل شده باشد و برنامه منتشر شده باشد. اگر ستون وضعیت برنامه یکی از وضعیت‌های زیر را نشان دهد، برنامه شما منتشر شده است: آزمایش داخلی (نه آزمایش داخلی پیش‌نویس)، آزمایش بسته، آزمایش باز، یا «دسته هدف تولید».

اگر برنامه‌ای را بارگذاری کرده‌اید که قبلاً معیارهای ذکرشده در بالا را برای پیوند دادن برآورده نمی‌کرد، اما اکنون برآورده می‌کند، می‌توانید دوباره برنامه Android خود را در Firebase به Google Play پیوند دهید.

آزمونگر حساب 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. در پایین روی مدیریت تنظیمات ایمیل کلیک کنید و برای اشتراک مجدد روی اجازه دادن به ایمیل‌ها کلیک کنید.

راهکار ۲

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

راه‌حل ۳

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

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

برنامه نشان نمی‌دهد که نصب شده است

اگر آزمایش‌گری نسخهٔ پخشی را بارگیری و نصب کند اما میانای کاربر جزئیات برنامه نشان ندهد که برنامه نصب شده است، این یک مشکل شناخته‌شده است. در برخی موارد، شناسه دسته‌ای در برنامه Firebase با شناسه دسته APK مطابقت ندارد.

تأیید کنید که شناسه بسته APK با شناسه بسته برنامه Firebase که برای بارگذاری توزیع استفاده کرده‌اید مطابقت داشته باشد.

هشدار Android که می‌گوید دستگاه من نمی‌تواند برنامه‌های ناشناس را نصب کند

اگر برنامه یا مرورگر درحال اجرا هنوز اجازه نصب برنامه‌ها از خارج از Google Play را دریافت نکرده باشد، هشدار Android نشان داده می‌شود. برای اعطای اجازه:

• نسخه Android 8 یا بالاتر: در برنامه تنظیمات، روی اجازه دادن از این منبع تک‌ضرب بزنید.

• نسخه ۷ یا قدیمی‌تر Android: در برنامه تنظیمات، روی امنیت تک‌ضرب بزنید و منابع ناشناس را انتخاب کنید. وقتی پیام‌واره ظاهر شد، روی تأیید > اعتماد تک‌ضرب بزنید.

فایل‌های APK آزمایشی نصب نمی‌شوند

اگر فایل APK آزمایشی در دستگاه آزمایشگر نصب نشود:

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

نمی‌توان به سیستم «برنامه آزمایش‌کننده برنامه Android» وارد شد

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

برای برداشتن تنظیمات محدودیت:

1. در برگه برنامه‌ها در Google Workspace، مطمئن شوید Firebase App Distribution روی دسترسی: مسدودشده تنظیم نشده باشد.

2. در برگه خدمات، مطمئن شوید که Cloud Platform بدون محدودیت باشد.

3. پس‌از برداشته شدن تنظیمات، دوباره به سیستم وارد شوید.

خطا هنگام نصب AAB: «برنامه نصب نشد»

این خطا زمانی رخ می‌دهد که برنامه درحال نصب با برنامه‌ای که ازقبل در دستگاه نصب شده است تداخل داشته باشد. برای مثال، ممکن است گونه‌ای متفاوت از همان برنامه با همان اجازه سفارشی یا نام ContentProvider باشد.

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

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

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

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

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

آزمایش در دستگاه Android جدید

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

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

1. در دستگاه Android، به appdistribution.firebase.google.com بروید.

2. با حساب آزمایشگر موجودتان به سیستم وارد شوید و روی دکمه بارگیری برنامه آزمایشگر در پایین صفحه کلیک کنید تا برنامه «آزمایشگر برنامه Android» نصب شود.

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

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

1. گزارش‌گیری مفصل را برای «کیت توسعه نرم‌افزار Android» App Distribution در برنامه‌تان فعال کنید:

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

2. با فیلتر کردن «FirebaseAppDistribution»، پیام‌های خطا را در گزارش‌های برنامه بررسی کنید.

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

   1. اگر گزارش‌ها نشان می‌دهد که «آزمونگر به این منبع دسترسی ندارد»، ممکن است آزمونگر به برنامه دعوت نشده باشد یا به نسخه دسترسی نداشته باشد.

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

   اگر هنوز بازخورد دریافت نمی‌کنید، این مراحل را دنبال کنید:

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

   2. برنامه را دوباره بااستفاده از «آزمونگر برنامه» یا برنامه وب آزمایشی نصب کنید تا مطمئن شوید آزمونگر به نسخه پخش دسترسی دارد.

   3. دوباره بازخورد ارسال کنید و مطمئن شوید که با همان «حساب Google» به سیستم وارد شده‌اید.

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

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

بازخوردهای ارسال‌شده در برنامه دریافت نمی‌شود

1. اگر هنگام ارسال بازخورد این پیام را دیدید، «بازخورد ارسال می‌شد، اما به‌دلیل حالت توسعه‌دهنده ارسال نشد»، حالت توسعه‌دهنده را با اجرای این فرمان در دستگاه غیرفعال کنید:

   adb shell setprop debug.firebase.appdistro.devmode false
   

2. فایل google-services.json را بررسی کنید تا مطمئن شوید بازخورد را برای پروژه و برنامه صحیح ارسال می‌کنید.

3. گزارش‌گیری مفصل را برای «کیت توسعه نرم‌افزار Android» App Distribution در برنامه‌تان فعال کنید:

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

4. با فیلتر کردن برای «FirebaseAppDistribution»، پیام‌های خطا را در گزارش‌های برنامه بررسی کنید.

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

اگر قبلاً App Distribution «کیت توسعه نرم‌افزار Android» را در برنامه‌تان راه‌اندازی کرده‌اید و آزمایش‌گران شما هشدارهای درون‌برنامه را دریافت نمی‌کنند، این مراحل را دنبال کنید:

1. با پیوست کردن OnFailureListener به «تکلیف» برگردانده‌شده توسط Firebase App Distribution API، پیام‌های خطا را بررسی کنید.

   Java

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> {
                     if (e instanceof FirebaseAppDistributionException) {
                        // Log exception here
                     }});
   

   Kotlin

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e ->
                     if (e is FirebaseAppDistributionException) {
                        // Log exception here
                     }
     }
   

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

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

   2. برنامه‌تان را در شبیه‌ساز اجرا کنید و رشته «FirebaseAppDistribution» را جستجو کنید.

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

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

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

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

      2. بررسی کنید نسخه پخش جدید برنامه در «آزمونگر برنامه» یا برنامه وب آزمونگر دردسترس باشد.

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

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

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

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

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

چگونه به عامل «آزمایش برنامه» دسترسی پیدا کنم؟

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

اگر برنما را رد کرده‌اید، به برگه «موارد آزمایشی» پیمایش کنید تا برنما را در آنجا پیدا کنید. مالک اجازه خواهد داشت کل پروژه را موافقت کند.

اگر همچنان در موافقت با ویژگی مشکل دارید، با پشتیبانی Firebase تماس بگیرید و این پیام را ارسال کنید: «درخواست دسترسی به نماینده «آزمایش برنامه» App Distribution».

آیا موافقت کردن با این ویژگی آن را برای کل تیم من فعال می‌کند یا فقط برای من؟

با این کار، این ویژگی برای کل پروژه شما فعال خواهد شد.

موافقت کردم اما هنوز ویژگی را نمی‌بینم

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

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

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

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

آیا عامل «آزمایش برنامه» از برنامه‌های Flutter پشتیبانی می‌کند؟

بله، عامل «آزمایش برنامه» از برنامه‌های Android که بااستفاده از Flutter ساخته شده‌اند پشتیبانی می‌کند.

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

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

حدود تلاش مجدد سهمیه برای آزمایش‌های خزنده تصادفی با عامل «آزمایش برنامه» چیست؟

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

برای استفاده از عامل «آزمایش برنامه» به چه اجازه‌هایی نیاز دارم؟

اگر از مخزن پیش‌فرض Google Cloud Storage (GCS) استفاده می‌کنید، باید نقش ویرایشگر را در پروژه Firebase داشته باشید.

اگر از یک مخزن سفارشی استفاده می‌کنید، نیازی به نقش «ویرایشگر» ندارید. درعوض، به نقشی نیاز دارید که حاوی اجازه‌های زیر باشد:

• Firebase Quality Admin
• Firebase Test Lab Admin
• کاربر شیء فضای ذخیره‌سازی

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

مهلت زمانی برای آزمایش‌های عامل «آزمایش برنامه» چقدر است؟

آزمایش‌های هدایت‌شده با هوش مصنوعی زمان اتمام ۵ دقیقه دارند و آزمایش‌های خزنده تصادفی زمان اتمام ۱۰ دقیقه دارند.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

وقتی ۳۰ روز به تاریخ انقضای نسخهٔ پخش باقی می‌ماند، اعلان انقضای نسخهٔ پخش برنامه در نسخهٔ پخش شما در برنامه «آزمایش‌گر برنامه Firebase» نشان داده می‌شود.

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

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

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

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

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

اگر آزمایش‌گر هستید، توصیه می‌کنیم Firebase App Tester را بارگیری کنید، برنامه‌ای که به شما امکان می‌دهد در یک مکان به همه ساخت‌های آزمایشی‌تان دسترسی داشته باشید.

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

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

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

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

   حذف حساب.

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