AndroidX迁移
什么是 AndroidX?
Google 2018 IO 大会推出了 Android新的扩展库 AndroidX,用于替换原来的 Android扩展库,将原来的android.替换成androidx.
AndroidX 会将原始支持库 API 软件包映射到 androidx 命名空间。只有软件包和 Maven 工件名称发生了变化;类、方法和字段名称没有改变。
在此之前的开发中,开发者为了兼容安卓较低版本操作系统会依赖support-v4、appcompat-v7这些 依赖库。比如你开发Fragment,就需要 import android.support.v4.app.Fragment
,然而在 AndroidX中我们需要 androidx.fragment.app.Fragment
如何迁移?
一键迁移
可以通过从菜单栏中依次选择 Refactor > Migrate to AndroidX来实现迁移。虽然操作简单,但是往往这种方式并不能实现迁移,于是更多的是通过手动迁移来实现。
手动迁移步骤如下:
1.将 AndroidStudio更新至3.0或更高。
2.Gradle 插件版本改为 4.6或更高。
3.更改 gradle.properties
在 gradle.properties文件中添加 android.useAndroidX=true android.enableJetifier=true
这两句话。
*其中android.useAndroidX=true是指项目工程依赖 于AndroidX
*其中android.enableJetifier=true是指项目工程中的第三方库依赖 于AndroidX,有时为了保证第三方库不受影响可以 android.enableJetifier=true
此时表示第三方库不会迁移为 AndroidX
4.替换build.gradle中的依赖库
将原来implementation的android.包替换为androidx.包
例如: implementation 'com.android.support:appcompat-v7:28.0.0
替换为 implementation 'androidx.appcompat:appcompat:1.1.0
5.修改类、Activity、Fragment中的引用
例如:
import android.support.v7.app.AppCompatActivity
替换为import androidx.appcompat.app.AppCompatActivity
旧版本依赖库与 AndroidX 依赖库对应
旧版本 | 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 |
com.android.support:support-v4:28.0.2 | androidx.legacy:legacy-support-v4:1.0.0 |
com.android.support:recyclerview-v7:28.0.2 | androidx.recyclerview:recyclerview:1.0.0 |
com.android.support.constraint:constraint-layout:1.1.2 | androidx.constraintlayout:constraintlayout:1.1.2 |
android.support.v4.app.Fragment | androidx.fragment.app.Fragment |
android.support.v4.app.FragmentActivity | androidx.fragment.app.FragmentActivity |
android.support.v7.app.AppCompatActivity | androidx.appcompat.app.AppCompatActivity |
android.support.v7.app.ActionBar | androidx.appcompat.app.ActionBar |
android.support.v7.widget.RecyclerView | androidx.recyclerview.widget.RecyclerView |
android.support.v4.content.FileProvider | androidx.core.content.FileProvider |
android.support.annotation.NonNull | androidx.annotation.NonNull |
android.support.annotation.Nullable | androidx.annotation.Nullable |
androidx.core.view.ViewPager | androidx.viewpager.widget.ViewPager |