190325 補充：莫名問題的解決
181106 補充：修改未遷移成功的三方庫
1、AndroidX簡介
按照官方文檔說明 androidx 是對 android.support.xxx 包的整理后產物。由於之前的support包過於混亂，所以，google推出了 androidX。
由於在后續版本中，會逐步放棄對support 的升級和維護，所以，我們必須遷移到 androidX.對此，官方描述如下：
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. 2、遷移步驟
2.1 修改gradle.properties
android.useAndroidX=true android.enableJetifier=true 其中：
android.useAndroidX=true表示當前項目啟用 androidxandroid.enableJetifier=true表示將依賴包也遷移到androidx 。如果取值為false,表示不遷移依賴包到androidx，但在使用依賴包中的內容時可能會出現問題，當然了，如果你的項目中沒有使用任何三方依賴，那么，此項可以設置為false
2.2 如何遷移
在AndroidStudio 3.2 或更高版本（目前最新正式版為3.2，其他更高版為alpha版）中執行如下操作：
-
Refactor > Migrate to AndroidX
image
在執行該操作時會提醒我們是否將當前項目打包備份。如果你提前已經做好了備份，可以忽略；如果沒有備份，則先備份。
3 遷移后續
3.1 手動修改錯誤包名
由於 Migrate to AndroidX 執行之后，部分控件的包名/路徑名轉換的有問題，所以還需要我們手動調整（包括修改xml布局文件和.java/.kt 文件）。
如：ViewPager,RecyclerView 等，這些內容在遷移完成之后，包名是 androidx.core.weight.xxxx,這是一個錯誤的包名，我們必須手動修改，否則，無法正常編譯——點擊綠色 Run(運行) 按鈕時會詳細報出哪里有錯誤。
此處需要注意，在 AndroidStudio 的 build 選項卡中一次最多只會報 50條錯誤！！ 所以，可能在你修完第一批之后，后面還有N個50。此處要保持一個平靜的💗。
3.2 修復DataBinding中的錯誤（重名id錯誤）
在 AndroidStudio3.2 + androidx 環境下，對錯誤的檢查和處理更為嚴格。如果同一個xml布局文件中存在同名id，在之前的版本中，我們可以正常編譯和運行，但是，在新的環境下， 必然會報錯，錯誤信息如下：
在上圖的錯誤信息中，我們以 DecibelBinding 為例，簡述修復過程。
-
如上圖，
無法將xxxBinding 構造器中的xxxBinding應用到指定類型指明了出錯的 Binding類 為 DecibelBinding -
按照DataBinding類名的生成規則，我們可以知道，DecibelBinding 對應的xml文件名應該是 decibel.xml (如果你在xml中通過 class="xxxBinding" 指定了DataBinding的生成類名，那么就全局搜索吧)
-
在確定了xml之后，我們還需要知道到底哪里出了錯誤，那么，就繼續看圖中的
錯誤：找不到符號 符號：變量 xxx.這個變量就是控件的id名稱。 -
DataBinding轉換控件id名的規則是：去除下划線連接符，然后將原下划線后面的第一個字母大寫。所以，圖中的 fragmentDiscoverGridItemRelativeLayout1 對應的控件id應該是：
@+id/fragment_discover_grid_item_relative_layout,后面之所以有一個1 ，是因為重復了。然后，我們在對應的xml文件中搜索這個控件名，然后刪除重復即可。
3.3 去除 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> 關於重名屬性，在 androidX 中不知道哪個控件中包含了一個 mode 屬性，所以，如果之前你的自定義控件中有 attr/mode，需要手動改成其他。
3.4 Glide中的注解不兼容androidX
遷移到 androidX 之后，Glide中使用的 android.support.annotation.CheckResult 和 android.support.annotation.NonNull這兩個注解無法遷移。之前有用戶在Glide中提過issue: https://github.com/bumptech/glide/issues/3185
在上述issue 中有用戶表示，將Glide升級到 4.8.0 之后，可以正常遷移。但是，我這邊並不行。然后，我先升級了Glide ,又在 gralde文件中增加了support.annotation ，這樣才能正常編譯通過。貌似在后續Glide 5.x 版本中會完成對 androidx的完全兼容。
我的臨時解決方案：
//圖片加載——Glide implementation "com.github.bumptech.glide:glide:4.8.0 annotationProcessor "com.github.bumptech.glide:compiler:4.8.0 //CnPeng 2018/9/26 下午8:38 這兩行是為了解決 https://github.com/bumptech/glide/issues/3185 ——Glide 中的注解還沒有完全兼容androidx implementation "com.android.support:support-annotations:28.0.0-alpha3" annotationProcessor "com.android.support:support-annotations:28.0.0-alpha3" 3.5 規范包名（即文件夾名）
這里所說的包名，指的是項目中的文件夾名稱。在之前版本中，我們命名包名時可能會出現大寫字母，雖然這並不符合Java命名規范，但起碼能正常編譯和運行。然而，升級到 AndroidStudio3.2 + androidX 環境后，必須嚴格遵守命名規范，否則，可能報錯，從而導致不能正常編譯和運行。
錯誤示例：
正確示例：
對於包名的命名規范，好像要求並非十分嚴格。因為我發現，部分包含大寫字母的報名在編譯時會報錯，部分不報錯。但是，遵守規范總會更好一點！
3.6 修改未自動遷移的三方庫
181108補充：
雖然我們從gradle中配置了遷移三方庫的參數，但是，由於三方庫的版本更新問題，也可能會遷移失敗。在三方庫遷移失敗時，如果使用了數據綁定，通常會報如下錯誤：
碰到上述錯誤之后，我們可以按下列步驟處理：
- 1、在gradle文件中，將可升級的三方庫升級（通常情況下，可升級的三方庫會有黃色提示）
- 2、如果gradle中可升級的庫都升級之后依舊報上述錯誤，那么，可以新建一個項目，然后將gradle中的依賴庫逐個拷貝到新項目中，沒拷貝一個編譯一次，這樣可以確認是哪個三方庫有問題。（實際操作時可以使用二分法的方式進行，每次拷貝一半的依賴庫，然后編譯）。然后就可以有針對性的處理了
3.7 莫名問題的解決
190325 補充：
遷移過程中如果爆出一些 android 包本身或者其他莫名其妙的問題時，先去 xml 布局文件 或 .java 文件中找一下，是否有繼續引用 xxx.support.xxx 的情況，如果有，記得替換成 androidx.xxx.xxx 包下的對應控件。（ xxx 泛指任意內容）
作者：CnPeng
鏈接：https://www.jianshu.com/p/41de8689615d
來源：簡書
簡書著作權歸作者所有，任何形式的轉載都請聯系作者獲得授權並注明出處。