UE5.2安卓打包失败求助:SetupAndroid.bat执行出错
UE5.2 安卓打包 SetupAndroid.bat 报错(Exit Code 4)及关联问题修复
核心问题定位
你遇到的SetupAndroid.bat报错Exit Code 4,本质是UE5.2的安卓配置脚本对SDK组件版本有隐性依赖——虽然官方文档只标注NDK需为r25b,但脚本实际要求匹配特定版本的SDK Platform Tools、Build Tools,同时Java环境也必须严格对应。
分步修复方案
1. 统一安卓组件版本(匹配UE5.2强制要求)
UE5.2的SetupAndroid.bat会校验固定组件版本,手动安装以下指定版本:
- NDK (Side by side):必须选
25.1.8937393(即r25b,和文档要求一致) - SDK Platform Tools:降级到
30.0.3(脚本参数明确指定的版本,不能用最新版) - SDK Build Tools:安装
30.0.3(和Platform Tools版本保持匹配) - Command Line Tools:选择
6.0版本(避免高版本兼容性冲突) - CMake:保持
3.10.2.4988404(脚本指定版本)
操作步骤:
- 打开Android Studio → SDK Manager → SDK Tools,勾选"Show Package Details"
- 找到对应组件,勾选上述指定版本,取消其他高版本选项,点击Apply完成安装
2. 修复Java环境配置(解决Groovy报错的关键)
之前出现的Could not initialize class org.codehaus.groovy.vmplugin.v7.Java7错误,是Groovy版本与Java版本不兼容导致,必须严格配置:
- 安装JDK 11(禁止使用JDK 17及以上版本,也不能用JRE替代)
- 在UE编辑器中配置路径:
- 打开
Edit → Project Settings → Platforms → Android - 在"SDK"选项卡中,将"Java Development Kit Path"指向JDK 11的安装根目录(例如
C:\Program Files\Java\jdk-11.0.18) - 确认"Android SDK Path"指向Android Studio的SDK根目录(例如
C:\Users\[你的用户名]\AppData\Local\Android\Sdk)
- 打开
3. 强制重新执行SetupAndroid.bat
手动运行脚本并清理缓存,避免残留配置干扰:
- 关闭UE编辑器和Android Studio
- 以管理员身份打开命令提示符(CMD)
- 切换到脚本所在目录:
cd E:\Program Files\Epic Games\UE_5.2\Engine\Extras\Android - 执行带清理参数的脚本:
(SetupAndroid.bat android-32 30.0.3 3.10.2.4988404 25.1.8937393 -noninteractive -clean-clean参数会清除之前的缓存配置,强制重新校验组件安装)
4. 验证UE安卓平台配置
打开UE编辑器:
- 进入
Edit → Project Settings → Platforms → Android - 点击"Refresh"按钮,确保所有SDK/NDK路径都显示"Valid"
- 检查"Target SDK Version"设置为
32(和脚本参数保持一致)
常见坑点规避
- 不要使用Android Studio默认安装的最新组件,UE对安卓工具链版本兼容性要求严格
- 绝对不能用JRE代替JDK,UE打包需要完整的JDK开发环境
- 确保所有路径(JDK、SDK、NDK)无中文或特殊字符,避免脚本解析失败
内容的提问来源于stack exchange,提问作者KotaroFuma
相关产品推荐
相关产品推荐

