還在用android.support？該考慮遷移AndroidX了！

AndroidX是Google 2018 IO 大會推出的新擴展庫，主要是對Android 支持庫作了重大改進。與支持庫同樣，AndroidX 與 Android 操做系統分開提供，並與各個 Android 版本向後兼容，能夠說AndroidX就是爲了替換Android支持庫而設計的。

AndroidX是什麼？

• AndroidX 是 Android 團隊用於在 Jetpack 中開發、測試、打包和發佈庫以及對其進行版本控制的開源項目。[摘自官方]
• AndroidX徹底取代了支持庫，不只提供同等的功能，並且提供了新的庫。
• AndroidX 會將原始支持庫 API 軟件包映射到 androidx 命名空間。只有軟件包和 Maven 工件名稱發生了變化；類、方法和字段名稱沒有改變。
• 與支持庫不一樣，AndroidX 軟件包會單獨維護和更新。androidx 軟件包使用嚴格的語義版本控制，從版本 1.0.0 開始,能夠單獨更新項目中的 AndroidX 庫。
• 全部新支持庫的開發工做都將在 AndroidX 庫中進行,這包括維護原始支持庫工件和引入新的 Jetpack 組件。

AndroidX的變化

1.常見依賴庫映射

舊編譯工件	AndroidX 編譯工件
com.android.support.constraint:constraint-layout	androidx.constraintlayout:constraintlayout:1.1.2
com.android.support:appcompat-v7	androidx.appcompat:appcompat:1.0.0
com.android.support:cardview-v7	androidx.cardview:cardview:1.0.0
com.android.support:coordinatorlayout	androidx.coordinatorlayout:coordinatorlayout:1.0.0
com.android.support:design	com.google.android.material:material:1.0.0-rc01
com.android.support:drawerlayout	androidx.drawerlayout:drawerlayout:1.0.0
com.android.support:gridlayout-v7	androidx.gridlayout:gridlayout:1.0.0
com.android.support:media2	androidx.media2:media2:1.0.0-alpha03
com.android.support:multidex	androidx.multidex:multidex:2.0.0
com.android.support:percent	androidx.percentlayout:percentlayout:1.0.0
com.android.support:recyclerview-v7	androidx.recyclerview:recyclerview:1.0.0
com.android.support:support-annotations	androidx.annotation:annotation:1.0.0
com.android.support:support-compat	androidx.core:core:1.0.0
com.android.support:support-fragment	androidx.fragment:fragment:1.0.0
com.android.support:support-v4	androidx.legacy:legacy-support-v4:1.0.0
com.android.support:viewpager	androidx.viewpager:viewpager:1.0.0
com.android.support:swiperefreshlayout	androidx.swiperefreshlayout:swiperefreshlayout:1.0.0

更多詳細依賴庫變化，可查閱官方文檔或下載這些映射的 CSV 格式文件。

2.常見類映射

支持庫類	AndroidX 類
android.arch.lifecycle.Lifecycle	androidx.lifecycle.Lifecycle
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
android.support.design.card.MaterialCardView	com.google.android.material.card.MaterialCardView
android.support.design.ripple.RippleUtils	com.google.android.material.ripple.RippleUtils
android.support.design.widget.CoordinatorLayout	androidx.coordinatorlayout.widget.CoordinatorLayout
android.support.design.widget.NavigationView	com.google.android.material.navigation.NavigationView
android.support.percent.PercentFrameLayout	androidx.percentlayout.widget.PercentFrameLayout

更多詳細支持類映射變化，可查閱官方文檔或下載這些映射的 CSV 格式文件。

爲何要遷移AndroidX？

下面是Google官方描述

Existing packages, such as the Android Support Library, are being refactored into AndroidX.
Although Support Library versions 27 and lower are still available on Google Maven,
all new development will be included in only AndroidX versions 1.0.0 and higher.
複製代碼

• 大體意思是：現有的軟件包，如Android支持庫，正在被重構爲Androidx。儘管在Google Maven上仍然提供支持庫版本27及更低版本，但全部新開發將只包含在Androidx 1.0.0及更高版本中。

AndroidX遷移步驟？

1.更新Android Studio與Gradle版本

• 將Android studio升級到 3.2及以上；
• Gradle 插件版本改成4.6及以上；
• compileSdkVersion 版本升級到 28及以上；
• buildToolsVersion 版本改成 28.0.2及以上。

