在 2018 Google I/O 大會上，Android 團隊發布了 AndroidX。它是 Android 團隊用于開發、測試、打包、定版以及在 Jetpack 中發布庫時所用到的開源代碼。和 Support Library 類似，每一個 AndroidX 庫都是獨立于 Android OS 來發布，并且提供了跨 Android 版本的向后兼容性。它是對 Support Library 的重大改進和全面替代方案。

閱讀下文來了解我們如何為遷移過程準備自己的代碼，以及執行遷移過程。

我強烈建議在一個版本可控的分支做遷移工作。這樣你可以逐步解決可能出現的任何遷移問題，同時分離出每個變更用于分析定位問題。你可以在這個 Pull Request 下查看我們的討論過程，并且通過點擊下面的提交鏈接來跟進最新信息。另外 Android Studio 提供了一個遷移前做工程備份的可選服務。

和任何大規模代碼的重構工作一樣，最好在遷移到 AndroidX 期間，遷移分支與主要開發分支之間做到最少合并來避免合并沖突。雖然對其他應用來說不可行，但是我們團隊能夠臨時暫停向主分支提交代碼以幫助遷移。一次性遷移整個應用也非常必要，因為部分遷移——同時使用 AndroidX 和 Support 庫將會導致遷移過程中的失敗。

最后，請閱讀 developer.android.com 網站上遷移至 AndroidX 文中的提示。現在讓我們開始吧！

在你開始之前，對代碼準備的最重要的一點建議是：

確保你正在使用的依賴庫是與 AndroidX 兼容的。

依賴于一個舊版 support 庫的第三方庫可能與 AndroidX 不兼容，這很有可能導致你的應用在遷移到 AndroidX 后無法編譯。檢查你的應用任意依賴是否兼容的一個方法是訪問這些依賴的項目站點。一個更直接的方法是開始遷移，并且檢查可能出現的報錯。

對于 Plaid 應用，我們使用了一個與AndroidX 不兼容的圖形加載庫 Glide 的舊版本（4.7.1）。這導致遷移后出現一個讓應用無法構建的代碼生成問題（這是一個記錄在 Glide 工程下的類似問題），在開始遷移之前我們把 Glide 更新到版本 4.8.0（參考這次提交），這個版本添加了對 AndroidX 注解的支持。

關于這一點，請盡可能地更新到你的應用所依賴第三方庫的最新版本。這對 Support 庫而言尤其是一個好主意，因為升級到 28.0.0（截至撰寫本文的最終版本）將使遷移更加順暢。

遷移過程中我們使用了 Android Studio 3.2.1 版本中內置的重構工具。 AndroidX 遷移工具位于菜單欄的 Refactor > Migrate to AndroidX 選項。這個選項將遷移整個項目的所有模塊。

運行 AndroidX 重構工具后的預覽窗口。

如果你不使用 Android Studio 或者更傾向于其他工具來做遷移，請參考 Artifact 和 Class 來對比新舊支持庫間架構和類的改動，這些材料也有提供 CSV 格式。

Android Studio 中的 AndroidX 遷移工具是 AndroidX 遷移的主要方式。這個工具正在持續的優化中，所以如果你遇到問題或者希望查看某個功能，請在 Google 問題追蹤頁提交一票。

變更最少的代碼以保證應用可以仍能正常運行。

在運行 AndroidX 遷移工具后，大量的代碼被變更，然而項目卻無法編譯成功。此時，我們僅僅做了最少量的工作來使應用重新運行起來。

這個方法有利于把流程拆解為可控的步驟。我們留下了一些任務，諸如修復導入順序、提取依賴變量、減少完整 classpath 的使用，以便后續的清理工作。

剛開始出現的報錯之一是重復的類 —— 像這種情況，PathSegment：

Execution failed for task :app:transformDexArchiveWithExternalLibsDexMergerForDebug.

> com.android.builder.dexing.DexArchiveMergerException: Error while merging dex archives:

如何解決這個問題參考這里： https://developer.android.com/studio/build/dependencies#duplicate_classes.

