ساختن و آزمایش کردن Android App Bundle

«بسته ترکیبی برنامه Android» روش توصیه‌شده برای ساخت، انتشار، و توزیع برنامه شما در پیکربندی‌های مختلف دستگاه است. بسته‌های برنامه همچنین ویژگی‌های پیشرفته‌ای را فعال می‌کنند، مانند Play Feature Delivery،‏ Play Asset Delivery، و تجربه‌های فوری. چه تازه شروع به استفاده از بسته‌های برنامه کرده باشید یا درحال توسعه برای موارد استفاده پیشرفته‌تر باشید، این صفحه نمای کلی از استراتژی‌های مختلفی را که برای آزمایش برنامه‌تان در هر مرحله از توسعه دردسترس است ارائه می‌دهد.

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

ساختن دسته برنامه بااستفاده از Android Studio

اگر از Android Studio استفاده می‌کنید، می‌توانید با چند کلیک پروژه‌تان را به‌عنوان دسته برنامه امضاشده بسازید. اگر از IDE استفاده نمی‌کنید، می‌توانید دسته برنامه را از خط فرمان بسازید. سپس، دسته برنامه‌تان را در «کنسول Play» بارگذاری کنید تا برنامه‌تان را آزمایش یا منتشر کنید.

برای ساختن دسته‌های برنامه، این مراحل را دنبال کنید:

  1. Android Studio نسخه ۳.۲ یا بالاتر را بارگیری کنید—این ساده‌ترین راه برای افزودن واحدهای ویژگی و ساختن دسته‌های برنامه است.

  2. بااستفاده از Android Studio، یک بسته ترکیبی برنامه Android بسازید. همچنین می‌توانید با اصلاح پیکربندی اجرا/ اشکال‌زدایی و انتخاب گزینه استقرار فایل APK از دسته برنامه، برنامه‌تان را از دسته برنامه در دستگاه متصل‌شده مستقر کنید. به‌یاد داشته باشید که استفاده از این گزینه درمقایسه با ساختن و استقرار فقط APK، به زمان ساخت طولانی‌تری منجر می‌شود.

  3. «بسته ترکیبی برنامه Android» خود را بااستفاده از آن برای تولید فایل‌های APK که در دستگاه مستقر می‌کنید، مستقر کنید.

  4. در «امضای برنامه» Play ثبت‌نام کنید. درغیراین‌صورت، نمی‌توانید دسته برنامه‌تان را در «کنسول Play» بارگذاری کنید.

  5. دسته برنامه‌تان را در Google Play منتشر کنید.

پیاده‌سازی بااستفاده از دسته‌های برنامه با «استودیو Android»

می‌توانید برنامه‌تان را به‌عنوان «بسته ترکیبی برنامه Android» بسازید و آن را مستقیماً از IDE در دستگاه متصل‌شده مستقر کنید. چون IDE و Google Play از ابزارهای یکسانی برای استخراج و نصب APK در دستگاه استفاده می‌کنند، این راهبرد آزمایش محلی به شما کمک می‌کند موارد زیر را تأیید کنید:

  • می‌توانید برنامه‌تان را به‌صورت دسته برنامه بسازید.
  • IDE می‌تواند فایل‌های APK را برای پیکربندی دستگاه هدف از دسته برنامه استخراج کند.
  • ویژگی‌هایی که به واحدهای ویژگی تقسیم می‌کنید با واحد پایه برنامه‌تان سازگار است.
  • برنامه‌تان در دستگاه هدف طبق انتظار شما کار می‌کند.

به‌طور پیش‌فرض، وقتی برنامه‌تان را از Android Studio در دستگاه متصل‌شده‌ای مستقر می‌کنید، IDE فایل‌های APK را برای پیکربندی دستگاه هدف می‌سازد و مستقر می‌کند. دلیلش این است که ساختن APK برای پیکربندی دستگاهی خاص سریع‌تر از ساختن دسته برنامه برای همه پیکربندی‌های دستگاهی است که برنامه‌تان پشتیبانی می‌کند.

اگر می‌خواهید ساختن برنامه‌تان را به‌عنوان بسته برنامه آزمایش کنید و سپس فایل‌های APK را از آن بسته برنامه در دستگاه متصل‌شده‌تان مستقر کنید، باید پیکربندی پیش‌فرض «اجرا/ اشکال‌زدایی» را به‌صورت زیر ویرایش کنید:

  1. اجرا > ویرایش پیکربندی‌ها را از نوار منو انتخاب کنید.
  2. پیکربندی اجرا/ اشکال‌زدایی را از قاب سمت راست انتخاب کنید.
  3. در قاب سمت چپ، برگه عمومی را انتخاب کنید.
  4. APK از دسته برنامه را از منو کنار استقرار انتخاب کنید.
  5. اگر برنامه‌تان شامل تجربه برنامه فوری است که می‌خواهید آن را آزمایش کنید، چارگوش کنار استقرار به‌عنوان برنامه فوری را علامت بزنید.
  6. اگر برنامه‌تان شامل واحد ویژگی است، می‌توانید با علامت زدن چارگوش کنار هر واحد، واحدهایی را که می‌خواهید مستقر کنید انتخاب کنید. به‌طور پیش‌فرض، Android Studio همه واحدهای ویژگی را مستقر می‌کند و همیشه واحد برنامه پایه را مستقر می‌کند.
  7. روی اعمال یا تأیید کلیک کنید.