2.遷移AndroidX配置

• 在項目的gradle.properties文件裏添加以下配置：

android.useAndroidX=true
android.enableJetifier=true
複製代碼

配置	說明
android.useAndroidX=true	表示當前項目啓用 androidx
android.enableJetifier=true	表示將依賴包也遷移到androidx

備註：enableJetifier若是取值爲false,表示不遷移依賴包到androidx，但在使用依賴包中的內容時可能會出現問題，固然了，若是你的項目中沒有使用任何三方依賴，那麼，此項能夠設置爲false。

3.修改依賴庫
修改項目app目錄下的build.gradle依賴庫，具體能夠參照AndroidX變化中的依賴庫映射。

修改前	修改後
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.依賴類從新導包
將原來import的android.**包刪除，從新import新的androidx.**包

import android.support.v7.app.AppCompatActivity; → import androidx.appcompat.app.AppCompatActivity;
複製代碼

5.一鍵遷移AndroidX庫
AS 3.2 及以上版本提供了更加方便快捷的方法一鍵遷移到 AndroidX。選擇菜單上的ReFactor —— Migrate to AndroidX... 便可。（若是遷移失敗，就須要重複上面1，2，3，4步手動去修改遷移）

備註：若是你的項目compileSdkVersion 低於28，點擊Refactor to AndroidX...會提示：

Q&A

• 同一個項目中Android Support和AndroidX能夠共存嗎？

不能夠共存。須要將依賴修改成Android Suppor或AndroidX中任一種。
複製代碼

• 執行Migrate to AndroidX以後就完成AndroidX遷移了？

不必定。部分控件的包名/路徑名轉換的有問題，因此還須要咱們手動調整（包括修改xml佈局文件和.java/.kt 文件）。
複製代碼

• DataBinding中的錯誤（重名id錯誤）？

在 AndroidStudio3.2 + androidx 環境下，對錯誤的檢查和處理更爲嚴格。若是同一個xml佈局文件中存在同名id，
在以前的版本中，咱們能夠正常編譯和運行，可是，在新的環境下， 必然會報錯，錯誤信息以下：
複製代碼

• attr.xml 中重複的屬性名稱會報錯？

在遷移到 androidX 以前，咱們爲自定義控件編寫自定義屬性時，能夠與android已有的屬性重名，
可是，在AndroidX環境下不行了，若是存在重名的狀況，必然會報錯——會提示你重複定義（詳細錯
誤信息沒截圖，但翻譯過來就是重複定義了attr/xxx）。
複製代碼

• 錯誤示例

<declare-styleable name="RoundImageView">
    ...
    <!-在遷移到androidx以前，這樣寫雖然不規範，可是能用，不報錯->
    <attr name="textSize" format="Integer" />
    ...
</declare-styleable>
複製代碼

• 正確示例

<declare-styleable name="RoundImageView">
    ...
    <!-遷移到androidX以後，必須使用android:xxx 屬性，不能定義android已有的屬性->
    <attr name="android:textSize" />
    ...    
</declare-styleable>
複製代碼

• Glide中的註解不兼容androidX？
  遷移到 androidX 以後，Glide中使用的 android.support.annotation.CheckResult 和 android.support.annotation.NonNull這兩個註解沒法遷移。以前有用戶在Glide中提過issue: github.com/bumptech/gl…
  在上述issue 中有用戶表示，將Glide升級到 4.8.0 以後，能夠正常遷移。可是，我這邊並不行。而後，我先升級了Glide ,又在 gralde文件中增長了support.annotation ，這樣才能正常編譯經過。貌似在後續Glide 5.x 版本中會完成對 androidx的徹底兼容。

• 規範包名（即文件夾名）?
  這裏所說的包名，指的是項目中的文件夾名稱。在以前版本中，咱們命名包名時可能會出現大寫字母，雖然這並不符合Java命名規範，但起碼能正常編譯和運行。然而，升級到 AndroidStudio3.2 + androidX 環境後，必須嚴格遵照命名規範，不然，可能報錯，從而致使不能正常編譯和運行。

參考:

• AndroidX官方文檔
• Android Support庫和AndroidX衝突問題
• Android:你好,androidX！再見,android.support
• Android AndroidX的遷移