迁移到 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,请参阅下面列出的其他资源:

博文