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.

Checking the stable version of the documentation...

Сборки 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 будет.