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

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

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

«نتوانستیم ایمیل تماسی برای برنامه <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 و پیوند دادن خودکار «دسته‌های برنامه Android» بارگذاری‌شده به پروژه 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» با نشانی ایمیل متفاوت مراجعه کنید.

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

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

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

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

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 نسخه ۸ یا بالاتر: در برنامه تنظیمات، روی مجاز کردن از این منبع تک‌ضرب بزنید.

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

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

اگر APK آزمایشی در دستگاه آزمایش‌کننده نصب نشد:

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

نمی‌توان به سیستم برنامه Android App Tester وارد شد

اگر برنامه App Tester مانع از ورود شما به سیستم می‌شود و شما را به صفحه ورود به سیستم هدایت می‌کند، ممکن است از 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 App Testers API را فعال کرده باشید. برای اطلاعات بیشتر، به فعال کردن App Distribution Tester API مراجعه کنید.

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

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

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»، گزارش‌های برنامه‌تان را برای یافتن پیام‌های خطا بررسی کنید.

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

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

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

   جاوا

     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. در دستگاه آزمایشی، بااستفاده از App Tester یا برنامه وب آزمونگر به سیستم Firebase App Distribution وارد شوید. حتماً همان «حساب Google» را انتخاب کنید که برای اولین‌بار هنگام پذیرفتن دعوت برای آزمایش برنامه استفاده کردید.

      2. بررسی کنید تا مطمئن شوید نسخه جدید برنامه در App Tester یا برنامه وب آزمایش‌کننده دردسترس است.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

آیا «عامل آزمایش برنامه» از برنامه‌های 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 App Tester برداشته می‌شود. اگر آزمونگر شما انتشار را نصب کرده باشد، نسخه محلی برنامه همچنان اجرا می‌شود.

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

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

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

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

وقتی ۳۰ روز به تاریخ انقضای نسخه پخش باقی مانده باشد، اعلان انقضای نسخه پخش برنامه در نسخه پخش شما در برنامه Firebase App Tester ظاهر می‌شود.

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 باعث حذف حساب یا داده‌های آزمونگر شما نمی‌شود.