Unity 2019.4.29f1构建Android项目时出现废弃API使用报错
问题原因分析
- Unity构建缓存损坏:Unity构建Android项目时会生成临时缓存文件,当缓存文件不完整或损坏时,构建流程无法正确引用Android SDK的依赖包,进而触发废弃API警告和包缺失错误。重启项目后,Unity会自动清理无效缓存并重新生成正确的资源引用,问题随之消失。
- Android SDK同步不及时:首次构建时,Unity可能未完成Android SDK依赖的全量同步,导致编译阶段找不到必要的Android类库。重启项目会触发SDK依赖的重新同步,补全缺失的包文件。
- Unity 2019.4.x版本的已知小缺陷:这个LTS版本存在少量构建流程上的偶发bug,会导致临时的编译资源引用异常,重启项目是最直接的临时修复手段。
解决方案与预防措施
- 手动清理Unity缓存:删除项目根目录下的
Library文件夹,重启Unity后会重新生成完整的缓存文件(空项目无需担心资源丢失,复杂项目建议提前备份)。 - 校验Android SDK配置:进入
Edit > Preferences > External Tools,确认Android SDK路径正确,且SDK版本与Unity构建目标的Android API级别匹配(Unity 2019.4推荐使用Android SDK 28~30)。 - 临时禁用构建缓存:在
File > Build Settings > Player Settings > Publishing Settings中关闭Enable Build Cache,避免缓存异常干扰构建流程。 - 升级Unity小版本:如果这类问题频繁出现,建议升级到Unity 2019.4的更高小版本(如2019.4.40f1及以上),官方后续修复了不少构建相关的细节bug。
- 处理废弃API警告(可选):若想彻底消除废弃API提示,可以自定义
UnityPlayerActivity:创建继承自UnityPlayerActivity的自定义Activity,替换默认实现,在AndroidManifest.xml中指定使用该自定义Activity,同时用AndroidX的替代API替换废弃方法。
内容的提问来源于stack exchange,提问作者MathGeeksJay
相关产品推荐
相关产品推荐