Program type already present: androidx.core.graphics.PathSegment

這是一個由遷移工具生成錯誤依賴（androidx.core:core-ktx:0.3）導致的報錯。我們手動更新（參考這次提交）到正確的依賴版本（androidx.core:core-ktx:1.0.0）。這個bug 已經在 Android Studio 3.3 Canary 9 及之后的版本被修復。我們指出這點是因為你或許在遷移過程中會遇到類似的問題。

接下來，Palette API 在新版中變得可以為空，為了暫時避開（參考這次提交）這點，我們添加了!!（非空斷言操作符）。

然后我們遇到了一個 plusAssign 缺失的報錯。這個加載在 1.0.0 版本中被移除。plusAssign 的使用被臨時注釋掉了（參考這次提交）。本文的后面我們會研究對 Palette 和 plusAssign 問題的可持續解決方案。

現在應用可以運行了，到清理代碼的時候了！

應用在運行中，但是我們的持續集成系統報告了代碼提交后的構建錯誤：

Execution failed for task :designernews:checkDebugAndroidTestClasspath.

> Conflict with dependency androidx.arch.core:core-runtime in project :designernews. 

Resolved versions for runtime classpath (2.0.0) and compile classpath (2.0.1-alpha01) differ. This can lead to runtime crashes. 

To resolve this issue follow advice at https://developer.android.com/studio/build/gradle-tips#configure-project-wide-properties.

Alternatively, you can try to fix the problem by adding this snippet to /.../plaid/designernews/build.gradle:

  dependencies {
    implementation("androidx.arch.core:core-runtime:2.0.1-alpha01")
  }

我們依照測試日志中的參考建議，添加了缺失的依賴模塊（參考這次提交）。

我們也借此機會更新了我們的 Gradle 插件版本、Gradle wrapper 版本、Kotlin 版本（參考這次提交）。Android Studio 推薦我們安裝 28.0.3 版本的構建工具，我們也照做了。在使用 Gradle 3.3.0-alpha13 版本插件時我們遇到的問題，通過降級到 3.3.0-alpha8 版本的方式得到解決。

遷移工具的一個缺點是：如果你在依賴版本項使用了變量，遷移工具把它們自動內聯。我們從 build.gradle 文件中重新提取了這些版本（參考這次提交）。

上文中我們提到了運行 AndroidX 遷移工具后對 plusAssign 和 Palette 問題的臨時解決方案。我們通過將 AndroidX 版本降低來重新添加了 plusAssign 函數和相關測試（參考這次提交），并且恢復了被注釋了的代碼。與此同時，我們把 Palette 參數更新到可以為空的這個版本（參考這次提交），這樣就無需使用操作符 !!。

同樣的，自動轉化可能使得某些類需要使用它們的完整類路徑。做最少的手工修正是一個好的思路。作為清理工作的一部分，我們移除了完整類路徑，并在必要時重新添加了相關引用。

最后，一些少量測試相關的修改被加入工程，圍繞著測試過程中的依賴沖突（參考這次提交）和 Room 的測試用例（參考這次提交）。這時我們的工程完成全部轉化，并且我們的測試都已通過。

盡管遇到了一些障礙，AndroidX 的遷移進展得比較順利。遇到的問題主要涉及依賴庫或類的錯誤轉換，以及新庫中的 API 變化。 幸運的是這些都相對容易解決。Plaid 現在已經準備好再被用起來了！

如果發現譯文存在錯誤或其他需要改進的地方，歡迎到 掘金翻譯計劃 對譯文進行修改并 PR，也可獲得相應獎勵積分。文章開頭的 本文永久鏈接 即為本文在 GitHub 上的 MarkDown 鏈接。

掘金翻譯計劃 是一個翻譯優質互聯網技術文章的社區，文章來源為 掘金 上的英文分享文章。內容覆蓋 Android、iOS、前端、后端、區塊鏈、產品、設計、人工智能等領域，想要查看更多優質譯文請持續關注 掘金翻譯計劃、官方微博、知乎專欄。