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