AndroidX迁移注意事项

482 阅读1分钟

1 升级配置

  • AS升级至最新版(3.2及以上)
  • 工程的build.gradle中Android插件升级至最新版(3.2及以上)
classpath 'com.android.tools.build:gradle:3.6.2'
  • Gradle升级至最新版本(4.6及以上)
distributionUrl=https\://services.gradle.org/distributions/gradle-5.6.4-all.zip
  • 开启AndroidX标识(gradle.properties)
android.useAndroidX=true
android.enableJetifier=true
  • compileSdkVersion 版本升级到 28及以上;

  • buildToolsVersion 版本改为 28.0.2及以上。

  • 替换依赖库

//androidx依赖迁移示例
implementation "com.android.support:appcompat-v7:28.0.0" --> implementation 'androidx.appcompat:appcompat:1.1.0'

具体依赖库的映射关系请参考官方文档 工件映射

尽量保持AndroidX依赖库使用最新版本,最新版本请查阅AndroidX版本

2 替换相关类

虽然按照以上第一步配置后,可以使用AS的Migrate to AndroidX...功能一键迁移,但仍会有错误的地方,建议使用手动方式全局替换

根据编译或运行项目时的报错提示,参照类的映射表,手动全局替换相关类(主要是import,布局文件里的标签)

3 官方文档传送门