Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Збірки Gradle для Android

Godot надає можливість створювати за допомогою gradle buildsystem. Замість використання попередньо створеного шаблону, який поставляється з Godot, проект Android Java встановлюється у вашу папку проекту. Потім Godot створить його та використовуватиме як шаблон експорту кожного разу, коли ви експортуєте проект.

Є кілька причин, через які ви можете не захотіти робити це:

  • Зміна проєкту до його збірки.

  • Додавання зовнішніх SDK, які збираються разом із вашим проєктом.

Налаштування збірки gradle є досить простим процесом. Але спершу вам потрібно виконати кроки в розділі exporting for android до Налаштування в Godot. Після цього виконайте наведені нижче дії.

Налаштуйте середовище збирання gradle

Перейдіть до меню «Проект» і встановіть шаблон Gradle Build:

../../_images/gradle_build_install_template.webp

Переконайтеся, що шаблони експорту завантажені. Якщо ні, то це меню допоможе вам завантажити їх.

Проект Android на основі Gradle буде створено в розділі res://android/build. Редагувати ці файли не потрібно, якщо вам дійсно не потрібно змінити проект.

Увімкнення збірки та експортування Gradle

Під час налаштування проекту Android у діалоговому вікні Проект > Експорт необхідно ввімкнути Gradle Build:

../../_images/gradle_build_enable.webp

Відтепер спроба експортувати проєкт, або розгортання одним клацанням, викликатиме систему побудови Gradle для створення нових шаблонів (це вікно буде появлятися кожного разу):

../../_images/gradle_build_gradle.webp

Потім побудовані шаблони будуть використовуватися автоматично, тому подальша конфігурація не потрібна.

Примітка

Під час використання системи збірки gradle Android ресурси, розміщені в папці, ім’я якої починається з підкреслення, не будуть включені до створеного APK. Це не стосується активів, ім’я файлу якого починається з підкреслення.

Наприклад, _example/image.png не буде включено як актив, але _image.png буде.