參考鏈接
本次遷移主要參考上面谷歌官方公眾號文章,遷移背景建議點(diǎn)進(jìn)文章進(jìn)行查看,本文主要提及一些遷移過程和其中遇到的坑

重要提醒

遷移開始之前,不管你的項(xiàng)目用的是svn還是git 都確認(rèn)本地代碼無修改并且是分支上最新代碼,建議在電腦上新建個文件夾,把分支上代碼拉下來專門做androidX遷移,這樣到時候既是遷移不成功,把該文件夾刪掉就行了,跟你的小伙伴們商量好遷移的事項(xiàng),像我這一個人的話,就隨便了

如果你的項(xiàng)目不是使用AndroidStudio開發(fā)的本文中的一些步驟可能不太適用,確保AndroidStudio使用3.5+版本

關(guān)于Gradle版本問題

如果你的項(xiàng)目使用的是 美團(tuán)的walle 打包,不要把gradle版本升級到最新的4.0,停留在3.63就行.問題一大堆了

如圖

gradle配置參考

參考示例

項(xiàng)目的gradle文件
dependencies {
        classpath "com.android.tools.build:gradle:3.6.3"
    }

項(xiàng)目的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,將項(xiàng)目中所有的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'

這一步應(yīng)該沒問題,無非就是涉及到一些Api的改動

2,開啟 Jetifier

項(xiàng)目的gradle.properties添加

android.useAndroidX=true
android.enableJetifier=true

修改好之后,確保 clean rebuild run 都沒問題 在進(jìn)行下一步

3,將項(xiàng)目依賴的所有第三方庫全部升級

個人認(rèn)為這一步最重要,當(dāng)然選擇第三方sdk要適用于你的項(xiàng)目,比如okhttp4,rxjava3等底層都換了其實(shí)用rx2最新的版本就行,glide等改動不太大的直接升級最新版本就行

如果檢測到第三方SDK還沒有適配AndroidX,并且是項(xiàng)目必須依賴的,那么就此放棄,以下內(nèi)容不用再看了!!!

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

因?yàn)轫?xiàng)目中使用了 支付寶sdk,微信支付登錄sdk,大廠自然不用說,不存在一些java版本的兼容問題

但是 我們還是用了匯付寶

之前項(xiàng)目中一直使用的是匯付寶3.0的版本,最新的版本是4.0,這次升級sdk時遺漏了匯付寶的sdk升級 導(dǎo)致最終打包時一直報錯,說某個方法不存在之類的,吭哧了兩天 ,從頭開始弄才得以解決

3.2升級Butterknife

butterknife從10.0開始已經(jīng)支持androidx了,我們直接升級到最新的10.2.1版本即可,需要在app下的gradle中配置編譯jdk版本

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

JDK8下載: 官網(wǎng)下載地址,不知道從幾何時下載jdk也需要登錄賬號了,注冊賬號的流程又TM那么復(fù)雜,好在前人已經(jīng)填坑了,直接給出的自己注冊的賬號

1772885836@qq.com 
OracleTest1234

或者
2696671285@qq.com 
密碼：Oracle123

賬號引用鏈接,再次感謝

3.3升級BaseRecyclerViewAdapterHelper

最新的3.0.4支持androidx并且用kotlin重寫,但是一些api改動比較大,
像item中view的點(diǎn)擊事件,加載更多等,一想到項(xiàng)目中那么多列表 我滴個親娘嘞,沒辦法升級總是痛苦的,就是個復(fù)制粘貼的工作,干就得了奧利給!

修改好之后,確保 clean rebuild run 都沒問題 在進(jìn)行下一步

4,使用AndroidStudio 將Support庫轉(zhuǎn)換AndroidX

Migrate to AndroidX

AndroidStudio導(dǎo)航

過程中會提示你備份當(dāng)前工程,備份一下就進(jìn)行下一步,經(jīng)過一段時間后成功了,

需要注意的是,AndroidStudio轉(zhuǎn)換后有時候并沒有把所有的XML布局都能轉(zhuǎn)換成功,有一些布局文件會遺漏

這個時候就需要我們自己手動進(jìn)行替換

4.1庫替換

官方提供庫的映射表,可以用Ctrl+F 在本頁面查找.找到對應(yīng)的庫并且選擇合適的版本

4.2包名替換

快捷鍵 Ctrl + Shift + R 進(jìn)行全局搜索替換

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

到這一步基本上就完成遷移了

5,確認(rèn)問題環(huán)節(jié)

1. 確保 clean rebuild run 都沒問題
2. 使用遷移后的代碼打release包,在真機(jī)上運(yùn)行無誤

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