Unity 2021.3.6f1打包Android时提示launcherTemplate.gradle文件找不到

使用Unity 2021.3.6f1打包Android平台时抛出FileNotFoundException，提示找不到launcherTemplate.gradle文件，且项目中无该文件的引用。尝试过使用自定义Gradle文件、修改现有Gradle文件，均未解决问题。错误日志如下：

FileNotFoundException: 未能找到文件 $E:/Unity Game Engine/2021.3.6f1/Editor/Data/PlaybackEngines/AndroidPlayer/Tools\GradleTemplates\baseProjectTemplate.gradle
UnityEditor.Android.AndroidBuildPostprocessor.GetTemplate (System.String toolsPath, System.String fileName) (at <0bc7e9c04c1540528b26863a0cb726ae>:0)
UnityEditor.Android.AndroidBuildPostprocessor+<GetDataForBuildProgramFor>d__21.MoveNext () (at <0bc7e9c04c1540528b26863a0cb726ae>:0)
UnityEditor.Modules.BeeBuildPostprocessor.SetupBeeDriver (UnityEditor.Modules.BuildPostProcessArgs args) (at <44a70d1b13cf47e29810e30f45ffae08>:0)
UnityEditor.Modules.BeeBuildPostprocessor.PostProcess (UnityEditor.Modules.BuildPostProcessArgs args) (at <44a70d1b13cf47e29810e30f45ffae08>:0)
重抛为BuildFailedException: 引发了类型为“UnityEditor.Build.BuildFailedException”的异常。
UnityEditor.Modules.BeeBuildPostprocessor.PostProcess (UnityEditor.Modules.BuildPostProcessArgs args) (at <44a70d1b13cf47e29810e30f45ffae08>:0)
UnityEditor.Modules.DefaultBuildPostprocessor.PostProcess (UnityEditor.Modules.BuildPostProcessArgs args, UnityEditor.BuildProperties& outProperties) (at <44a70d1b13cf47e29810e30f45ffae08>:0)
UnityEditor.Android.AndroidBuildPostprocessor.PostProcess (UnityEditor.Modules.BuildPostProcessArgs args, UnityEditor.BuildProperties& outProperties) (at <0bc7e9c04c1540528b26863a0cb726ae>:0)
UnityEditor.PostprocessBuildPlayer.Postprocess (UnityEditor.BuildTargetGroup targetGroup, UnityEditor.BuildTarget target, System.Int32 subtarget, System.String installPath, System.String companyName, System.String productName, System.Int32 width, System.Int32 height, UnityEditor.BuildOptions options, UnityEditor.RuntimeClassRegistry usedClassRegistry, UnityEditor.Build.Reporting.BuildReport report) (at <44a70d1b13cf47e29810e30f45ffae08>:0)
UnityEngine.GUIUtility:ProcessEvent(Int32, IntPtr, Boolean&)

解决方案 #

• 检查Unity Android模块完整性
  打开Unity Hub，找到已安装的2021.3.6f1版本，点击三个点选择「添加模块」，确认Android Build Support模块下的Android SDK & NDK Tools、OpenJDK已完整安装，若有缺失勾选后重新安装，完成后重启Unity重试打包。

• 修复缺失的Gradle模板文件
  手动前往路径E:/Unity Game Engine/2021.3.6f1/Editor/Data/PlaybackEngines/AndroidPlayer/Tools/GradleTemplates，检查是否存在baseProjectTemplate.gradle和launcherTemplate.gradle；若缺失，可从同版本Unity的安装目录复制对应文件，或重新安装Android Build Support模块。

• 重置Unity Gradle设置
  进入Edit > Project Settings > Player > Android > Publishing Settings，先取消勾选「Custom Gradle Template」，再重新勾选，Unity会自动生成默认模板到Assets/Plugins/Android目录，删除之前的自定义Gradle文件后重试打包。

• 排查路径与权限问题
  Unity安装路径包含空格（E:/Unity Game Engine）可能导致Gradle解析异常，可将Unity移动到无空格的路径（如E:/Unity2021.3.6f1）；同时确保Unity安装目录和项目目录有读写权限，右键文件夹选择「属性 > 安全」，赋予当前用户完全控制权限。

• 切换Gradle版本
  在Publishing Settings中找到「Gradle Version」，切换到Unity推荐的版本（如6.1.1，适配2021.3.x）；若使用自定义Gradle，确保baseProjectTemplate.gradle中的依赖版本与本地Gradle环境兼容。

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