وقتی اجرا > اجرا را از نوار منو انتخاب می‌کنید، Android Studio یک دسته برنامه می‌سازد و از آن برای استقرار فقط APKهای موردنیاز دستگاه متصل‌شده و واحدهای ویژگی‌ای که انتخاب کرده‌اید استفاده می‌کند.

ساختن و آزمایش کردن از خط فرمان

ابزارهایی که Android Studio و Google Play برای ساختن دسته برنامه‌تان و تبدیل آن به فایل‌های APK استفاده می‌کنند ازطریق خط فرمان دردسترس شما است. یعنی می‌توانید این ابزارها را از خط فرمان فراخوانی کنید تا برنامه‌تان را به‌صورت محلی از «بسته ترکیبی برنامه Android» بسازید و مستقر کنید.

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

  • ادغام کردن ساخت‌های قابل‌پیکربندی دسته‌های برنامه در سرور «ادغام مداوم» (CI) یا محیط ساخت سفارشی دیگر.
  • خودکارسازی استقرار برنامه‌تان از دسته برنامه به یک یا چند دستگاه آزمایشی متصل.
  • شبیه‌سازی بارگیری‌های برنامه‌تان از Google Play در دستگاه متصل‌شده.

ساختن دسته برنامه از خط فرمان

اگر می‌خواهید بسته برنامه‌تان را از خط فرمان بسازید، می‌توانید این کار را بااستفاده از bundletool یا افزونه Android Gradle انجام دهید.

افزایه Android Gradle: این افزایه که توسط Google نوشته شده است، همراه با Android Studio ارائه می‌شود و به‌عنوان مخزن Maven نیز دردسترس است. افزونه فرمان‌هایی را تعریف می‌کند که می‌توانید از خط فرمان برای ساختن دسته برنامه اجرا کنید. درحالی‌که افزونه آسان‌ترین روش برای ساختن دسته برنامه شما را ارائه می‌دهد، باید از bundletool برای استقرار برنامه‌تان در دستگاه آزمایشی استفاده کنید.

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

برای شروع ساختن دسته برنامه‌تان با هریک از این رویکردها، ساختن برنامه از خط فرمان را بخوانید.

برنامه‌تان را از خط فرمان مستقر کنید

اگرچه افزونه Android Gradle آسان‌ترین راه برای ساختن دسته برنامه از خط فرمان است، باید از bundletool برای استقرار برنامه‌تان از دسته برنامه به دستگاه متصل‌شده استفاده کنید. دلیلش این است که bundletool فرمان‌هایی ارائه می‌دهد که به‌طور خاص برای کمک به شما در آزمایش کردن دسته برنامه‌تان و شبیه‌سازی توزیع ازطریق Google Play طراحی شده‌اند.

در زیر انواع مختلف سناریوهایی که می‌توانید برای استفاده از bundletool آزمایش کنید آورده شده است:

  • مجموعه APK تولید کنید که شامل APK جداشده برای همه پیکربندی‌های دستگاهی باشد که برنامه‌تان پشتیبانی می‌کند. معمولاً قبل‌از اینکه bundletool بتواند برنامه‌تان را در دستگاه متصل‌شده‌ای مستقر کند، باید مجموعه APK ساخته شود.
    • اگر نمی‌خواهید مجموعه‌ای از همه APKهای جداشده برنامه‌تان بسازید، می‌توانید مجموعه‌ای از APKهای مختص دستگاه براساس دستگاه متصل‌شده یا JSON مشخصات دستگاه تولید کنید.
  • برنامه‌تان را از مجموعه APK در دستگاه متصل‌شده مستقر کنید. bundletool از adb برای تعیین APKهای جداشده موردنیاز برای هر پیکربندی دستگاه استفاده می‌کند و فقط آن APKها را در دستگاه مستقر می‌کند. اگر چند دستگاه دارید، می‌توانید شناسه دستگاه را نیز به bundletool ارسال کنید تا دستگاه خاصی را هدف‌یابی کنید.
  • گزینه‌های ارسال ویژگی را به‌صورت محلی آزمایش کنید. می‌توانید از bundletool برای شبیه‌سازی بارگیری و نصب واحدهای ویژگی از Google Play در دستگاهتان استفاده کنید، بدون اینکه واقعاً برنامه‌تان را در «کنسول Play» منتشر کنید. این کار زمانی مفید است که بخواهید به‌صورت محلی آزمایش کنید که برنامه‌تان چگونه درخواست‌های بارگیری و خطاهای ماژول درخواستی را مدیریت می‌کند.
  • اندازه بارگیری برنامه‌تان را برای پیکربندی دستگاه موردنظر برآورد کنید. این کار برای درک بهتر تجربه کاربری بارگیری برنامه‌تان و بررسی اینکه آیا برنامه‌تان محدودیت حجم بارگیری فشرده برای بسته‌های برنامه را رعایت می‌کند یا فعال کردن تجربه‌های فوری مفید است.

