Android AndroidX的迁移

1. 前言

AndroidX replaces the original support library APIs with packages in the androidx namespace. Only the package and Maven artifact names changed; class, method, and field names did not change.，Google不再对android support库进行维护，android support中的API由命名空间AndroidX下的软件包进行替换，即相应的包名和Maven工件名发生改变。

2. 迁移AndroidX

2.1 迁移之前的准备

原有项目的support库版本升级至28(Android 9)，这也是support library的最后版本，SDK 28 和AndroidX 1.0 是等效的。This is because AndroidX artifacts with version 1.0.0 are binary equivalent to the Support Library 28.0.0 artifacts.，

compileSdkVersion 28

建议使用Android studio 3.2或更高版本，(当前最新版已经到了4.0)。

gradle-wrapper.properties中Gradle插件版本不低于4.6。

distributionUrl=https\://services.gradle.org/distributions/gradle-5.4.1-all.zip

如果代码在版本控制器中，建议在单独的分支中迁移。

2.2 执行迁移

在gradle.properties文件中添加下列项。

# Android 插件会使用对应的 AndroidX 库而非支持库。
android.useAndroidX=true
# Android 插件会通过重写现有第三方库的二进制文件，自动将这些库迁移为使用 AndroidX，但并不完全自动。
android.enableJetifier=true

如果是AS 3.2或更高版本，则提供了一键迁移，选择菜单Refactor-> Migrate to AndroidX，会提示备份当前工程，勾选Backup project as Zip file，可以自动帮你备份。

左下角提示，点击Do Refactor

3 迁移结果

在一键迁移之后，gradle文件中implementation的所有support库被androidx替换，比如

implementation 'com.android.support:appcompat-v7:28.0.0' 
变为
implementation 'androidx.appcompat:appcompat:1.0.0'

相应类名也会发生改变

import android.support.v7.app.AppCompatActivity;
变为
import androidx.appcompat.app.AppCompatActivity;

所以，可以先看看上面两项结果，如果没有替换成功，可手动替换，相应替换可查阅官方提供的CSV格式的依赖库映射文件和类映射文件。

rebuild project，如果编译通过，那么恭喜你了，我反正是失败了。

4 迁移出错

4.1 可手动纠正的错

有的文件中没能替换掉，需要按照上述两项映射手动替换。

检查gradle中通过implementation引入的库，比如implementation androidx.recyclerview:recyclerview:1.0.0'，则一键迁移后导入的类为import androidx.appcompat.widget.RecyclerView;，需要替换为import androidx.recyclerview.widget.RecyclerView;，猜测只是全局替换掉support字样。因为类似还有GridLayoutManager、FragmentTransaction;`等。

4.2 第三方库冲突

support库和androidx是不能共存的，

• 情况1 ：当迁移结束之后，理论上讲自己的项目使用的是androidx，但是老项目中导入了许多第三方的库，这些旧版本的库使用的是support。
• 情况2：这种情况发生在未进行迁移的项目中，由于导入了最新版的第三方库，而该库使用了androidx，也会报错。

解决方法：

• 情况1，更新第三方库到最新版本或使用androidx的版本，如果这个库没有使用androidx的版本，那就要找其他的方案代替吧（不知道是否是正确的解决方案）。
• 情况2：使用旧版本的第三方库。

总之，就是多build，根据异常信息解决问题。

5 参考资料

AndroidX预览

官方迁移教程

谷歌开发者-是时候迁移至 AndroidX 了