Android升级SDK至30版本后如何调整对应依赖配置
Android SDK 28 升级到 30 依赖适配操作指南
1. 升级核心官方依赖版本
所有和SDK版本绑定的官方支持类依赖统一升级到适配SDK 30的稳定版本:
- 仍在使用旧
com.android.support系列支持库的项目,先执行AndroidX迁移,再替换为对应AndroidX组件,版本不低于适配SDK 30的最低稳定版:
替换示例:
旧配置:implementation 'com.android.support:appcompat-v7:28.0.0'
新配置:implementation 'androidx.appcompat:appcompat:1.3.1' - 已使用AndroidX的项目直接升级核心组件版本:
androidx.core:core-ktx→ 1.6.0及以上com.google.android.material:material→ 1.4.0及以上- Kotlin项目同步升级Kotlin Gradle插件版本到1.5.0及以上,避免语法兼容问题
2. 升级第三方依赖版本
逐一检查项目引入的第三方依赖(网络请求、图片加载、业务组件等),对照官方发布日志升级到支持SDK 30的最小可用版本,避免存储权限、包可见性等Android 11特性适配缺失导致的运行时崩溃。
3. 统一依赖版本避免冲突
如果存在子模块、本地aar依赖的compileSdkVersion无法同步升级到30,或者远程依赖间接引入了低版本核心组件,可以在根目录build.gradle中添加强制版本统一规则,解决版本不一致导致的编译错误:
configurations.all { resolutionStrategy { force 'androidx.appcompat:appcompat:1.3.1' force 'androidx.core:core-ktx:1.6.0' // 其他需要强制统一版本的依赖可继续在此添加 } }
4. 编译验证
配置修改完成后执行清理编译命令验证结果:
- Mac/Linux:
./gradlew clean assembleDebug - Windows:
gradlew clean assembleDebug
如果出现依赖冲突报错,根据错误日志调整对应依赖的版本即可。
注意:未迁移AndroidX的项目需先在Android Studio中执行
Refactor > Migrate to AndroidX操作,完成后再执行上述升级步骤,否则会出现大量包名冲突错误。
内容的提问来源于stack exchange,提问作者mustyg123
相关产品推荐
相关产品推荐

