Сборки Gradle для Android

Godot предоставляет возможность сборки с помощью системы сборки Gradle. Вместо использования готового шаблона, поставляемого с Godot, в папку вашего проекта устанавливается проект Android Java. Godot затем соберет его и будет использовать в качестве шаблона экспорта при каждом экспорте проекта.

Есть несколько причин, по которым вы можете захотеть это сделать:

  • Изменение проекта до его сборки.

  • Добавление внешнего SDK, которые собираются вместе с вашим проектом.

Настройка сборки Gradle — довольно простой процесс. (Если знаете как) Но сначала вам нужно выполнить шаги, описанные в разделе exporting for android и далее в разделе Настройка в Godot. После этого выполните следующие шаги.

Настройка среды сборки Gradle

Перейдите в меню "Project" и установите шаблон Gradle Build:

../../_images/gradle_build_install_template.webp

Убедитесь, что шаблоны экспорта загружены. Если нет, то это меню поможет вам их скачать.

Проект Android на базе Gradle будет создан в папке res://android/build. Редактировать эти файлы не требуется, если только вам действительно не нужно вносить изменения в проект.

Включение сборки Gradle и экспорта

При настройке проекта Android в диалоговом окне Project > Export необходимо включить Gradle Build:

../../_images/gradle_build_enable.webp

С этого момента попытка экспорта проекта или развёртывания в один клик вызовет систему сборки Gradle для создания новых шаблонов (это окно будет появляться каждый раз):

../../_images/gradle_build_gradle.webp

Созданные шаблоны будут впоследствии использоваться автоматически, поэтому дальнейшая настройка не потребуется.

Примечание

При использовании системы сборки Android Gradle ресурсы, размещённые в папке, имя которой начинается с символа подчёркивания, не будут включены в сгенерированный APK-файл. Это не относится к ресурсам, имя файла которых начинается с символа подчёркивания.

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