دسته برنامه‌تان را در Play آزمایش کنید

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

از «کنسول Play» برای آزمایش برنامه‌تان به‌دلایل زیر استفاده کنید:

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

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

درحالی‌که دسته‌های آزمایشی «کنسول Play» روشی برای پیشبرد برنامه شما در مراحل رسمی آزمایش ارائه می‌دهند، گاهی اوقات می‌خواهید به‌سرعت برنامه‌تان را با آزمایش‌کنندگان معتمد ازطریق کانال‌های غیررسمی‌تر، مانند ایمیل یا پیامک، هم‌رسانی کنید.

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

  • به هر فردی در تیمتان اجازه دهید تا نسخه‌های آزمایشی را بارگذاری کند، بدون اینکه به آن‌ها دسترسی به برنامه‌تان در «کنسول Play» بدهید.
  • آزمایش‌گران فقط به نسخه آزمایشی خاصی از برنامه شما که با آن‌ها هم‌رسانی شده است دسترسی پیدا می‌کنند.
  • ساخت‌های آزمایشی را می‌توان با هر کلیدی امضا کرد یا اصلاً امضا نکرد، بنابراین بارگذارندگان هم نیازی به دسترسی به کلید تولید یا بارگذاری شما ندارند.
  • کدهای نسخه لازم نیست منحصربه‌فرد باشند، بنابراین می‌توانید از کد نسخه موجود مجدداً استفاده کنید و نیازی نیست آن را برای بارگذاری افزایش دهید.
  • گزینه‌های سفارشی ارسال را آزمایش کنید، مثلاً بارگیری ویژگی‌ها به‌صورت درخواستی و به‌روزرسانی‌های درون‌برنامه‌ای.
  • با هم‌رسانی نسخه قابل‌اشکال‌زدایی برنامه‌تان، داده‌ها و گزارش‌های مهم را ضبط کنید.

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

بارگیری نسخه‌های قدیمی برنامه‌تان

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

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

https://play.google.com/apps/test/package-name/version-code

بارگذاری برنامه در دسته هدف آزمایشی

وقتی برنامه‌تان را بارگذاری می‌کنید و نسخه پخشی در «کنسول Play» ایجاد می‌کنید، می‌توانید نسخه پخش را قبل‌از ارسال به مرحله تولید، ازطریق چند مرحله آزمایشی پیش ببرید:

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

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

استفاده کردن از گزارش‌های پیش‌از راه‌اندازی برای شناسایی مشکلات

وقتی بسته برنامه یا APK را در دسته هدف باز یا بسته بارگذاری می‌کنید، می‌توانید مشکلات را برای طیف وسیعی از دستگاه‌هایی که نسخه‌های مختلف Android را اجرا می‌کنند شناسایی کنید.

گزارش پیش‌از راه‌اندازی در «کنسول Play» به شما کمک می‌کند مشکلات احتمالی را در موارد زیر شناسایی کنید:

  • پایداری
  • سازگاری Android
  • عملکرد
  • دسترس‌پذیری
  • آسیب‌پذیری‌های امنیتی

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

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

مرور و بارگیری APK برای پیکربندی‌های خاص دستگاه

وقتی دسته برنامه‌تان را بارگذاری می‌کنید، «کنسول Play» به‌طور خودکار APK جداشده و چند APK برای همه پیکربندی‌های دستگاهی که برنامه‌تان پشتیبانی می‌کند تولید می‌کند. در «کنسول Play»، می‌توانید از جدیدترین نسخه‌های پخش و بسته‌ها برای دیدن همه مصنوعات APK که Google Play تولید می‌کند، بررسی داده‌هایی مثل دستگاه‌های پشتیبانی‌شده و پیکربندی ارائه برنامه‌تان، و بارگیری APKهای تولیدشده برای استقرار و آزمایش محلی استفاده کنید.

برای کسب اطلاعات بیشتر، موضوع راهنمای «کنسول Play» را درباره بررسی جزئیات دسته برنامه بخوانید.

آزمایش کردن دسته برنامه با Firebase App Distribution

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

«توزیع برنامه» به شما امکان می‌دهد همه نسخه‌های ساخت پیش‌انتشار خود را در یک مرکز متمرکز مدیریت کنید و به شما انعطاف‌پذیری می‌دهد تا این نسخه‌های ساخت را مستقیماً از کنسول یا بااستفاده از ابزارهای خط فرمان که قبلاً بخشی از گردش کار شما هستند توزیع کنید.

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