Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

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。