一、迁移前准备
重要提醒
为防止造成不必要的损失,在迁移前务必做好代码备份工作,可以提前先上传至托管平台,也可以进行手动备份;
环境配置
- Android Studio:将Android Studio版本升级更新为3.2及以上;
- Gradle: 将Gradle插件版本修改为4.6及以上;
- compileSdkVersion:版本修改为28及以上;
- buildToolsVersion: 版本修改为28.0.2及以上;
官方建议:因为AndroidX 1.0.0版本与Support Lib 28.0.0的二进制文件是一致的, 在迁移之前,应先将应用的Support Lib更新至最新版本version 28.0.0。
二、开始迁移
步骤1
在gradle.properties文件中添加如下配置用以表示项目启用AndroidX并迁移到AndroidX
android.useAndroidX=true
android.enableJetifier=true
步骤2
在AS中打开项目->点击菜单栏->Refactor->Migrate to AndroidX,如下图所示:
在点击“Migrate to AndroidX”选项后,会弹框提醒你备份项目,如下图所示:
备份完成后会看到一个搜索的弹框在动,搜索结束后再在下方的find可以看到,点击do refactor进行重构。AS会自动把你项目中的依赖切换到AndroidX,并且修改项目中使用到的依赖库路径。
步骤3
点击菜单栏->File->Invalidate Caches /Restart重启IDE,很多依赖包的缓存会让你在Refactor结束后各种报错,清除缓存重启下就可以了。