Unity安卓项目构建出现android.enableR8已弃用警告，求解决方法

你可能遗漏的排查点： #

• 检查Unity的Android Player配置细节
  进入Edit > Project Settings > Player > Android > Publishing Settings：
  • 如果启用了Custom Gradle Properties Template，打开生成的gradle.properties文件，搜索android.enableR8，直接删除该行配置。
  • 若开启了Custom Gradle Template，打开对应的build.gradle文件，检查是否存在手动添加的enableR8相关代码（比如android.enableR8=false），找到后一并删除。
• 检查Unity安装目录下的默认模板文件
  找到当前使用的Unity版本安装路径中的Android模板文件夹（例如2021.3.5f1的路径大致为Unity\Hub\Editor\2021.3.5f1\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\GradleTemplates），打开其中的gradle.properties.template和baseProjectTemplate.gradle文件，搜索android.enableR8，存在则删除对应行。
• 彻底清理构建缓存
  • 删除项目根目录下的Library、Temp、Obj文件夹，重新生成项目文件后再尝试构建。
  • 清理Gradle本地缓存：Windows系统路径为C:\Users\你的用户名\.gradle\caches，Mac系统路径为~/.gradle/caches，删除缓存文件后重新执行构建。
• 核对SDK Build Tools与Gradle版本兼容性
  进入Edit > Preferences > External Tools，确认Android SDK的Build Tools版本与当前使用的Gradle版本匹配（例如Gradle 7.4.2建议搭配Build Tools 30.0.3及以上版本），版本不匹配可能导致旧配置残留触发警告。
• 排查项目中的隐藏配置文件
  检查项目根目录下是否存在.gradle文件夹、local.properties文件，或是其他第三方工具生成的配置文件，这些文件可能意外添加了android.enableR8配置，找到后删除相关条目。

补充说明 #

这个警告的核心原因是Android Gradle Plugin（AGP）从特定版本开始强制启用R8，不再支持通过android.enableR8开关关闭该功能，因此只要项目中残留这个配置就会触发警告——哪怕你没有手动添加，也可能是Unity模板、旧缓存或残留配置文件导致的。

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