AndroidX的迁移

Google 2018 IO 大会推出了 Android新的扩展库 AndroidX，用于替换原来的 Android扩展库，将原来的android.替换成androidx.；只有包名和Maven工件名受到影响，原来的类名，方法名和字段名不会更改。接下来我们来看看使用 AndroidX的扩展库需要哪些配置。

1.Androidx的变化

Android(old)	AndroidX
com.android.support:appcompat-v7:28.0.2	androidx.appcompat:appcompat:1.0.0
com.android.support:design:28.0.2	com.google.android.material:material:1.0.0
android.support.v4.app.Fragment	androidx.fragment.app.Fragment
android.support.v7.app.ActionBar	androidx.appcompat.app.ActionBar

2.配置Androidx

1) 更新升级插件

将Android Studio 升级至3.2以上(我的是3.4)
Gradle 插件版本改为 4.6及以上(我的是5.1.1)
项目下 gradle/wrapper/gradle-wrapper.propertie 文件中的distributionUrl改为

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

compileSdkVersion 版本升级到 28及以上；
buildToolsVersion 版本改为 28.0.2及以上。

总之用Android Studio打开项目会提示有更新Gradle的界面,选择update就好

2) 在项目的gradle.properties文件里添加如下配置

android.useAndroidX=true
android.enableJetifier=true

意思是项目启用 AndroidX 并迁移到 AndroidX。

3）替换依赖库

修改Android/app目录下的build.gradle依赖库：

implementation 'com.android.support:appcompat-v7:28.0.2' → implementation 'androidx.appcompat:appcompat:1.0.0'
implementation 'com.android.support:design:28.0.2'  → implementation 'com.google.android.material:material:1.0.0'
implementation 'com.android.support.constraint:constraint-layout:1.1.2' → implementation 'androidx.constraintlayout:constraintlayout:1.1.2'
...

4）手动修改支持库类

import android.support.v7.app.AppCompatActivity; → import androidx.appcompat.app.AppCompatActivity;

5）一键迁移AndroidX库

Android Studio 3.2 及以上版本提供了更加方便快捷的方法一键迁移到 AndroidX。选择菜单上的ReFactor —— Migrate to AndroidX... 。（如果迁移失败，就需要重复上面1，2，3，4步手动去修改迁移）

12.png

如果你的项目compileSdkVersion 低于28，点击Refactor to AndroidX...会提示：

You need to have at least have compileSdk 28 set in your module build.gradle to refactor to androidx

升级最新到SDK，然后点击 Migrate to AndroidX...，AS就会自动将项目重构并使用AndroidX库。

5）参考

AndroidX 官方文档