Android 版本适配全套指南
-
当我在做 Android 版本适配工作的时候很痛苦，那个时候我在想有没有一个文档，将所有的关于 Android 版本适配资料全部收集起来，这样就不需要在网上东找西找了，这样就能把时间和精力投入适配工作中，每当一个新的 Android 版本发布的时候，这个想法越加强烈，终于在 Android 11 刚发布的时候筹划了这件事情，最终赶在 Android 12 刚发布的时候完成了，整个过程耗时非常漫长，因为我正在不断收集优质的资料，同时我也在不断思考，什么样的适配文档才是大家所需要的，我将适配文档简单划分成了以下几部分：
-
官方文档
-
新特性
-
行为变更
-
-
相关资源
-
适配文章链接
-
适配框架链接
-
-
适配流程
- 这里以适配
Android 12为例子，第一步将主模块中的build.gradle文件中修改targetSdkVersion和compileSdkVersion这两个的值
android {
compileSdkVersion 31
defaultConfig {
targetSdkVersion 31
}
}
- 接下来在代码中做一些版本的判断，并且做好新版本的适配和旧版本的兼容
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
......
} else {
......
}
-
到这里，大家可能有一个疑问，targetSdkVersion 和 compileSdkVersion 有啥区别？
-
targetSdkVersion：目标适配版本，告知系统 App 适配的情况，如果应用的 targetSdkVersion 比系统版本要低，那么在一些新特性上新系统会做向下兼容性处理，如果我们想要适配某个 Android 版本，必须要将 targetSdkVersion 调整到这个版本等级之上，否则在某些机型上面可能会出现一些适配异常的情况。如果我们只是简单调高了 targetSdkVersion 等级而没有适配新版本的特性，那么应用在新系统上可能会出现功能异常的情况，一般情况表现为应用崩溃或者获取不到数据。
-
compileSdkVersion：编译源码版本，我们可以通过修改这个版本等级来改变我们在代码中所看到的 Android SDK 源码的版本，同时也决定了编译器在进行代码检查时所用的版本。
-
-
最后附上一张 Android 版本信息对应表
| Android 版本 | API 等级 | 版本代号 | 发布时间 |
|---|---|---|---|
| Android 12L | 32 | S_V2 | 预计 2022 年 3 月 |
| Android 12 | 31 | S | 2021 年 10 月 4 日 |
| Android 11 | 30 | R | 2020 年 9 月 9 日 |
| Android 10 | 29 | Q | 2019 年 9 月 3 日 |
| Android 9.0 | 28 | P | 2018 年 8 月 7 日 |
| Android 8.1 | 27 | O_MR1 | 2017 年 12 月 5 日 |
| Android 8.0 | 26 | O | 2017 年 8 月 22 日 |
| Android 7.1 | 25 | N_MR1 | 2016 年 12 月 5 日 |
| Android 7.0 | 24 | N | 2016 年 8 月 22 日 |
| Android 6.0 | 23 | M | 2015 年 9 月 29 日 |
| Android 5.1 | 22 | LOLLIPOP_MR1 | 2015 年 3 月 10 日 |
| Android 5.0 | 21 | LOLLIPOP | 2014 年 10 月 15 日 |
| Android 4.4 | 19 | KITKAT | 2013 年 10 月 31 日 |
文档目录
Android 12.0 / 12L
新特性
行为变更
相关资源
Android 11.0
概览
| 隐私权变更 | 受影响的应用 | 缓解策略 |
|---|---|---|
| 强制执行分区存储机制 以 Android 11 或更高版本为目标平台的应用始终会受分区存储行为的影响 | 以 Android 11 或更高版本为目标平台的应用，以及以 Android 10 为目标平台且未将 requestLegacyExternalStorage 设为 true 以停用分区存储的应用 |
更新您的应用以使用分区存储 详细了解分区存储变更 |
| 单次授权 使用单次授权功能，用户可以授予对位置信息、麦克风和摄像头的临时访问权限 | 在 Android 11 或更高版本上运行且请求位置信息、麦克风或摄像头权限的应用 | 在尝试访问受某项权限保护的数据之前，检查您的应用是否具有该权限 遵循请求权限方面的最佳做法 |
| 自动重置权限 如果用户在 Android 11 或更高版本上几个月未与应用互动，系统会自动重置应用的敏感权限 | 以 Android 11 或更高版本为目标平台且在后台执行大部分工作的应用 | 要求用户阻止系统重置应用的权限 详细了解自动重置权限 |
| 后台位置信息访问权限 Android 11 更改了用户向应用授予后台位置信息权限的方式 | 以 Android 11 或更高版本为目标平台且需要在后台访问位置信息的应用 | 通过对权限请求方法的多次单独调用，逐步请求在前台（粗略或精确）和后台访问位置信息的权限。必要时，说明用户授予该权限所能得到的益处 详细了解 Android 11 中的在后台访问位置信息的权限 |
| 软件包可见性 Android 11 更改了应用查询同一设备上的其他已安装应用及与之互动的方式 | 以 Android 11 或更高版本为目标平台且与设备上的其他已安装应用交互的应用 | 将 <queries> 元素添加到应用的清单 详细了解软件包可见性
|
| 前台服务 Android 11 更改了前台服务访问位置信息、摄像头和麦克风相关数据的方式 | 在 Android 11 或更高版本上运行且在前台服务中访问位置信息、摄像头或麦克风的应用 | 分别针对需要访问摄像头和麦克风的前台服务，声明 camera 和 microphone 前台服务类型。但请注意，应用在后台运行时启动的前台服务通常无法访问位置信息、摄像头或麦克风。 详细了解前台服务的变更
|
新特性
行为更变
相关资源
Android 10.0
概览
| 隐私权变更 | 受影响的应用 | 缓解策略 |
|---|---|---|
| 分区存储 针对外部存储的过滤视图，可提供对特定于应用的文件和媒体集合的访问权限 | 访问和共享外部存储中的文件的应用 | 使用特定于应用的目录和媒体集合目录 了解详情 |
| 增强了用户对位置权限的控制力 仅限前台权限，可让用户更好地控制应用对设备位置信息的访问权限 | 在后台时请求访问用户位置信息的应用 | 确保在没有后台位置信息更新的情况下优雅降级 使用 Android 10 中引入的权限在后台获取位置信息 了解详情 |
| 系统执行后台 Activity 针对从后台启动 Activity 实施了限制 | 不需要用户互动就启动 Activity 的应用 | 使用通知触发的 Activity 了解详情 |
| 不可重置的硬件标识符 针对访问设备序列号和 IMEI 实施了限制 | 访问设备序列号或 IMEI 的应用 | 使用用户可以重置的标识符 了解详情 |
| 无线扫描权限 访问某些 WLAN、WLAN 感知和蓝牙扫描方法需要获得精确位置权限 | 使用 WLAN API 和蓝牙 API 的应用 | 针对相关使用场景请求 ACCESS_FINE_LOCATION 权限 了解详情
|
新特性
行为更变
相关资源
Android 9.0
新特性
行为更变
相关资源
Android 8.0 / 8.1
新特性
行为变更
相关资源
-
Android 8.0 踩坑记录 - Only fullscreen opaque activities can request orientation
-
Only fullscreen opaque activities can request orientation问题及解决方案
