迁移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 执行迁移

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

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

2. 若是是AS 3.2或更高版本，则提供了一键迁移，选择菜单Refactor-> Migrate to AndroidX，会提示备份当前工程，勾选Backup project as Zip file，能够自动帮你备份。
   
3. 左下角提示，点击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 可手动纠正的错

1. 有的文件中没能替换掉，须要按照上述两项映射手动替换。
2. 检查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 了

---

本文如有出入，请指正！
我是小小范同窗。

---

本文由博客一文多发平台 OpenWrite 发布！