参考链接
本次迁移主要参考上面谷歌官方公众号文章,迁移背景建议点进文章进行查看,本文主要提及一些迁移过程和其中遇到的坑

重要提醒

迁移开始之前,不管你的项目用的是svn还是git 都确认本地代码无修改并且是分支上最新代码,建议在电脑上新建个文件夹,把分支上代码拉下来专门做androidX迁移,这样到时候既是迁移不成功,把该文件夹删掉就行了,跟你的小伙伴们商量好迁移的事项,像我这一个人的话,就随便了

如果你的项目不是使用AndroidStudio开发的本文中的一些步骤可能不太适用,确保AndroidStudio使用3.5+版本

关于Gradle版本问题

如果你的项目使用的是 美团的walle 打包,不要把gradle版本升级到最新的4.0,停留在3.63就行.问题一大堆了

如图

gradle配置参考

参考示例

项目的gradle文件
dependencies {
        classpath "com.android.tools.build:gradle:3.6.3"
    }

项目的gradle文件夹

gradle文件夹

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-5.6.4-all.zip

迁移步骤

迁移步骤示意图

1,将项目中所有的Support库升级到28

参考版本和示例

    implementation 'com.android.support.constraint:constraint-layout:1.1.3'
    implementation 'com.android.support:support-core-ui:28.0.0'
    implementation 'com.android.support:support-core-utils:28.0.0'
    implementation 'com.android.support:support-fragment:28.0.0'
    implementation 'com.android.support:support-vector-drawable:28.0.0'
    implementation 'com.android.support:animated-vector-drawable:28.0.0'
    implementation 'com.android.support:appcompat-v7:28.0.0'
    implementation 'com.android.support:support-v4:28.0.0'
    implementation 'com.android.support:design:28.0.0'
    implementation 'com.android.support:recyclerview-v7:28.0.0'
    implementation 'com.android.support:cardview-v7:28.0.0'

这一步应该没问题,无非就是涉及到一些Api的改动

2,开启 Jetifier

项目的gradle.properties添加

android.useAndroidX=true
android.enableJetifier=true

修改好之后,确保 clean rebuild run 都没问题 在进行下一步

3,将项目依赖的所有第三方库全部升级

个人认为这一步最重要,当然选择第三方sdk要适用于你的项目,比如okhttp4,rxjava3等底层都换了其实用rx2最新的版本就行,glide等改动不太大的直接升级最新版本就行

如果检测到第三方SDK还没有适配AndroidX,并且是项目必须依赖的,那么就此放弃,以下内容不用再看了!!!

---3.1前方巨坑,坑了我两天

因为项目中使用了 支付宝sdk,微信支付登录sdk,大厂自然不用说,不存在一些java版本的兼容问题

但是 我们还是用了汇付宝

之前项目中一直使用的是汇付宝3.0的版本,最新的版本是4.0,这次升级sdk时遗漏了汇付宝的sdk升级 导致最终打包时一直报错,说某个方法不存在之类的,吭哧了两天 ,从头开始弄才得以解决

3.2升级Butterknife

butterknife从10.0开始已经支持androidx了,我们直接升级到最新的10.2.1版本即可,需要在app下的gradle中配置编译jdk版本

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }

JDK8下载: 官网下载地址,不知道从几何时下载jdk也需要登录账号了,注册账号的流程又TM那么复杂,好在前人已经填坑了,直接给出的自己注册的账号

1772885836@qq.com 
OracleTest1234

或者
2696671285@qq.com 
密码：Oracle123

账号引用链接,再次感谢

3.3升级BaseRecyclerViewAdapterHelper

最新的3.0.4支持androidx并且用kotlin重写,但是一些api改动比较大,
像item中view的点击事件,加载更多等,一想到项目中那么多列表 我滴个亲娘嘞,没办法升级总是痛苦的,就是个复制粘贴的工作,干就得了奥利给!

修改好之后,确保 clean rebuild run 都没问题 在进行下一步

4,使用AndroidStudio 将Support库转换AndroidX

Migrate to AndroidX

AndroidStudio导航

过程中会提示你备份当前工程,备份一下就进行下一步,经过一段时间后成功了,

需要注意的是,AndroidStudio转换后有时候并没有把所有的XML布局都能转换成功,有一些布局文件会遗漏

这个时候就需要我们自己手动进行替换

4.1库替换

官方提供库的映射表,可以用Ctrl+F 在本页面查找.找到对应的库并且选择合适的版本

4.2包名替换

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

本次替换用到了这些,如果有新的 再往里面添加吧

到这一步基本上就完成迁移了

5,确认问题环节

1. 确保 clean rebuild run 都没问题
2. 使用迁移后的代码打release包,在真机上运行无误

下班吧 迁移完成了 GO! GO! GO!