این سند نحوه صادر کردن پروژه Godot را بهعنوان برنامه Android شرح میدهد. Godot میتواند هم فایلهای APK برای آزمایش دستگاه محلی و هم Android App Bundle برای ارسال به «فروشگاه Google Play» تولید کند.
نصب الگوی ساخت Android
Godot از الگوی ساخت بهعنوان نقطه شروع برای تولید فایلهای Gradle و دیگر دادههای لازم برای ایجاد و ساخت برنامه Android استفاده میکند. الگوی ساخت باید پیشاز صادر کردن ساخت Android به پروژه Godot وارد شود. هر نسخه از Godot الگوی خودش را دارد. برای نصب الگوی ساخت Android در پروژه، مراحل زیر را انجام دهید:
- پروژه را در ویرایشگر Godot باز کنید.
- در نوار منو، Project -> Install Android Build Template… (پروژه -> نصب الگوی ساخت Android…) را انتخاب کنید
- روی دکمه مدیریت الگوها… کلیک کنید.
- در پنجره مدیر الگوی صادر کردن، روی دکمه بارگیری برای نسخه Godot مورداستفاده (نسخه کنونی) کلیک کنید.
- مکان آینهای را برای بارگیری فایل انتخاب کنید.
- پساز تکمیل بارگیری، روی دکمه بستن در پنجره مدیر صادر کردن الگو کلیک کنید.
- از نوار منو ویرایشگر، Project -> Install Android Build Template… (پروژه -> نصب الگوی ساخت Android…) را انتخاب کنید
- پیام تأیید نمایش داده خواهد شد. روی دکمه نصب کلیک کنید.
فایلهای الگوی ساخت در زیرفهرست راهنمای android/build که
نسبتبه فهرست راهنمای ریشه پروژه است ذخیره خواهد شد. بهدلیل اندازه این زیرفهرست راهنما،
شاید بخواهید آن را از محدوده کنترل نسخه پروژهتان حذف کنید.
افزودن پیشتنظیم صادر کردن Android
باید یک پیشتنظیم صادر کردن برای Android برای پروژه ایجاد شود. برای ایجاد پیشتنظیم، مراحل زیر را انجام دهید:
- از نوار منو ویرایشگر، پروژه -> صادر کردن… را انتخاب کنید
- در پنجره برونبرد، منو کرکرهای افزودن… را انتخاب کنید، و سپس گزینه Android را بهصورت زیر انتخاب کنید:
سفارشیسازی گزینههای صادر کردن 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، باید با همه معماریهای دردسترس که پروژهتان پشتیبانی میکند صادر کنید.
Keystore
بخش Keystore جایی است که فایلهای keystore اشکالزدایی و انتشار پیکربندی میشوند. اینها هنگام امضای دیجیتالی برنامه صادرشده استفاده میشوند. فیلدهای اشکالزدایی و انتشار باید مسیرهای مربوط به فایلهای keystore مربوطه باشند. فیلدهای Debug User و Release User باید روی نامهای مستعار در keystore تنظیم شوند.
اگر فایل keystore اشکالزدایی در بخش سراسری Editor Settings -> Export -> Android پیکربندی شده باشد، فیلدهای keystore اشکالزدایی در گزینههای «صادر کردن» پروژه ممکن است خالی بماند و فایل keystore اشکالزدایی سراسری بهعنوان پیشفرض استفاده خواهد شد.
برای ایجاد ساخت جهت بارگذاری در «فروشگاه Google Play»، میتوانید از Android Studio برای ایجاد فایل keystore نسخه پخش استفاده کنید.
برای ایجاد فایل keystore نسخه پخش برای برنامهتان:
- «استودیو Android» را راهاندازی کنید.
- در پنجره به «استودیو Android» خوش آمدید، ایجاد پروژه جدید را انتخاب کنید.
- الگوی No Activity (بدون فعالیت) را انتخاب کنید و روی Next (بعدی) کلیک کنید.
- در صفحه پیکربندی پروژه، روی پایان کلیک کنید تا پروژه ایجاد شود.
- بااستفاده از دستورالعملهای تولید کلید بارگذاری و keystore، فایل keystore ایجاد کنید.
- پساز ایجاد فایل keystore، از Android Studio خارج شوید و به ویرایشگر Godot برگردید.
- فایل keystore را به فیلد انتشار اضافه کنید و مقادیر کاربر انتشار و گذرواژه انتشار را در فیلدهای مربوطه وارد کنید.
نسخه و بسته
بخشهای نسخه و بسته کد نسخه، رشته نسخه، شناسه بسته، و نام بسته را برای برنامهتان مشخص میکنند. فیلد نام متمایز باید روی شناسه بستهای تنظیم شود که برنامهتان در «کنسول Google Play» استفاده میکند.
نمادهای راهانداز
بخش نمادهای راهانداز فایلهای PNG را برای استفاده بهعنوان نمادهای برنامهتان مشخص میکند. اگر فایلهای نماد مشخص نشده باشند، Godot از فایل نماد پیشفرض استفاده میکند. Godot از تعیین نمادهای قدیمی برنامه و نمادهای تطبیقپذیر موجود در Android نسخه ۸.۰ (سطح میانای برنامه کاربردی ۲۶) و بالاتر پشتیبانی میکند. برای نکتههایی درباره ایجاد نمادهای تطبیقی، راهنمای نمادهای تطبیقی را ببینید.
صادر کردن ساخت
برای صادر کردن نسخه، این مراحل را دنبال کنید:
- Project -> Export… را از نوار منو Godot انتخاب کنید.
- یک پیشتنظیم صادر کردن Android را از فهرست پیشتنظیمها انتخاب کنید.
- روی دکمه صادر کردن پروژه در پایین پنجره صادر کردن کلیک کنید.
- در کادر گفتگوی ذخیره فایل، نامی برای فایل صادرشده انتخاب کنید.
- برای ایجاد ساخت نسخهٔ پخش، چارگوش انتخاب صادر کردن با اشکالزدایی را پاک کنید.
- برای صادر کردن ساخت، روی ذخیره کلیک کنید.
اگر گزینه استفاده از ساخت سفارشی در پیشتنظیم صادر کردن علامت زده شده باشد، پنجره پیشرفت صادر کردن متفاوت بهنظر خواهد رسید. ساختهای سفارشی برونداد فرایند ساخت Gradle را نمایش میدهند.