این راهنما نحوه بارگذاری کردن Android App Bundle (AAB) در App Distribution و توزیع کردن APKهای تولیدشده بااستفاده از کنسول Firebase را شرح میدهد.
App Distribution با سرویس همرسانی برنامه داخلی Google Play ادغام میشود تا AABهایی را که بارگذاری میکنید پردازش کند و APKهایی را که برای پیکربندیهای دستگاه آزمایشکنندگان شما بهینهسازی شدهاند ارائه دهد. توزیع کردن «بستههای برنامه Android» به شما امکان میدهد کارهای زیر را انجام دهید:
فایلهای APK بهینهشده (ارائهشده توسط Google Play) را که برای دستگاههای آزمایشکنندگان شما بهینهسازی شدهاند اجرا کنید.
مشکلات مختص دستگاه را شناسایی و اشکالزدایی کنید.
ویژگیهای بسته برنامه را آزمایش کنید، مثل ویژگی تحویل Play و ارائه داراییهای Play.
اندازه بارگیریها را برای آزمایشکنندگان کاهش دهید.
مجوزهای لازم
برای بارگذاری کردن AAB در App Distribution، باید برنامه Firebase خود را به برنامهای در Google Play پیوند دهید. برای انجام این کنشها باید سطح دسترسی لازم را داشته باشید.
اگر دسترسی لازم به Firebase را ندارید، میتوانید از «مالک» پروژه Firebase بخواهید بااستفاده از Firebase تنظیمات IAM کنسول، نقش مربوطه را به شما اختصاص دهد. اگر درباره دسترسی به پروژه Firebase خود سؤالی دارید، ازجمله پیدا کردن یا اختصاص دادن «مالک»، پرسشگان «اجازهها و دسترسی به پروژههای Firebase» را مرور کنید.
جدول زیر برای پیوند دادن برنامه Firebase به برنامه در Google Play و همچنین بارگذاری AAB اعمال میشود.
| کنش در کنسول Firebase | اجازه IAM لازم | نقش(های) IAM که بهطور پیشفرض شامل اجازههای لازم است | نقش(های) الزامی دیگر |
|---|---|---|---|
| پیوند دادن برنامه Firebase به برنامهای در Google Play | firebase.playLinks.update
|
یکی از نقشهای زیر: | دسترسی به حساب توسعهدهنده Google Play بهعنوان سرپرست |
| بارگذاری کردن بستههای برنامه Android در App Distribution | firebaseappdistro.releases.update
|
یکی از نقشهای زیر: | –– |
قبل از شروع
اگر قبلاً این کار را نکردهاید، Firebase را به پروژه Android خود اضافه کنید. در پایان این گردش کار، یک «برنامه Android Firebase» در پروژه Firebase خود خواهید داشت.
اگر از هیچ محصول Firebase دیگری استفاده نمیکنید، فقط باید پروژهای ایجاد کنید و برنامهتان را ثبت کنید. اگر تصمیم گرفتید از محصولات دیگری استفاده کنید، حتماً همه مراحل افزودن Firebase به پروژه Android را تکمیل کنید.
صفحه App Distribution را در کنسول Firebase باز کنید. وقتی از شما خواسته شد، پروژه Firebase خود را انتخاب کنید، برنامهتان را بااستفاده از تعویضکننده برنامه انتخاب کنید، و روی شروع به کار کلیک کنید.
برای ایجاد پیوند Firebase به Google Play و بارگذاری کردن AAB، مطمئن شوید که برنامهتان الزامات زیر را برآورده میکند:
برنامه در Google Play و برنامه Android در Firebase هر دو بااستفاده از یک نام بسته ثبت شدهاند.
برنامه در Google Play در داشبورد برنامه راهاندازی شده است و در یکی از دستههای هدف Google Play (آزمایش داخلی، آزمایش بسته، آزمایش باز، یا تولید) توزیع شده است.
بررسی برنامه در Google Play تکمیل شده و برنامه منتشر شده است. اگر ستون وضعیت برنامه یکی از وضعیتهای زیر را نشان دهد، برنامهتان منتشر شده است: «آزمایش داخلی» (نه «آزمایش داخلی پیشنویس»)، «آزمایش بسته»، «آزمایش باز»، یا «تولید».
پیوند دادن برنامه Android در Firebase به حساب توسعهدهنده Google Play:
در کنسول Firebase، به
تنظیمات پروژه بروید، سپس برگه ادغامها را انتخاب کنید.در کارت Google Play، روی پیوند کلیک کنید.
اگر ازقبل پیوندهایی به Google Play دارید، روی مدیریت کلیک کنید.دستورالعملهای روی صفحه را برای فعال کردن ادغام App Distribution دنبال کنید و انتخاب کنید کدام «برنامههای Android» در Firebase به Google Play پیوند داده شوند.
درباره پیوند دادن به Google Play بیشتر بدانید.
مرحله ۱. برنامهتان را بسازید
وقتی آماده بودید نسخه پیشانتشار برنامهتان را بین آزمایشگران توزیع کنید، AAB خود را بسازید (برای دستورالعملها به اسناد Android Studio مراجعه کنید).
مشاهده کنید.مرحله ۲. توزیع برنامه برای آزمایشکنندگان
برای توزیع برنامهتان بین آزمایشکنندگان، فایل AAB خود را بااستفاده از کنسول Firebase بارگذاری کنید:
صفحه App Distribution را در کنسول Firebase باز کنید. وقتی از شما خواسته شد، پروژه Firebase خود را انتخاب کنید.
در صفحه نسخههای پخش، برنامهای را که میخواهید توزیع کنید از منوِ کرکرهای انتخاب کنید.
فایل AAB برنامهتان را به کنسول بکشید تا بارگذاری شود.
وقتی بارگذاری تکمیل شد، گروههای آزمونگر و آزمونگرهای تکی را که میخواهید نسخه ساخت را دریافت کنند مشخص کنید. سپس، یادداشتهای انتشار را برای ساخت اضافه کنید.
برای اطلاعات بیشتر درباره ایجاد گروههای آزمایشکننده، به مدیریت آزمایشکنندگان مراجعه کنید.
روی توزیع کلیک کنید تا ساخت برای آزمایشگران دردسترس قرار گیرد. آزمایشکننده بهطور خودکار دعوتنامهای ازطریق ایمیل برای آزمایش برنامه دریافت میکند.
(اختیاری) برای همرسانی پیوندهای نسخههای پخش خاص با آزمایشکنندگانی که به آن نسخههای پخش دسترسی دارند، روی نماد پیوند کلیک کنید تا پیوند نسخه پخش در بریدهدان کپی شود.
وقتی ساختتان را توزیع میکنید، بهمدت ۱۵۰ روز (پنج ماه) در داشبورد App Distribution کنسول Firebase دردسترس قرار میگیرد. وقتی ۳۰ روز به انقضای ساخت باقی مانده باشد، اعلان انقضا هم در کنسول و هم در فهرست ساختهای آزمایشکننده در دستگاه آزمایشی او نشان داده میشود.
آزمایشگرانی که برای آزمایش برنامه دعوت نشدهاند، دعوتنامههای ایمیلی برای شروع دریافت میکنند و آزمایشگران فعلی اعلانهای ایمیلی دریافت میکنند که ساخت جدیدی برای آزمایش آماده است. برای دستورالعملهای نحوه نصب برنامه آزمایشی، به راهاندازی بهعنوان آزمونگر با App Distribution مراجعه کنید. میتوانید وضعیت هر آزمایشکننده را (اینکه دعوت را پذیرفته است یا نه و اینکه برنامه را بارگیری کرده است یا نه) در کنسول Firebase پایش کنید.
آزمونگران ۳۰ روز فرصت دارند تا دعوت آزمایش برنامه را قبلاز منقضی شدن آن بپذیرند. وقتی ۵ روز به انقضای دعوت باقی مانده باشد، اعلان انقضا در کنسول Firebase در کنار آزمایشکننده در نسخه پخششده ظاهر میشود. دعوت را میتوان با ارسال مجدد آن بااستفاده از منوِ کرکرهای در ردیف آزمایشکننده تمدید کرد.
مراحل بعدی
بازخورد درونبرنامه را پیادهسازی کنید تا آزمایشکنندگان بتوانند بهراحتی درباره برنامهتان بازخورد (ازجمله نماگرفت) ارسال کنند.
با نحوه نمایش هشدارهای درونبرنامه به آزمونگران خود هنگام دردسترس بودن نسخههای ساخت جدید برنامهتان برای نصب آشنا شوید.
با روالهای مطلوب برای توزیع برنامههای Android بین آزمایشکنندگان تضمین کیفیت بااستفاده از CI/CD آشنا شوید.