原文地址:http://www.itdecent.cn/p/7dc111353328
Google 2018 IO 大會(huì)推出了 Android新的擴(kuò)展庫(kù) AndroidX,用于替換原來(lái)的 Android擴(kuò)展庫(kù),將原來(lái)的android.*替換成androidx.*;只有包名和Maven工件名受到影響,原來(lái)的類(lèi)名,方法名和字段名不會(huì)更改。接下來(lái)我們來(lái)看看使用 AndroidX的擴(kuò)展庫(kù)需要哪些配置。
1. AndroidX變化
1)常用依賴庫(kù)對(duì)比:
| Old build artifact | AndroidX build artifact |
|---|---|
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 |
更多詳細(xì)變化內(nèi)容,可以下載CSV格式映射文件;
2)常用支持庫(kù)類(lèi)對(duì)比:
| Support Library class | AndroidX class |
|---|---|
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 |
更多詳細(xì)變化內(nèi)容,可以下載CSV格式映射文件。
2. AndroidX配置
1)更新升級(jí)插件
- 將AS更新至 AS 3.2及以上;
- Gradle 插件版本改為 4.6及以上;
項(xiàng)目下gradle/wrapper/gradle-wrapper.propertie文件中的distributionUrl改為:
distributionUrl=https\://services.gradle.org/distributions/gradle-4.6-all.zip
- compileSdkVersion 版本升級(jí)到 28及以上;
- buildToolsVersion 版本改為 28.0.2及以上。

2)開(kāi)啟遷移AndroidX
?在項(xiàng)目的gradle.properties文件里添加如下配置:
android.useAndroidX=true
android.enableJetifier=true
表示項(xiàng)目啟用 AndroidX 并遷移到 AndroidX。
3)替換依賴庫(kù)
?修改項(xiàng)目app目錄下的build.gradle依賴庫(kù):
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)修改支持庫(kù)類(lèi)
?將原來(lái)import的android.**包刪除,重新import新的androidx.**包;
import android.support.v7.app.AppCompatActivity; → import androidx.appcompat.app.AppCompatActivity;
5)一鍵遷移AndroidX庫(kù)
?AS 3.2 及以上版本提供了更加方便快捷的方法一鍵遷移到 AndroidX。選擇菜單上的ReFactor —— Migrate to AndroidX... 即可。(如果遷移失敗,就需要重復(fù)上面1,2,3,4步手動(dòng)去修改遷移)

注意:如果你的項(xiàng)目compileSdkVersion 低于28,點(diǎn)擊Refactor to AndroidX...會(huì)提示:
You need to have at least have compileSdk 28 set in your module build.gradle to refactor to androidx
提示讓你使用不低于28的sdk,升級(jí)最新到SDK,然后點(diǎn)擊 Migrate to AndroidX...,AS就會(huì)自動(dòng)將項(xiàng)目重構(gòu)并使用AndroidX庫(kù)。
3. AndroidX影響
雖然說(shuō)目前對(duì)我們沒(méi)有多大影響,我們可以不使用仍然使用舊版本的支持庫(kù),畢竟沒(méi)有強(qiáng)制,但長(zhǎng)遠(yuǎn)來(lái)看還是有好處的。AndroidX重新設(shè)計(jì)了包結(jié)構(gòu),旨在鼓勵(lì)庫(kù)的小型化,支持庫(kù)和架構(gòu)組件包的名字也都簡(jiǎn)化了;而且也是減輕Android生態(tài)系統(tǒng)碎片化的有效方式。
4. AndroidX遷移問(wèn)題
Android Support庫(kù)和AndroidX沖突問(wèn)題