صادر کردن پروژه‌های Godot به Android

این سند نحوه صادر کردن پروژه Godot را به‌عنوان برنامه Android شرح می‌دهد. Godot می‌تواند هم فایل‌های APK برای آزمایش دستگاه محلی و هم Android App Bundle برای ارسال به «فروشگاه Google Play» تولید کند.

نصب الگوی ساخت Android

Godot از الگوی ساخت به‌عنوان نقطه شروع برای تولید فایل‌های Gradle و دیگر داده‌های لازم برای ایجاد و ساخت برنامه Android استفاده می‌کند. الگوی ساخت باید پیش‌از صادر کردن ساخت Android به پروژه Godot وارد شود. هر نسخه از Godot الگوی خودش را دارد. برای نصب الگوی ساخت Android در پروژه، مراحل زیر را انجام دهید:

  1. پروژه را در ویرایشگر Godot باز کنید.
  2. در نوار منو، Project -> Install Android Build Template…‎ (پروژه -> نصب الگوی ساخت Android…) را انتخاب کنید
  3. روی دکمه مدیریت الگوها… کلیک کنید.
  4. در پنجره مدیر الگوی صادر کردن، روی دکمه بارگیری برای نسخه Godot مورداستفاده (نسخه کنونی) کلیک کنید.
  5. مکان آینه‌ای را برای بارگیری فایل انتخاب کنید.
  6. پس‌از تکمیل بارگیری، روی دکمه بستن در پنجره مدیر صادر کردن الگو کلیک کنید.
  7. از نوار منو ویرایشگر، Project -> Install Android Build Template…‎ (پروژه -> نصب الگوی ساخت Android…) را انتخاب کنید
  8. پیام تأیید نمایش داده خواهد شد. روی دکمه نصب کلیک کنید.
Godot Export Template Manager
شکل ۱. پنجره مدیر الگو صادر کردن

فایل‌های الگوی ساخت در زیرفهرست راهنمای android/build که نسبت‌به فهرست راهنمای ریشه پروژه است ذخیره خواهد شد. به‌دلیل اندازه این زیرفهرست راهنما، شاید بخواهید آن را از محدوده کنترل نسخه پروژه‌تان حذف کنید.

افزودن پیش‌تنظیم صادر کردن Android

باید یک پیش‌تنظیم صادر کردن برای Android برای پروژه ایجاد شود. برای ایجاد پیش‌تنظیم، مراحل زیر را انجام دهید:

  1. از نوار منو ویرایشگر، پروژه -> صادر کردن… را انتخاب کنید
  2. در پنجره برون‌برد، منو کرکره‌ای افزودن… را انتخاب کنید، و سپس گزینه Android را به‌صورت زیر انتخاب کنید:
پنجره انتخاب پیش‌تنظیم «صادر کردن Godot»
شکل ۲: پنجره صادر کردن

سفارشی‌سازی گزینه‌های صادر کردن Android

پس‌از ایجاد پیش‌تنظیم صادر کردن Android برای پروژه‌تان، می‌توانید با انتخاب پیش‌تنظیم جدید در پنجره صادر کردن، گزینه‌های صادر کردن را پیکربندی کنید. گزینه‌های صادر کردن در سمت راست پنجره صادر کردن در دسته‌هایی گروه‌بندی شده‌اند. گزینه‌های رایج برای تنظیم عبارت‌اند از:

قالب صادر کردن و استفاده از ساخت سفارشی

گزینه قالب صادر کردن نشان می‌دهد که صادر کردن به‌صورت فایل APK انجام شود یا Android App Bundle (.AAB). برای آزمایش در دستگاه محلی درطول توسعه، فایل APK مناسب‌تر است، زیرا می‌توان آن را مستقیماً بااستفاده از adb نصب کرد. برای ساخت‌هایی که قصد دارید در Google Play بارگذاری کنید، از «بسته ترکیبی برنامه Android» استفاده کنید.

گزینه استفاده از ساخت سفارشی کنترل می‌کند که Godot از فرایند ساخت داخلی خودش استفاده کند یا از فرایند ساخت سنتی Gradle. اگر استفاده از ساخت سفارشی علامت زده شده باشد، Godot ساخت Gradle را انجام خواهد داد. اگر هرکدام از شرایط زیر وجود داشته باشد، استفاده از ساخت سفارشی باید علامت زده شود:

  • قالب صادر کردن روی Android App Bundle تنظیم شده باشد
  • پروژه از سیستم افزایه Godot Android استفاده می‌کند
