Unity 2021.3.25f1 构建APK时遇问题求助

问题描述 #

使用Unity 2021.3.25f1构建APK时触发Gradle构建失败，核心错误提示包含路径不存在警告，具体错误信息如下：

Configure project :launcher
WARN: /home/myname/Monkey Jump (No such file or directory): /home/myname/Monkey Jump

CommandInvokationFailure: Gradle build failed. 
/home/myname/Unity/Hub/Editor/2021.3.25f1/Editor/Data/PlaybackEngines/AndroidPlayer/OpenJDK/bin/java -classpath "/home/myname/Unity/Hub/Editor/2021.3.25f1/Editor/Data/PlaybackEngines/AndroidPlayer/Tools/gradle/lib/gradle-launcher-6.1.1.jar" org.gradle.launcher.GradleMain "-Dorg.gradle.jvmargs=-Xmx4096m" "assembleRelease"

Build completed with a result of 'Failed' in 7 seconds (6811 ms)
UnityEngine.GUIUtility:ProcessEvent (int,intptr,bool&) (at /home/bokken/build/output/unity/unity/Modules/IMGUI/GUIUtility.cs:189)

UnityEditor.BuildPlayerWindow+BuildMethodException: 4 errors
  at UnityEditor.BuildPlayerWindow+DefaultBuildMethods.BuildPlayer (UnityEditor.BuildPlayerOptions options) [0x002ce] in /home/bokken/build/output/unity/unity/Editor/Mono/BuildPlayerWindowBuildMethods.cs:194 
  at UnityEditor.BuildPlayerWindow.CallBuildMethods (System.Boolean askForBuildLocation, UnityEditor.BuildOptions defaultBuildOptions) [0x00080] in /home/bokken/build/output/unity/unity/Editor/Mono/BuildPlayerWindowBuildMethods.cs:95 
UnityEngine.GUIUtility:ProcessEvent (int,intptr,bool&) (at /home/bokken/build/output/unity/unity/Modules/IMGUI/GUIUtility.cs:189)

解决方案 #

• 修复路径空格问题：错误警告的核心是项目路径/home/myname/Monkey Jump包含空格，导致Gradle解析异常。将项目文件夹重命名为MonkeyJump（移除空格），关闭Unity后重新打开项目，同时检查Build Settings中的输出路径，确保无空格。
• 清理Gradle缓存：打开Edit > Preferences > External Tools，点击Gradle缓存旁的Clean按钮；也可手动删除用户目录下的缓存文件夹~/.gradle/caches。
• 重新生成Gradle项目：进入File > Build Settings > Android，打开Player Settings的Publishing Settings，勾选Custom Gradle Template后点击Regenerate，确保生成的mainTemplate.gradle无语法错误。
• 匹配JDK与Gradle版本：Unity 2021.3.25f1默认搭配Gradle 6.1.1和OpenJDK 11，在Edit > Preferences > External Tools中确认选中JDK Installed with Unity和Gradle Installed with Unity，避免手动替换版本引发兼容性问题。
• 查看完整Gradle日志：在Build Settings中勾选Show Console，重新构建后切换到Console窗口的Gradle标签，查看详细错误信息，定位具体问题（如依赖冲突、权限配置错误等）。

内容的提问来源于stack exchange，提问作者AzureSkyed