Android 的 Gradle 构建

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

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

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

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

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

设置 gradle 构建环境

前往“项目”菜单,安装 Gradle 构建模板:

../../_images/gradle_build_install_template.webp

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

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

启用 gradle 构建和导出

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

../../_images/gradle_build_enable.webp

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

../../_images/gradle_build_gradle.webp

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

备注

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

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