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 平台自定义编译

Godot 提供了使用自定义构建 Android 模板的选项。与使用 Godot 附带的已预先构建好的模板不同，而是将实际的 Android Java 项目安装到项目文件夹中。然后 Godot 将构建它，并在每次导出项目时将其作为导出模板使用。

出于某些原因, 您可能想要这样做:

• 在构建项目之前对其进行修改.

• 添加与您的项目一起构建的外部SDK.

配置自定义构建是一个相当简单的过程。但首先你需要按照导出到 Android 中的步骤，直到在 Godot 中设置它。做完这些后，按照下面的步骤进行。

设置自定义构建环境

进入项目菜单, 安装 自定义构建 模板:

确保已下载导出模板. 如果没有, 此菜单将帮助您下载它们.

将在 res://android/build 下创建一个基于Gradle的Android项目, 不需要编辑这些文件, 除非你想 创建你自己的 add-ons , 或者真的需要修改项目.

启用自定义构建和导出

在项目 > 导出对话框中设置 Android 项目时，需要启用 Custom Build（自定义构建）：

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

生成的模板将在以后自动使用, 因此不需要进一步的配置.

备注

When using the custom Android build system, assets that are placed within a folder whose name begins with an underscore will not be included in the generated APK. This does not apply to assets whose file name begins with an underscore.

For example, _example/image.png will not be included as an asset, but _image.png will.