返回博客

Godot 如何导出 Android 安装包

2026/8/303 分钟阅读

Godot 如何导出 Android 安装包

Godot 导出 Android 安装包的核心路径是「项目 → 导出 → 添加 Android 模板」，接着配置 JDK 和 Android SDK 路径即可一键生成 APK。以下步骤基于 Godot 4.x，直接在 Editor Settings 里填好环境，导出面板里点「导出项目」就能拿到可用的安装包。

导出前必须配好的三样东西

很多人卡在「缺少构建工具」这个报错上，其实只需要三个环境变量配对就行：JDK 11+、Android SDK Platform-Tools、以及 Godot 自带的 Android 模板。

先去官网下载 JDK 11（Zulu 或 Oracle 都可以），装完后在终端跑一行命令确认路径：

bash
/usr/libexec/java_home -V

记下返回的路径，比如 /Library/Java/JavaVirtualMachines/zulu-11.jdk/Contents/Home。Android SDK 的话，Godot 自带一个便携版，一般在安装目录下的 appdata/godot/android/sdk，如果没有的话去 Android 官网下个 Command Line Tools 然后 sdkmanager "platform-tools" "build-tools;33.0.0" 装上。

接下来打开 Godot 编辑器，进入「编辑器 → 编辑器设置 → 平台 → Android」，把 JDK 路径、SDK 路径、Platform-Tools 路径分别粘贴进去，别手抖输错字符。

导出 APK 还是 AAB

导出面板右边有个「保留」标签页，这里决定你用哪种格式：

  • APK：自己测试、发内部包、给朋友用，直接装完就跑，不受商店审核约束。
  • AAB：上架 Google Play 必备，体积更小，用户按需下载资源模块。

在「格式」里勾选你想要的类型，然后点「导出项目」按钮。第一次导出会提示你选个存放文件夹，之后所有包都会往这里攒，不用每次再挑路径。

常见签名报错怎么解

导出完安装包之后，如果手机上提示「应用未损坏」，99% 是签名没配对。Godot 默认给你生成一个调试签名，发布正式版必须自己签。

在项目文件夹里新建一个 export_presets.cfg，或者直接在 Godot 的「项目 → 项目设置 → 打包」里找到签名选项，填入你的密钥库密码、别名、key 密码。如果忘记密码，只能重新生成一个 keystore：

bash
keytool -genkey -v -keystore my-release-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-alias

记住命令里的几个参数别抄错，尤其是 -alias 和 -keystore 路径，后面导出面板里要填的签名密钥库路径就是这个文件。签完名之后安装包才能正常安装到用户的安卓设备上。

导出失败排查清单

如果点「导出项目」之后编辑器卡死或者报空指针，按下面这个顺序查一遍：

  1. 确认 JDK 版本是不是 11 或更高，Godot 4 不支持 JDK 8。
  2. 检查 Android SDK 的 build-tools 版本是不是 33.0.0 或以上，太低会导致编译失败。
  3. 看项目文件夹里有没有中文字符，Godot 对中文路径支持不好，会直接报错退出。
  4. 关掉所有杀毒软件，某些安全程序会锁定正在写入的 apk 文件。

下一步继续深入

配置完基础导出之后，如果想做性能优化、接入广告 SDK、或者上架 App Store，可以去兰屿星奇的官方博客继续看后面的专题文章，里面会讲到 Godot Android 打包后的内存调优和崩溃日志抓取技巧。

相关阅读