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...

Android 的 Gradle 构建

Godot 提供了使用 gradle 构建系统进行构建的选项。使用 gradle 构建时，不会使用 Godot 自带的已经构建好的模板，而是会在你的项目文件夹中安装一个 Android Java 项目。这样每次导出项目时，Godot 都会构建这个项目，用它作为导出模板。

需要使用这种方法的原因可能有：

• 在构建项目前进行修改。

• 添加需要与项目一同构建的外部 SDK。

Gradle 构建的配置过程相当简单。但首先你需要按照导出到 Android 中的步骤进行操作，做到在 Godot 中进行设置为止。做完这些后，请按照下面的步骤进行操作。

设置 gradle 构建环境

前往“项目”菜单，安装 Gradle 构建模板：

请确保已下载导出模板。如果尚未下载，则这个菜单会帮你下载。

res://android/build 下会生成一个基于 Gradle 的 Android 项目。你不需要编辑里面的文件，除非真的有修改这个项目的需求。

启用 gradle 构建和导出

在项目 > 导出对话框中设置 Android 项目时，需要启用 Gradle 构建：

从现在开始，尝试导出项目或一键部署就会调用 Gradle 构建系统来生成新的模板（每次都会出现这个窗口）：

后续步骤中会自动使用生成的模板，不需要进一步的配置。

备注

使用基于 gradle 的 Android 构建系统时，如果放置资产的文件夹以下划线开头，就不会包含在生成的 APK 里。这个规则不适用于文件名以下划线开头的资源。

例如，不会包含名为 _example/image.png 的资产，但是会包含 _image.png。