گزینه‌های «قالب صادر کردن» و «استفاده از ساخت سفارشی»
شکل ۳: گزینه‌های قالب صادر کردن و ساخت سفارشی

معماری‌ها

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

گزینه‌های Architectures در پنجره Godot Export
شکل ۴: گزینه‌های صادر کردن معماری‌ها

Keystore

بخش Keystore جایی است که فایل‌های keystore اشکال‌زدایی و انتشار پیکربندی می‌شوند. این‌ها هنگام امضای دیجیتالی برنامه صادرشده استفاده می‌شوند. فیلدهای اشکال‌زدایی و انتشار باید مسیرهای مربوط به فایل‌های keystore مربوطه باشند. فیلدهای Debug User و Release User باید روی نام‌های مستعار در keystore تنظیم شوند.

گزینه‌های Keystore پنجره Godot Export
شکل ۵: گزینه‌های صادر کردن Keystore

اگر فایل keystore اشکال‌زدایی در بخش سراسری Editor Settings -> Export -> Android پیکربندی شده باشد، فیلدهای keystore اشکال‌زدایی در گزینه‌های «صادر کردن» پروژه ممکن است خالی بماند و فایل keystore اشکال‌زدایی سراسری به‌عنوان پیش‌فرض استفاده خواهد شد.

برای ایجاد ساخت جهت بارگذاری در «فروشگاه Google Play»، می‌توانید از Android Studio برای ایجاد فایل keystore نسخه پخش استفاده کنید.

برای ایجاد فایل keystore نسخه پخش برای برنامه‌تان:

  1. «استودیو Android» را راه‌اندازی کنید.
  2. در پنجره به «استودیو Android» خوش آمدید، ایجاد پروژه جدید را انتخاب کنید.
  3. الگوی No Activity (بدون فعالیت) را انتخاب کنید و روی Next (بعدی) کلیک کنید.
  4. در صفحه پیکربندی پروژه، روی پایان کلیک کنید تا پروژه ایجاد شود.
  5. بااستفاده از دستورالعمل‌های تولید کلید بارگذاری و keystore، فایل keystore ایجاد کنید.
  6. پس‌از ایجاد فایل keystore، از Android Studio خارج شوید و به ویرایشگر Godot برگردید.
  7. فایل keystore را به فیلد انتشار اضافه کنید و مقادیر کاربر انتشار و گذرواژه انتشار را در فیلدهای مربوطه وارد کنید.

نسخه و بسته

بخش‌های نسخه و بسته کد نسخه، رشته نسخه، شناسه بسته، و نام بسته را برای برنامه‌تان مشخص می‌کنند. فیلد نام متمایز باید روی شناسه بسته‌ای تنظیم شود که برنامه‌تان در «کنسول Google Play» استفاده می‌کند.

گزینه‌های «نسخه صادرشده» و «بسته»
شکل ۶: گزینه‌های نسخه و بسته صادر کردن

نمادهای راه‌انداز

بخش نمادهای راه‌انداز فایل‌های PNG را برای استفاده به‌عنوان نمادهای برنامه‌تان مشخص می‌کند. اگر فایل‌های نماد مشخص نشده باشند، Godot از فایل نماد پیش‌فرض استفاده می‌کند. Godot از تعیین نمادهای قدیمی برنامه و نمادهای تطبیق‌پذیر موجود در Android نسخه ۸.۰ (سطح میانای برنامه کاربردی ۲۶) و بالاتر پشتیبانی می‌کند. برای نکته‌هایی درباره ایجاد نمادهای تطبیقی، راهنمای نمادهای تطبیقی را ببینید.

گزینه‌های «صادر کردن نمادهای راه‌انداز»
شکل ۷: گزینه‌های صادر کردن نمادهای راه‌انداز

صادر کردن ساخت

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

  1. Project -> Export… را از نوار منو Godot انتخاب کنید.
  2. یک پیش‌تنظیم صادر کردن Android را از فهرست پیش‌تنظیم‌ها انتخاب کنید.
  3. روی دکمه صادر کردن پروژه در پایین پنجره صادر کردن کلیک کنید.
  4. در کادر گفتگوی ذخیره فایل، نامی برای فایل صادرشده انتخاب کنید.
  5. برای ایجاد ساخت نسخهٔ پخش، چارگوش انتخاب صادر کردن با اشکال‌زدایی را پاک کنید.
  6. برای صادر کردن ساخت، روی ذخیره کلیک کنید.
کادر گفتگوی صادر کردن ذخیره فایل
شکل ۷: کادر گفتگوی صادر کردن ذخیره فایل

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