迁移至 AndroidX

AndroidX 将原始支持库 API 替换为 androidx 命名空间中的软件包。只有软件包和 Maven 工件名称发生了变化;类名、方法名和字段名没有变化。

前提条件

执行迁移之前,请先将应用更新到最新版本。 我们建议您将项目更新为使用支持库的最终版本:版本 28.0.0。 这是因为,1.0.0 版本的 AndroidX 工件是与支持库 28.0.0 工件等效的二进制文件。

使用 Android Studio 迁移现有项目

使用 Android Studio 3.2 及更高版本,您只需从菜单栏中依次选择 Refactor > Migrate to AndroidX,即可将现有项目迁移到 AndroidX。

重构命令使用两个标记。默认情况下,这两个标记在 gradle.properties 文件中都设为 true

android.useAndroidX=true
Android 插件会使用对应的 AndroidX 库而非支持库。
android.enableJetifier=true
Android 插件会通过重写现有第三方库的二进制文件,自动将这些库迁移为使用 AndroidX。

映射

如果您遇到与迁移有关的问题,请参考下面这些表来确定从支持库到对应 AndroidX 工件和类的正确映射:

有关 Jetpack 库的最新版本,请参阅版本页面

其他资源

如需详细了解如何将代码迁移到 AndroidX,请参阅下面列出的其他资源:

博文

视频