為什么遷移
現在來說,那就又是去年的事情了。到目前為止,androidx 庫很多版本已經推出了正式穩定版,版本詳情戳這里。對比以前 support 包, androidx 將各個 library 分開設立單獨的版本管理,這樣的好處顯而易見。第一沒有了之前 v4 v7 的繁瑣依賴。第二可以精確指定需要導入 library ,避免不必要的導入,從而減少代碼體積。關鍵新的 library 版本完全遵循 Semantic Versioning,而不是跟著 Android API 版本走。這樣讓我們通過版本號就能明確和當前代碼是否兼容。
還有一點,現在很多開源項目已經陸續完成 androidx 遷移,并且基本不再對 support 提供最新支持。如果你不跟上這個節奏,那么今后你就沒法升級相關依賴,老版本 bug 修復你也得不到任何支持。
怎么遷移
遷移已經超級超級簡單。Google 已經考慮到我們的遷移成本,在 Android Studio 中已經支持一鍵遷移。
這個的前提是你得更新你的 Android Studio 版本和 gradle 的版本。請注意,這兩個的版本都要更新。Android Studio 最低要求是 3.2 的版本,現在正式穩定版本是 3.4.1
,gradle 支持 androidx 的最低版本是 3.2.1 ,請注意,一定要升級對應的 gradle 版本。
接著就在頂部菜單欄中選擇 Refactor > Migrate to AndroidX 就可以完成相關遷移啦,這時候會出現一個提示框。
備份那個勾選可以去掉,然后點擊 Migrate 。接下來 Android Studio 會遍歷你的工程文件,進行相關包名和導包替換,并且會在你的 gradle.propertier 文件中增加兩個屬性。
android.useAndroidX=true
android.enableJetifier=true
上面說了,項目導包啥的都會自動替換,你自己確定就行。那么依賴的庫呢,enableJetifier 這個屬性設置為 true 時就會將你依賴的庫在打包時自動替換為對應的 androidx ,是不是很流弊。詳情請看官方文檔
遷移完成,build.gradle 中的相關依賴也會自動更換,不過它更換的版本可能不是對應的穩定版本,而是最新的 beta 版本,咱們得手動更新到對應的穩定版本。那么這個穩定版本是多少呢,去查看相關文檔是不是很糾結。已經有人幫我做了對應插件,超帥。
還有 @NonNull ,在新版本中非空可空都已添加明確注解,這些細節地方可能也需要手動去更新下。
怎么驗證
傻瓜式遷移搞定后,一切來得太快太順利都讓自己開始懷疑遷移是否完成,項目是否還 OK 。
驗證其實也很簡單,首先,你得驗證項目能編譯過,沒有 error ,lint 沒有額外的警告。我的經驗是遷移之后,導包更換成功,但是使用該類時又會帶上全路徑,這個時候 lint 是能刷出來的,需要手動改一改。接著,你得確定 support 包是否已經被完全替換,不應該出現兩者共存的情況。這里就有很多方法,我提供三種方案:直接查看工程文件最下方的 External Libraries 是否還有 support 依賴;使用 ./gradlew -q :app:dependencies > dependencies.txt'
看看對應依賴關系中是否還有 support 依賴;反編譯自己的包,看看里面還有沒有 support 相關的類。