Unity 2022.3.0构建Android时Gradle报错的解决求助

问题核心 #

• Unity版本：2022.3.0 LTS
• 场景：基于2D URP模板添加Mobile包后，构建Android（目标设备Google Pixel 6）时出现Gradle报错，最终:unityLibrary:compileReleaseJavaWithJavac任务失败；纯2D URP模板可正常构建，2D Mobile模板触发相同错误
• 附加问题：Adaptive Performance Provider初始仅显示Samsung，选择后出现Android Provider但提示与编辑器版本不兼容

一、Gradle构建错误修复方案 #

1. 修复Android SDK目录权限 #

• 错误中的SDK只读提示是核心诱因，找到本地Android SDK安装目录，右键取消只读属性，确保属性应用到所有子文件夹和文件
• 若SDK位于系统受保护路径（如C:\Program Files），建议将SDK迁移到自定义路径（如D:\AndroidSDK），然后在Unity中通过Edit > Preferences > External Tools更新SDK路径

2. 调整Gradle模板配置 #

• 打开Project Settings > Player > Android > Publishing Settings，勾选Custom Gradle Template，生成Assets/Plugins/Android/mainTemplate.gradle文件
• 打开该文件，确保compileOptions配置为Java 8（Unity 2022.3.0适配版本）：

  compileOptions {
      sourceCompatibility JavaVersion.VERSION_1_8
      targetCompatibility JavaVersion.VERSION_1_8
  }
  

• 同时检查buildscript中的gradle插件版本，Unity 2022.3.0建议使用：

  dependencies {
      classpath 'com.android.tools.build:gradle:7.4.2'
      // 其他依赖保持不变
  }
  

3. 清理项目缓存 #

• 关闭Unity，删除项目根目录下的Temp、Library文件夹，以及Assets/Plugins/Android内的Gradle缓存目录
• 重新打开Unity，等待项目重新生成资源后再次尝试构建

二、Adaptive Performance Provider兼容问题修复 #

1. 安装对应版本的Android Provider #

• Unity 2022.3.0 LTS适配的Adaptive Performance Android Provider版本为3.1.0，打开Package Manager，点击左上角+ > Add package by name，输入com.unity.adaptiveperformance.android并指定版本3.1.0
• 先移除已安装的Samsung Provider，避免版本冲突

2. 手动指定包依赖版本 #

• 打开项目根目录下的Packages/manifest.json，手动修改Adaptive Performance相关包的版本：

  {
    "dependencies": {
      "com.unity.adaptiveperformance": "3.1.0",
      "com.unity.adaptiveperformance.android": "3.1.0",
      // 其他依赖保持不变
    }
  }
  

• 保存文件后，Unity会自动同步依赖

3. 验证Provider配置 #

• 打开Edit > Project Settings > Adaptive Performance，确认Selected Provider为Android，若仍有版本提示，重启Unity后再次检查

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