必须安装unity编辑器、android build support模块、android sdk/ndk和openjdk四者且版本严格一致;通过unity hub安装lts版并勾选三项组件;验证路径无红叹号或可切换android平台即成功。

要在Windows系统上安装Unity引擎并配置好3D手游开发环境,必须同时装好编辑器、对应平台构建模块(尤其是Android Build Support)、配套的JDK与Android SDK/NDK,缺一不可——漏掉任一组件,后续打包APK时就会卡在“Build Failed”且报错信息晦涩难懂。
下载并安装Unity Hub
打开浏览器,访问 https://unity.com/download → 点击「Download Unity Hub」绿色按钮 → 运行下载好的 UnityHubSetup.exe → 全程默认设置安装即可。这一步操作起来很简单,直接双击下一步到底就行。
安装完成后首次启动会强制要求登录Unity ID;【必须用能长期访问的邮箱注册并登录,否则后续无法激活编辑器、下载Android模块、访问Asset Store】。
通过Hub安装LTS版Unity编辑器
启动Unity Hub → 点击左上角「Installs」→ 点击右上角「Add」→ 选择「Unity Editor」→ 在版本列表中优先勾选标注为 LTS 的版本(如 2022.3.41f1 或 2021.3.35f1),不要点 Latest Stable。
勾选后点击「Next」→ 在「Select modules to install」页面,务必勾选以下三项:
• Android Build Support
• Android SDK & NDK Tools
• OpenJDK
注意:这三个模块必须和Unity编辑器同版本号安装,不能混用。例如你装的是2022.3.41f1,那么SDK/NDK/JDK也必须是Hub为该版本自动匹配的那一套;手动替换路径或复用旧版会导致构建失败且错误提示为“CommandInvokationFailure”。
验证Android构建环境是否就绪
方法一:创建空白3D项目 → 菜单栏 Edit → Preferences → External Tools → 检查Android选项卡下三处路径是否全部自动填满且无红叹号:
① JDK Path(应指向Hub安装的OpenJDK目录)
② SDK Path(应指向Hub安装的Android SDK目录)
③ NDK Path(应指向Hub安装的Android NDK目录)
方法二:菜单栏 File → Build Settings → Platform 切换为 Android → 点击「Switch Platform」→ 若右下角不弹出红色报错,且「Build」按钮可点击,即表示环境已通。
如果其中任一路径为空或标红,不要手动去网上下载SDK再粘贴路径——Hub已内置完整工具链,只需回到「Installs」页,对已安装的Unity版本点击右侧三个点 → 「Manage Modules」→ 勾选缺失项并点击「Apply」即可补全。
设置项目存储路径避免中文乱码
Unity Hub → 左侧「Projects」→ 点击右上角齿轮图标 → Preferences → General → 修改「Default project location」为纯英文路径,例如 C:\UnityProjects。
这一步不能跳过。若项目建在桌面、文档、含中文名的文件夹或OneDrive同步目录下,导入资源时大概率触发 【Invalid path format】 报错,且Unity不会明确提示原因,只会静默失败。
创建第一个支持Android的3D项目
步骤一:Unity Hub → 「New Project」→ 模板选「3D Core」(非URP或HDRP,新手起步更轻量)→ Project name 填英文(如 MyFirstGame)→ Location 选刚才设好的纯英文路径 → Create。
步骤二:项目加载完毕后,菜单栏 File → Build Settings → Platform 切换为 Android → 点击「Switch Platform」→ 等待编译完成(右下角提示“Platform switched to Android”)→ 点击「Player Settings…」→ 在 Inspector 中展开 Publishing Settings → 勾选「Custom Main Manifest」→ 此时会自动生成 Assets/Plugins/Android/AndroidManifest.xml。
步骤三:确保场景中至少有一个GameObject(如默认的Main Camera),然后菜单栏 File → Save Scene → 保存为 Scenes/SampleScene.unity → 至此,项目已具备导出APK的基础结构。











