Jetpack 迁移到 androidX support MD

Markdown版本笔记	我的GitHub首页	我的博客	我的微信	我的邮箱
MyAndroidBlogs	baiqiantao	baiqiantao	bqt20094	baiqiantao@sina.com

---

目录

目录
AndroidX
AndroidX 的变化
常用依赖库对比
常用支持库类对比
官方文档介绍
迁移到 AndroidX
后续问题处理
手动修改错误包名
修复DataBinding中的重名id错误
去除 attr.xml 中重复的属性名称
Glide中的注解不兼容androidX
规范包名
修改未自动迁移的三方库
莫名问题的解决

AndroidX

官方文档

所有 AndroidX 引用库

API文档

androidx-class-mapping.csv

androidx-artifact-mapping.csv

Google 2018 IO 大会推出了扩展库 AndroidX，AndroidX 是对 android.support.xxx 包的整理后产物。由于之前的support包过于混乱，所以，google推出了 androidX 用于替换support包。

其只是将原来的android.*替换成androidx.*，只有包名和Maven工件名受到影响，原来的类名、方法名和字段名不会更改。

由于在后续版本中，会逐步放弃对 support 的升级和维护，所以，我们必须尽快迁移到 androidX。

Jetpack components are part of the AndroidX library. Learn more about components on the Jetpack home page.

AndroidX 的变化

常用依赖库对比

详细变化内容，可以下载CSV格式映射文件：androidx-class-mapping.csv

Old build artifact	AndroidX build artifact
com.android.support:appcompat-v7:28.0.2	androidx.appcompat:appcompat:1.0.0
com.android.support:design:28.0.2	com.google.android.material:material:1.0.0
com.android.support:support-v4:28.0.2	androidx.legacy:legacy-support-v4:1.0.0
com.android.support:recyclerview-v7:28.0.2	androidx.recyclerview:recyclerview:1.0.0
com.android.support.constraint:constraint-layout:1.1.2	androidx.constraintlayout:constraintlayout:1.1.2

常用支持库类对比

详细变化内容，可以下载CSV格式映射文件：androidx-artifact-mapping.csv

Support Library class	AndroidX class
android.support.v4.app.Fragment	androidx.fragment.app.Fragment
android.support.v4.app.FragmentActivity	androidx.fragment.app.FragmentActivity
android.support.v7.app.AppCompatActivity	androidx.appcompat.app.AppCompatActivity
android.support.v7.app.ActionBar	androidx.appcompat.app.ActionBar
android.support.v7.widget.RecyclerView	androidx.recyclerview.widget.RecyclerView

官方文档介绍

AndroidX is the open-source project that the Android team uses to develop, test, package, version and release libraries within Jetpack.

AndroidX是Android团队用于在Jetpack中开发，测试，打包，发布和发布库的开源项目。

AndroidX is a major improvement to the original Android Support Library. Like the Support Library, AndroidX ships separately from the Android OS and provides backwards-compatibility across Android releases. AndroidX fully replaces the Support Library by providing feature parity and new libraries. In addition AndroidX includes the following features:

AndroidX是对原始Android支持库的重大改进。与支持库一样，AndroidX与Android操作系统分开提供，并提供跨Android版本的向后兼容性。 AndroidX通过提供功能奇偶校验和新库完全取代了支持库。此外，AndroidX还包括以下功能：

• All packages in AndroidX live in a consistent namespace starting with the string androidx. The Support Library packages have been mapped into corresponding androidx.* packages. For a full mapping of all the old classes and build artifacts to the new ones, see the Package Refactoring page.

  AndroidX中的所有软件包都以字符串androidx开头，位于一致的命名空间中。支持库包已映射到相应的androidx。*包。有关所有旧类和构建工件的完整映射到新构件，请参阅“包重构”页面。

• Unlike the Support Library, AndroidX packages are separately maintained and updated. The androidx packages use strict Semantic Versioning starting with version 1.0.0. You can update AndroidX libraries in your project independently.

  与支持库不同，AndroidX软件包是单独维护和更新的。 androidx软件包使用严格的语义版本控制，从版本1.0.0开始。您可以单独更新项目中的AndroidX库。

• All new Support Library development will occur in the AndroidX library. This includes maintenance of the original Support Library artifacts and introduction of new Jetpack components.

  所有新的支持库开发都将在AndroidX库中进行。这包括维护原始支持库工件和引入新的Jetpack组件。

---

If you want to use AndroidX in a new project, you need to set the compile SDK to Android 9.0 (API level 28) or higher and set both of the following Android Gradle plugin flags to true in your gradle.properties file.

• android.useAndroidX: When set to true, the Android plugin uses the appropriate AndroidX library instead of a Support Library. The flag is false by default if it is not specified.
• android.enableJetifier: When set to true, the Android plugin automatically migrates existing third-party libraries to use AndroidX by rewriting their binaries. The flag is false by default if it is not specified.

迁移到 AndroidX

Migrating to AndroidX

1、修改 gradle.properties

android.useAndroidX=true
android.enableJetifier=true

其中：

• android.useAndroidX=true 表示当前项目启用 androidx
• android.enableJetifier=true 表示将依赖包也迁移到androidx。如果取值为false，表示不迁移依赖包到androidx，但在使用依赖包中的内容时可能会出现问题，当然了，如果你的项目中没有使用任何三方依赖，那么，此项可以设置为false

2、将AS更新至 AS 3.2 及以上

将 Gradle 插件版本改为 4.6 及以上

将 compileSdkVersion、buildToolsVersion 版本改为 28.0.2及以上

3、在AndroidStudio 3.2 或更高版本中执行如下操作：

Refactor > Migrate to AndroidX

如果你的项目 compileSdkVersion 低于28，点击Migrate to AndroidX...会提示：

You need to have at least have compileSdk 28 set in your module build.gradle to refactor to androidx

在执行该操作时会提醒我们是否将当前项目打包备份。如果你提前已经做好了备份，可以忽略；如果没有备份，则先备份。

后续问题处理

参考文章

Android Support 库和 AndroidX 冲突问题

手动修改错误包名

由于 Migrate to AndroidX 执行之后，部分控件的包名/路径名转换的有问题，所以还需要我们手动调整（包括修改xml布局文件和.java/.kt文件）。

如：ViewPager、RecyclerView 等，这些内容在迁移完成之后，包名是 androidx.core.weight.xxxx，这是一个错误的包名，我们必须手动修改，否则，无法正常编译。点击绿色 Run(运行) 按钮时会详细报出哪里有错误。

注意，在 AndroidStudio 的 build 选项卡中一次最多只会报 50条错误！所以，可能在你修完第一批之后，后面还有N个50。此处要保持一个平静的