AndroidX 迁移

AndroidX.png

引言：Android Support Library Exit History.

作者：JustDo23

时间：2019年09月18日

官网：https://developer.android.google.cn/jetpack/androidx

01. 简单概览

• AndroidX 是 JetPack 中与操作系统 解除捆绑 并且 向后兼容 的开源项目。
• AndroidX 完全取代 Support 并提供新的功能及特性。
• 所有 Support 有关旧类 完整映射 到 AndroidX 中。
• AndroidX 使用严格的 语义版本控制 并可以进行 单独更新 。
• 语义版本控制

02. 初步使用

• 需要设置 compileSdkVersion 为 28 及以上
• 在 gradle.properties 文件中进行配置

# 是否指定使用 AndroidX
android.useAndroidX=true
# 是否将第三方依赖转换为 AndroidX
android.enableJetifier=true

• 若 useAndroidX 为 true 则 Android 插件 会自动使用相应的 AndroidX 而非 Support
• 若 enableJetifier 为 true 则 Android 插件 会重写第三方库的 二进制 文件，自动迁移 现有的第三方库 以使用 AndroidX

03. 项目迁移

• 使用 Android Studio 3.2 及更高版本
• 菜单栏依次选择 Refactor > Migrate to AndroidX
• 弹窗提示是否进行 项目备份
• 指定备份路径或者跳过备份
• 自动进行 项目扫描 并在 Find 中提示 所有引用
• 点击 Do Refactor 进行迁移
• 注意：这里并不是结束，有可能还有很多包名替换是错误的，需要手动调整

04. Glide

dependencies {
    implementation 'com.github.bumptech.glide:glide:4.9.0'// Glide
    annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'// Glide
}

如上配置，在 编译时 仍旧会报错，自动生成的文件总是引用 android.support.annotation.CheckResult 等 Support 注解包内的类。

apply plugin: 'kotlin-android'
apply plugin: 'kotlin-android-extensions'
apply plugin: 'kotlin-kapt'

classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.3.50"// Kotlin

dependencies {
    implementation 'com.github.bumptech.glide:glide:4.9.0'// Glide
    kapt 'com.github.bumptech.glide:compiler:4.9.0'// Glide
}

如上解决，项目原本没有引入 Kotlin 在引入之后使用 kapt 替换注解编译器，问题解决。

05. FileProvider

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.fileProvider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

如上结果，迁移 AndroidX 只需要修改 provider 节点下的 android:name 其余配置不变。

06. 迁移检查

• 执行指令来检查依赖关系

# 只查看 release 的依赖关系
$ ./gradlew app:dependencies --configuration releaseCompileClasspath

• 快捷键 Command + Shift + F 全局搜索 android.support
• 运行程序隐藏的编译错误

07. 个人经验

• 第一个项目本身引入了 Kotlin 在自动迁移之后需要手动修改很多错误的包名
• 第二个项目没有引入过 Kotlin 在自动迁移之后包名基本全部正确替换
• 可以尝试多次进行自动迁移操作以达到正确替换包名的目的

08. 包名替换

• 快捷键 Command + Shift + R 进行全局搜索替换

问题包名	新版包名
android.support.annotation.NonNull	androidx.annotation.NonNull
android.support.annotation.Nullable	androidx.annotation.Nullable
android.support.constraint.ConstraintLayout	androidx.constraintlayout.widget.ConstraintLayout
android.support.v4.widget.NestedScrollView	androidx.core.widget.NestedScrollView
android.support.v7.widget.RecyclerView	androidx.recyclerview.widget.RecyclerView
android.support.v7.widget.LinearLayoutManager	androidx.recyclerview.widget.LinearLayoutManager
android.support.constraint.Guideline	androidx.constraintlayout.widget.Guideline
android.support.v7.widget.CardView	androidx.cardview.widget.CardView
androidx.core.view.ViewPager	androidx.viewpager.widget.ViewPager
android.support.v4.view.PagerAdapter	androidx.viewpager.widget.PagerAdapter
android.support.v4.app.FragmentManager	androidx.fragment.app.FragmentManager
android.support.v4.app.FragmentTransaction	androidx.fragment.app.FragmentTransaction
android.support.v7.app.AppCompatDialog	androidx.appcompat.app.AppCompatDialog

09. 拓展阅读

• Android Developers
• Android 开发者
• Android:你好,androidX！再见,android.support