Unity构建Android应用:已下载对应API却提示Target SDK未包含问题求助
解决Unity Android Target SDK 24/26/28报错问题
检查Unity与Android SDK版本兼容性
- 确认当前使用的Unity版本是否支持这些旧API级别。部分2020年及以后发布的Unity版本,对API 24及更低版本的兼容性有限,默认可能不再提供支持,需要手动调整配置。
- 核对Unity官方文档中对应版本的Android SDK支持范围,确保API 24/26/28在兼容列表内。
验证Android SDK组件完整性
- 打开Android SDK Manager,除了下载对应API级别的SDK Platform,必须同步安装对应的Android SDK Build-Tools版本:API 24对应Build-Tools 24.0.3,API 26对应26.0.3,API 28对应28.0.3,缺失对应Build-Tools是构建失败的常见原因。
- 检查是否安装了适配旧API级别的依赖库:API 24/26需确保安装Android Support Library,API 28可根据Unity版本选择Android Support Library或AndroidX组件。
配置Unity的Android SDK路径
- 在Unity中依次进入
Edit > Preferences > External Tools,确认Android SDK路径指向你已安装目标API级别的SDK目录,而非其他未包含对应API的SDK路径。 - 点击Refresh按钮,让Unity重新识别已安装的SDK组件。
调整Player Settings中的关键配置
- 打开
File > Build Settings > Player Settings > Android > Publishing Settings,尝试切换Build System:若使用旧API级别,可选择Internal或Gradle (Legacy),新版Gradle对旧API的适配性较差。 - 确保
Minimum API Level设置不高于Target SDK级别,比如Target SDK设为24时,Minimum API Level不能超过24。 - 关闭Custom Main Gradle Template和Custom Launcher Gradle Template(如果之前开启过),先使用默认模板进行构建测试,避免自定义Gradle配置引发冲突。
清理Unity缓存
- 删除项目根目录下的
Library文件夹,重新打开项目,让Unity重新生成项目配置文件。 - 在
File > Build Settings中点击Clean Build,清除Android构建缓存后再尝试重新构建。
匹配JDK版本
- 旧API级别对JDK版本有要求:API 24/26建议使用JDK 8,API 29可兼容JDK 11。在Unity的
External Tools中切换JDK路径到对应版本,确保版本匹配。
内容的提问来源于stack exchange,提问作者ChocooPanda
相关产品推荐
相关产品推荐

