Android Support vs AndroidX

Android Support Library 的由来

Android 3.0 (API 11) 为了更好地兼容平板，加入了Fragment，而想让低版本的系统也能用上，需要做一个向下兼容，于是Android团队推出了Android Support Library。

老Android们熟知的下述库 (v后面的数字代表最低兼容API版本，如4对应Android 1.6) 都属于Android Support Library：

com.android.support:support-v4→ Android 1.6，包含Fragment、NotificationCompat等控件，包含v7和v11的基础功能，早期用到。

com.android.support:appcompat-v7:xx.xx→ Android 2.1，增加了很多Material Design的兼容类和素材，包含v4的全部内容，用得最多。

support-v13→ Android 3.2，为平板开发推出的版本兼容包，Android 3.x系统是平板专用系统，用得不多。

Android版本更新飞快，现在都Android 12了，国内APP基本都最少兼容Android 5.1 (API 21)，这种v4、v7的命名早已没太大的意义。

AndroidX Library 的出现

从Android 9.0 (API 28) 开始，appcompat-v7:28.0.0 作为 Support Library的终结版本，未来的新特性和改进都会进入AndroidX Library。升级内容主要有两个方面：

①包名→ Support Library 中的API包名都是 android.support.，而AndroidX Library中的API都变成androidx.，意味着后续android.*包下的API都是随系统发布的，而androidx.包下的API都是随着扩展库发布的，API基本不依赖于操作系统的具体版本。

②命名规则→ AndroidX Library 中所有的库命名规则不再包含具体的操作系统API版本号，如下面的appcompat-v7变成了appcompat库。

api 'com.android.support:appcompat-v7:28.0.0'
api 'androidx.appcompat:appcompat:1.0.0'

从Support 过渡到 AndroidX

一键迁移

AS 3.2及以上版本提供了一键迁移到AndroidX的功能，依次点击菜单栏的 Refactor → Migrate to AndroidX。

注：一键迁移，compileSdkVersion需大于等于28，否则会提示：You need to have at least have compileSdk 28 set in your module build.gradle to refactor to androidx。

如果迁移失败，就重复下面的①②③④步进行手动迁移吧~

① 版本要求

Android Studio → 升级到3.2及以上；

Gradle插件 → 升级到4.6及以上，可在gradle/wrapper/gradle-wrapper.propertie 中修改distributionUrl指向版本号；

compileSdkVersion → 升级到28及以上；

buildToolsVersion → 升级到28.0.2及以上；

② 迁移AndroidX配置

在项目的 gradle.properties 文件中添加下述配置：

# 当前项目启用androidx
android.useAndroidX=true

# 将依赖包也迁移到androidx，一般写true
# 如果设为false表不迁移依赖包到 androidx，如果有第三方依赖可能会出问题
android.enableJetifier=true

③ 修改依赖库

参照AndroidX变化中的依赖库映射改，可直接查官方文档：

https://developer.android.com/jetpack/androidx/migrate/artifact-mappings

或下载映射的CSV文件：

https://developer.android.com/topic/libraries/support-library/downloads/androidx-artifact-mapping.csv

修改示例如下：

implementation com.android.support:cardview-v7
替换成→ implementation  androidx.cardview:cardview

implementation com.android.support:collections
替换成 → implementation androidx.collection:collection

implementation com.android.support:coordinatorlayout
替换成 → androidx.coordinatorlayout:coordinatorlayout

④ 依赖类重新打包

参照AndroidX变化中的类映射改，可直接查官方文档：

https://developer.android.com/jetpack/androidx/migrate/class-mappings

或下载映射的CSV文件：

https://developer.android.com/topic/libraries/support-library/downloads/androidx-class-mapping.csv