升级SDK后Unity中Gradle构建失败，已尝试多种方案无效

问题背景 #

已查阅10余个同类问题，所有解决方案均无效。将Android SDK从API Level 33升级到API Level 35后，项目无法正常构建；即使升级到Unity 6、使用Unity生成的自定义Gradle文件、重新安装所有资源，问题仍存在。

核心报错信息 #

CommandInvokationFailure: Gradle build failed. 
C:\Program Files\Unity\Hub\Editor\6000.0.14f1\Editor\Data\PlaybackEngines\AndroidPlayer\OpenJDK\bin\java.exe -classpath "C:\Program Files\Unity\Hub\Editor\6000.0.14f1\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\gradle\lib\gradle-launcher-8.4.jar" org.gradle.launcher.GradleMain "-Dorg.gradle.jvmargs=-Xmx4096m" "bundleRelease" 

...

stderr[

FAILURE: Build completed with 2 failures.

1: Task failed with an exception.
-----------
* 位置:
脚本 'C:\Users\joest\Desktop\Studio JGL\DekEvolution\Library\Bee\Android\Prj\IL2CPP\Gradle\launcher\setupSymbols.gradle' 第6行

* 错误原因:
评估脚本时出现问题。
> 配置项目 ':unityLibrary' 时出现问题。
   > 无法创建 com.android.build.api.variant.impl.LibraryVariantBuilderImpl 实例。
      > 未指定命名空间。请在模块的构建文件中指定命名空间。
        
        如果您已在源AndroidManifest.xml中指定了package属性，可以使用AGP升级助手迁移到构建文件中的namespace值。

2: Task failed with an exception.
-----------
* 错误原因:
配置项目 ':launcher' 时出现问题。
> 未指定compileSdkVersion。请将其添加到build.gradle中

BUILD FAILED in 6s
]

exit code: 1
...

解决步骤 #

1. 修复:unityLibrary命名空间缺失问题 #

• 打开Unity编辑器，进入Player Settings > Android > Publishing Settings，勾选Custom Main Gradle Template和Custom Library Gradle Template，生成可编辑的Gradle模板文件
• 在项目Assets/Plugins/Android目录下找到libraryTemplate.gradle文件
• 在文件的android代码块内添加命名空间配置，值为项目AndroidManifest.xml中的package属性值，示例：

android {
    namespace "com.yourcompany.yourgame" // 替换为你的项目包名
    ... // 保留原有配置
}

• 保存文件后重新构建项目

2. 修复:launcher的compileSdkVersion缺失问题 #

• 在Assets/Plugins/Android目录下找到mainTemplate.gradle文件
• 在android代码块内添加编译SDK版本配置，示例：

android {
    compileSdkVersion 35
    targetSdkVersion 35
    ... // 保留原有配置
}

• 同时确认Unity Player Settings中，Android的Compile SDK Version和Target SDK Version均设置为35

额外检查项 #

• 清理Unity项目的Library文件夹，重新打开项目让Unity自动生成依赖文件
• 检查第三方插件的AndroidManifest.xml，确保包名无冲突，且插件Gradle配置适配API Level 35
• 确认Unity Hub中安装的Android SDK组件完整，包含API Level 35的所有必要文件

内容的提问来源于stack exchange，提问作者Jonathan Gagnon-Laroche