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 的 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 构建和导出