Android AndroidX的迁移

砸漏

发布于 2020-10-16 10:05:08

1.1K0

发布于 2020-10-16 10:05:08

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是不能共存的，