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.

为 Android 平台自定义编译

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

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

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

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

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

设置自定义构建环境

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

../../_images/custom_build_install_template.png

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

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

启用自定义构建和导出

项目 > 导出对话框中设置 Android 项目时,需要启用 Custom Build(自定义构建):

../../_images/custom_build_enable.png

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

../../_images/custom_build_gradle.png

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

备注

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.