Google 2018 IO 大會推出了 Android新的擴展庫 AndroidX,用於替換原來的 Android擴展庫,將原來的android.*替換成androidx.*;只有包名和Maven工件名受到影響,原來的類名,方法名和字段名不會更改。接下來我們來看看使用 AndroidX的擴展庫需要哪些配置
1. AndroidX變化
1).常用依賴庫對比:
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 |
更多詳細變化內容,可以下載CSV格式映射文件;
2).常用支持庫類對比:
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 |
更多詳細變化內容,可以下載CSV格式映射文件。
2. AndroidX配置
1)更新升級插件
- 將AS更新至 AS 3.2及以上;
- Gradle 插件版本改為 4.6及以上;
項目下gradle/wrapper/gradle-wrapper.propertie
文件中的distributionUrl
改為:
- compileSdkVersion 版本升級到 28及以上;
- buildToolsVersion 版本改為 28.0.2及以上。

2)開啟遷移AndroidX
在項目的gradle.properties
文件里添加如下配置:
表示項目啟用 AndroidX 並遷移到 AndroidX。
3)替換依賴庫
修改項目app目錄下的build.gradle
依賴庫:
4)修改支持庫類
將原來import
的android.**
包刪除,重新import
新的androidx.**
包;
5)一鍵遷移AndroidX庫
AS 3.2 及以上版本提供了更加方便快捷的方法一鍵遷移到 AndroidX。選擇菜單上的ReFactor —— Migrate to AndroidX... 即可。(如果遷移失敗,就需要重復上面1,2,3,4步手動去修改遷移)

注意:如果你的項目compileSdkVersion 低於28,點擊Refactor to AndroidX...會提示:
提示讓你使用不低於28的sdk,升級最新到SDK,然后點擊 Migrate to AndroidX...,AS就會自動將項目重構並使用AndroidX庫。