简介这是Android Support Library 23.2官方支持库资源包覆盖v4、v7、v13、v17等常用兼容库主要面向需要兼容Android旧版本系统的移动应用开发者。引入该资源可解决因Support Library缺失或版本不匹配导致的编译失败、运行崩溃及系统兼容问题适用于日常应用开发、调试与多机型适配。压缩包共1674个文件包含512个java源码、681个xml配置与布局、379个png图形资源以及16个jar库、aidl接口文件和gradle工程配置等整体仅8.64MB目录结构清晰方便直接集成或离线对照研究。已有395人学习下载。通过该包可快速获得官方兼容组件源码与资源理解MediaSessionCompat、PlaybackStateCompat等多媒体兼容类的实现细节排查Support Library依赖冲突适合需要深入分析库结构或离线环境开发调试的安卓开发者。 如果你是从 Android 2.x/3.x 时代走过来的开发者大概率对android.support.v4、android.support.v7这些包名不会陌生。Support Library 23.2 是 Google 在 2016 年初放出的一个里程碑版本它把 API 23 时代的控件和特性带到了 Android 2.1 的设备上同时第一次正式支持向量图标与夜间模式。这篇文章我主要想结合自己在实际项目里升级、选型、排坑的完整经过聊一聊 23.2 里 v4、v7、v13、v17 该怎么选以及配置过程中最容易翻车的几个点最后给出一套可以直接搬进项目的依赖写法。不管你是在维护老项目还是想理解 Android 兼容层的由来这篇内容都适用。1. Support Library 23.2 到底是什么为什么值得关注1.1 核心定位与兼容性原理Support Library 本质上是一套“向下兼容”的 API 仓库。Android 系统版本碎片化极其严重Google 推出的新控件和特性往往只集成在新系统里旧系统设备用户量又很大。Support Library 通过把新版框架里的逻辑在 support 包中重新实现再打包成普通的 AAR 引入到 app 中让开发者可以在低版本系统上调用高版本 API。23.2 发布于 2016 年 2 月前后编译目标版本是compileSdkVersion 23对应 Android 6.0。它解决的核心问题是把 Android 6.0 里的矢量图形、夜间主题等能力移植到旧版本上。要理解 Support Library 的价值可以把 Android 系统比作一间基础设施固定的房子Support Library 就是一套可以随时搬进去的预制家具不需要拆掉旧房只要按说明书安装就能用上新功能。在那个年代很多团队还在 Java 代码里手写大量findViewById和类型强转布局也没多少可复用组件。Support Library 23.2 的发布对普通开发者来说最直观的感受是想用的新控件终于不用等用户换手机了。1.2 23.2 版本引入的关键能力我梳理了一下 23.2 里真正影响开发方式的几个变化矢量图形支持。通过VectorDrawableCompat和AnimatedVectorDrawableCompat支持到 API 7配合 AppCompat 里的app:srcCompat可以在 Android 2.1 上渲染 VectorDrawable这直接改变了切图方式一个小图标 XML 搞定省掉一堆 mdpi/hdpi/xhdpi 的 PNG。支持库夜间模式。AppCompat 新增AppCompatDelegate.setDefaultNightMode()可以在应用内切换 Day/Night 主题不用自己维护两套 Activity 逻辑。百分比布局。新增PercentRelativeLayout、PercentFrameLayout允许按父容器宽高百分比来设定子控件尺寸比权重更直观。新通知风格。NotificationCompat.MessagingStyle消息通知样式替代早期的BigTextStyle来展示聊天会话。RecyclerView 的SortedList帮助开发者在数据变化时自动计算增量更新不再需要手动 diff。这些能力放在今天看来非常基础但在 23.2 那个节点很多人是因为这些功能才开始大规模把项目迁移到 AppCompat 和 RecyclerView 的。尤其是矢量图原来一个图标要出 5 套不同分辨率的图片现在一个 XML 文件全解决光这一项就能省下不少 UI 切图和包体积。2. v4、v7、v13、v17——四个库的关系与选型原则现在回答大家最常问的问题v4、v7、v13、v17 到底有什么差别2.1 support-v4 是所有上层建筑的地基android.support.v4是支持库系列里最基础的一个最初是为了兼容 Android 4.0 之前的碎片、加载器、ViewPager 等能力。v4 里的核心类包括Fragment和FragmentManager、Loader和LoaderManager、ViewPager、DrawerLayout、NotificationCompat、AccessibilityDelegateCompat、ContextCompat、ActivityCompat。即便是最新的项目只要断不了旧版本就绕不开 v4。这里有个容易误解的地方包名里的“v4”指的是最早面向 API 4Android 1.6设计的兼容代码后来顺延成了固定命名并不是说它只能支持到 API 4。实际上 v4 的代码在 API 23 设备上一样运行得很好。2.2 v7 系列AppCompat、RecyclerView、CardView 的配合v7 里包含了一批子库统一依赖 v4。命名里的“v7”对应 API 7Android 2.1也就是说 v7 系列把这些能力的最低支持版本拉到了 API 7。常见子库com.android.support:appcompat-v7提供AppCompatActivity、AppCompatDelegate、Theme.AppCompat等是 Material Design 向旧版本迁移的核心几乎每个现代项目都要引入。com.android.support:recyclerview-v7高度可定制的列表组件由RecyclerView.Adapter驱动替代 ListView。com.android.support:cardview-v7带圆角与阴影的 Card 容器。com.android.support:palette-v7从图片中提取主色。com.android.support:preference-v7兼容设置界面的偏好项。com.android.support:gridlayout-v7、mediarouter-v7等按需使用。选型原则很简单要 Material 主题选 appcompat要看长列表选 recyclerview要卡片式布局选 cardview只引入自己需要的库别一口气全部堆上去。因为每个 support 子库都包含资源文件和 Java 代码哪怕不用的部分 APK 也不会打包进去唯一增加的是构建时间。2.3 v13 与 v17面向特殊场景的增强包com.android.support:support-v13并不是 v4 的简单升级版它专门为 API 13 设备提供增强能力。最典型的是Fragment的getChildFragmentManager()在 API 13 以下无法使用v13 里的FragmentCompat对嵌套 Fragment 做了兼容处理。如果 app 的 minSdk 高于 13v13 才更合适否则通常仍然建议直接用 v4。这里有一个我自己遇到的例子。当时做一个平板适配项目minSdk 定在 14有人为了图省事在每个 Fragment 里直接用了getChildFragmentManager()结果在 API 13 以下的机型上预览没测出来真机一跑就崩。后来排查发现嵌套 Fragment 在旧系统上有坑加 v13 兼容包并改用FragmentCompat才稳定。com.android.support:leanback-v17则面向 TV 场景包名里的 v17 对应 API 17。它提供BrowseFragment、DetailsFragment、PlaybackOverlayFragment等电视端 UI 组件主要用于 Android TV 应用。在 23.2 时代手机项目完全不需要碰它。如果你只是想在手机应用里显示列表用 RecyclerView 就够了不要为了“全”把 leanback 也引进来。2.4 一张表快速选型库名artifactId最低支持版本主要能力v4support-v4API 4Fragment、ViewPager、NotificationCompat 等基础兼容v7appcompat-v7API 7Material 主题、ActionBar、夜间模式v7recyclerview-v7API 7RecyclerView 高性能列表v7cardview-v7API 7卡片式布局v13support-v13API 13嵌套 Fragment 等增强兼容v17leanback-v17API 17Android TV 端 UI 组件其他designAPI 7Material Design 控件FloatingActionButton、Snackbar 等建议先确定 minSdk 和产品形态再开始选库。手机端项目 90% 只需要 v4 appcompat-v7 recyclerview-v7偶尔加 design 库做协调布局用不到 v13 和 v17。3. Android Studio 配置 23.2 与典型功能实现3.1 Gradle 依赖配置与版本管理在 Android Studio 中接入 Support Library 23.2方法很简单在build.gradle文件的 dependencies 块里加上对应依赖即可。不过 23.2 时代 Gradle 插件版本还不像现在这么顺手建议把版本号统一放在一个变量里android { compileSdkVersion 23 buildToolsVersion 23.0.2 defaultConfig { minSdkVersion 14 targetSdkVersion 23 } } ext { supportLibVersion 23.2.0 } dependencies { compile com.android.support:support-v4:${supportLibVersion} compile com.android.support:appcompat-v7:${supportLibVersion} compile com.android.support:recyclerview-v7:${supportLibVersion} compile com.android.support:design:${supportLibVersion} compile com.android.support:percent:${supportLibVersion} }这里有个细节在 23.2 之前很多人喜欢直接写support-v13而 23.2 之后我建议以appcompat-v7为基础然后按需要单独添加别的子库。因为 v4/v7/v13 的核心类存在交叉依赖如果版本不统一编译时会出现All com.android.support libraries must use the exact same version specification的报错。我在项目里从 23.1.1 升到 23.2.0 时就因为这个报错排查了半天最后发现是某个第三方库还在用 23.0.1 的 support-v4。3.2 矢量图标兼容性的配置23.2 最受关注的特性就是矢量图形。要在低版本上使用需要在defaultConfig里开启支持字符串资源同时在布局中使用app:srcCompat而不是android:srcdefaultConfig { vectorDrawables.useSupportLibrary true }ImageView android:layout_width48dp android:layout_height48dp app:srcCompatdrawable/ic_search android:tintcolor/colorAccent /如果把android:src用在 ImageView 上在 API 21 以下会直接回退到无图状态如果用在FrameLayout的 background 上在某些 23.2.x 版本里还会挂掉。所以最保险的做法是所有矢量图都通过app:srcCompat或AppCompatResources.getDrawable()加载不要用原生 XML 属性直接引用矢量资源。我当时做图标换肤时把全项目 50 多个图标全部从 PNG 换成了 vector最开始用的是android:src结果一台 Android 4.4 的三星设备上图标全部消失后来改成app:srcCompat才恢复。这里还有个细节VectorDrawable 的tint在 API 21 以下不解析所以如果你要给图标换色就用android:tint加 selector不要依赖 vector 内部的fillColor做状态切换。3.3 百分比布局与夜间模式的实战写法百分比布局在 23.2 中刚出来相对冷门但它特别适合做引导页和复杂屏幕适配。下面是一段实际可用的布局示例android.support.percent.PercentRelativeLayout xmlns:androidhttp://schemas.android.com/apk/res/android xmlns:apphttp://schemas.android.com/apk/res-auto android:layout_widthmatch_parent android:layout_heightmatch_parent ImageView android:layout_width0dp android:layout_height0dp android:srcmipmap/ic_launcher app:layout_widthPercent60% app:layout_aspectRatio1 / Button android:layout_width0dp android:layout_heightwrap_content app:layout_widthPercent80% app:layout_marginTopPercent8% app:layout_centerHorizontaltrue/ /android.support.percent.PercentRelativeLayout需要注意layout_widthPercent这类属性只能被PercentRelativeLayout识别套在普通 LinearLayout 里是不起作用的。我在做引导页时就是靠百分比布局解决不同屏幕比例下控件错位的问题不用写一堆尺寸限定符和values-sw600dp之类的目录。夜间模式的切换用一行代码就能完成AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_AUTO);重点是主题必须继承自Theme.AppCompat或其子类同时 Activity 要继承AppCompatActivity。我在实际项目中遇到一个问题启动页用了普通 Activity 而不是 AppCompatActivity结果系统重启后夜间模式不生效换了启动页继承后再配合MODE_NIGHT_YES/MODE_NIGHT_NO强切才算稳定。3.4 通知栏消息样式的实现23.2 里新增的MessagingStyle很适合聊天类应用它可以用对话气泡的形式展示多条消息替代以前手动拼BigTextStyle的做法NotificationCompat.MessagingStyle style new NotificationCompat.MessagingStyle(我); style.addMessage(今晚一起吃饭吗, System.currentTimeMillis(), 老张); style.addMessage(行我 7 点下班过去。, System.currentTimeMillis(), 我); style.setConversationTitle(项目组讨论); NotificationCompat.Builder builder new NotificationCompat.Builder(context) .setSmallIcon(R.mipmap.ic_launcher) .setContentTitle(项目组讨论) .setStyle(style) .setPriority(NotificationCompat.PRIORITY_DEFAULT); NotificationManagerCompat.from(context).notify(1, builder.build());这套写法在 Android 7.0 以下会降级为普通通知但消息内容和标题不会丢失。对于即时通讯类 app23.2 的这个样式改造很有价值不用再自行维护消息拼接格式。4. 实战中遇到的常见问题与排查技巧4.1 依赖冲突“All com.android.support libraries must use the exact same version specification”这是接入 23.2 之后最典型的问题。原因一般是某个间接依赖比如地图 SDK 或图片加载库内部引用了旧 support 版本导致同一个库出现多个版本。解决思路有三种在dependencies里直接声明需要使用的最高版本强制统一。使用exclude排除传递依赖compile(com.example:lib:1.0.0) { exclude group: com.android.support, module: support-v4 }在根工程的 build.gradle 里写全项目统一版本配置这种方式在大型多模块项目里更省事。我当时的设计是在根模块里写死subprojects { project.configurations.all { resolutionStrategy.eachDependency { details - if (details.requested.group com.android.support) { details.useVersion 23.2.0 } } } }这个方案的优点是以后升级 support 版本时只需改一个地方不用每个模块去翻依赖。4.2 65535 方法数与 multidexSupport Library 本身不算太大但引入 AppCompat、Design、RecyclerView 之后第三方库一多方法数量很容易跑到 65535 以上。Android 5.0 以下设备安装时会报 dex 溢出。解决的配置是defaultConfig { multiDexEnabled true } dependencies { compile com.android.support:multidex:1.0.1 }如果是自定义 Application 类要继承MultiDexApplication或在attachBaseContext里调用MultiDex.install(this)。在 23.2 这个版本multidex 库还依赖 v4所以顺便把 v4 的版本统一一下。这里踩过的一个坑是如果你是先写multidex依赖再写 v4 依赖两个库版本对不上时编译报错信息并不直接需要看依赖树才能定位。推荐用gradlew :app:dependencies命令查看完整的依赖层级。4.3 矢量 drawable 在低版本上不生效这个问题我踩得最深。23.2 的矢量支持虽然好但对 5.0 以下的设备存在一些限制android:src不能用必须用app:srcCompat。VectorDrawable的tint和alpha属性在 API 21 以下不解析需要在 XML 里用android:tint或代码设置 tint 才行。如果 SVG 转换后的 PathData 过于复杂低端机会有内存压力建议对复杂图标在转换时做简化。在layout的background属性中直接用 vector在部分 23.2.x 版本里存在 bug需要改用AppCompatResources.getDrawable()来兼容。检查这类问题时可以先用模拟器 API 19 跑一遍如果图标显示空白优先看布局里是否用了app:srcCompat。另外建议所有 vector 资源只在drawable目录放一份不需要在drawable-v21里再放一份否则会出现两套资源加载混乱的问题。4.4 编译 SDK 与构建工具版本匹配23.2 要求compileSdkVersion 23和buildToolsVersion 23.0.2以上不然会有资源编译错误。我当时升级时使用buildToolsVersion 23.0.1就报了failed to find Build Tools revision 23.0.2后来确认 23.2 的 AAR 资源里带着较高的资源定义官方要求必须匹配。用 Android Studio 2.0 的默认环境通常会顺利下载手动命令行构建时尤其注意把 SDK 路径和 local.properties 配好。这里还有个细节Gradle 插件版本和 23.2 也有对应关系老项目如果用com.android.tools.build:gradle:1.5.0搭配 23.2资源合并时偶尔会报错升级到 2.0.0 以上会稳很多。5. 最后想说的经验Support Library 23.2 在今天看起来并不算前沿但它把 Android 6.0 的新特性回灌到老设备上这套兼容思路影响深远。看到现在 AndroidX 的包名回头再想 2016 年那次升级很多当时的坑都变成了经验。给还在维护老项目的朋友两个建议。第一升级 support 版本之前先把项目里所有的自定义主题和 Activity 类型统一掉确认没有直接在普通 Activity 里依赖 AppCompat 的资源第二所有 support 相关依赖一次性全部升级不要只升 appcompat 不升 design否则很容易卡在版本冲突上。如果你正在做一个全新项目直接用 AndroidX 和新版本库就行不必再回退到 23.2但把这篇的思路吃透以后遇到任何“新系统特性往老设备上迁移”的问题都会快速反应过来该从哪入手排查。本文还有配套的精品资源点击获取