Android 迁移到 AndroidX 的注意事项

一、迁移前准备

重要提醒

为防止造成不必要的损失，在迁移前务必做好代码备份工作，可以提前先上传至托管平台，也可以进行手动备份；

环境配置

1. Android Studio：将Android Studio版本升级更新为3.2及以上；
2. Gradle： 将Gradle插件版本修改为4.6及以上；
3. compileSdkVersion：版本修改为28及以上；
4. 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结束后各种报错，清除缓存重启下就可以了。