从support包迁移到AndroidX

最新推荐文章于 2024-11-21 16:26:07 发布

原创最新推荐文章于 2024-11-21 16:26:07 发布 · 1.1k 阅读

1 ·

CC 4.0 BY-SA版权

Android相关专栏收录该内容

180 篇文章

订阅专栏

本文介绍了如何在Android Studio中便捷地将项目从support库迁移到AndroidX，包括通过菜单选择Refactor->Migrate to AndroidX进行一键转换，并详细说明了迁移过程中的关键步骤和设置。在切换后，gradle.properties文件会新增两个参数以启用AndroidX和Jetifier。同时，列举了部分support库与AndroidX库的对应关系，并提醒开发者注意可能出现的编译错误或运行问题，必要时需手动调整代码。最后，提供了官方完整迁移映射链接供参考。

Google后续会逐步放弃对support包的升级和维护，新开发的包将只在AndroidX上更新，所以建议尽快切换。
其实在Android Studio中切换AndroidX比较简单，基本不需要手动改代码，可以一键切换。
依次选择菜单：Refactor->Migrate to AndroidX...，会弹出一个弹窗，其中有个复选框：Backup project as Zip file，选中此项可以备份切换之前的项目代码，也可以不选。点击“Migrate”按钮，就开始分析整个项目了。
分析完毕后，会出现Refactoring Preview视图，里面列出了所有需要替换的代码，查看无误后，可以点击“Do Refactor”按钮，就可以完成切换了。

切换成功后，你会发现在项目的gradle.properties文件中，会新增2个参数：
#Android插件会使用对应的AndroidX库而非支持库。
android.useAndroidX=true
#Android插件会通过重写现有第三方库的二进制文件，自动将这些库迁移为使用 AndroidX。
android.enableJetifier=true

如下是几个常用库的对应关系：
support库：
com.android.support:appcompat-v7:28.0.0
com.android.support:support-v4:28.0.0
com.android.support:support-annotations:27.1.1
com.android.support.constraint:constraint-layout:1.1.3
AndroidX库：
androidx.appcompat:appcompat:1.0.0
androidx.legacy:legacy-support-v4:1.0.0
androidx.annotation:annotation:1.0.0
androidx.constraintlayout:constraintlayout:1.1.3

注：
1.Android Studiod的迁移功能可能并不能完成所有操作。如果发现编译出错或运行崩溃等问题，请查看具体代码，手动修改。
2.要查看完整的对应关系，请参照链接：https://developer.android.google.cn/jetpack/androidx/migrate/artifact-mappings。