此文涉及的版本适配包括 Android O、Android P、AndroidQ
1. AndroidQ版本介绍
Android Q 也就是 Andriod 10 对应的 api为29
Q版本的新特性
- Dark theme 暗黑模式
好处：开启Dark theme 模式后更加省电（基于OLED屏的特性，这里就不展开了）、方便用户在弱光下使用设备
App要适配的话主要通过设置下面的style：
<style name="AppTheme" parent="Theme.AppCompat.DayNight">
以及使用此属性?android:attr/textColorPrimary
另外谷歌提供了一个Force Dark开关
Force Dark会分析应用程序的每个视图，并在它被绘制到屏幕前自动应用一个Dark主题。
app theme中设置android:forceDarkAllowed="true"
具体信息可查看Q暗黑模式Google官方介绍
捕获播放的音频
在提供截屏和录制屏幕之后，谷歌在AndroidQ上推出了可以捕获音频的ApiAudioPlaybackCapture
具体用法以及限制可参考官方文档 AudioPlaybackCapture API应用降级
当对商店更新后的版本后悔时，可以“回到过去”即回滚到旧版。
目前来说还有几个问题需要确认：
- 最近几个版本的应用降级？
- 降级后新版本存储的信息如何处理？
- 面部识别框修改
Android 9 时加上了官方的面部识别框
FingerprintManager --> BiometricPrompt
image
Android 10 可控制无需用户确认按键
setConfirmationRequired(false)
当用户的生物识别不可用时，可以设置 setDeviceCredentialAllowed() 允许用户使用PIN、手势密码、数字密码来通过认证。
Q版本发布时间
-
过去几个版本的发布时间：
版本发布时间.jpg -
Google关于Q版本发布的时间表：
image
2. 为什么要适配新版本？
(1) 适配分为2种
- 将编译的sdkVersion提升至最新的api版本号（如.29）；需要参考的文档 changes for apps targeting Q
- 不改变编译的sdkVersion，只适配最新的机型；这时需要查看的文档 changes for all apps
(2) 谷歌及各大应用市场对于适配的时间要求:
2019年上架谷歌Play商店对应用的TargetSdkVersion要求是：
- 新开发的应用：2019-8-1之后，上架谷歌Play商店要求应用的TargetSdkVersion>=28；
- 更新的应用：2019-11-1之后，上架谷歌Play商店要求应用的TargetSdkVersion>=28
3. 如何适配？
如果我们项目原本的api是25 ，要直接升到 api29，我们就需要进行：Andoird O、Android P、Android Q适配，三个适配阶段都需要。
下面会简要介绍下这几个api的适配：
3.1 Android O适配
- 通知栏
创建通知前需要创建渠道，创建通知时需要传入 channelId。
// 创建通知渠道private void initNotificationChannel() {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
CharSequence name = mContext.getString(R.string.app_name);
NotificationChannel channel = new NotificationChannel(mChannelId, name, NotificationManager.IMPORTANCE_DEFAULT);
mNotificationManager.createNotificationChannel(channel);
}
}
// 创建通知传入channelId
NotificationCompat.Builder builder = new NotificationCompat.Builder(context, NotificationBarManager.getInstance().getChannelId());
- 后台执行限制
每次在后台运行时，应用都会消耗一部分有限的设备资源，例如 RAM。 这可能会影响用户体验，如果用户正在使用占用大量资源的应用（例如玩游戏或观看视频），影响会尤为明显。 为了提升用户体验，Android 8.0（API 级别 26）对应用在后台运行时可以执行的操作施加了限制。
2.1 什么是前台应用？（这里的前台应用指的是对于Service限制来说）
- 具有可见 Activity（不管该 Activity 已启动还是已暂停）。
- 具有前台 Service。
- 另一个前台应用已关联到该应用（不管是通过绑定到其中一个 Service，还是通过使用其中一个内容提供程序），eg. 输入法、壁纸等
2.2 什么是后台服务限制？
如果针对 Android 8.0 的应用尝试在不允许其创建后台服务的情况下使用
startService()函数，则该函数将引发一个IllegalStateException。
2.3 解决方案：
- Job Scheduler
- Foreground Service
- try catch
3 权限组
- Android O 之前，申请一个子权限(如写外部存储权限)，会自动获取权限组中其他子权限（读外部存储权限）。组内其他子权限可以直接使用，无需申请。Android O 修复了这个错误。
- 在 Android O 上，申请一个子权限，组内其他子权限不会自动获取，需要再次申请才能使用。但不会弹出系统的权限申请框，将被自动批准。
4 Activity 设置屏幕方向
设置了透明主题的Activity，再设置屏幕方向
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
<item name="android:windowIsTranslucent">true</item></style>
<activity
android:name=".MainActivity"
android:screenOrientation="portrait"
android:theme="@style/AppTheme"></activity>
抛出以下异常
java.lang.IllegalStateException: Only fullscreen opaque activities can request orientation
- targetSdk=26，满足上述条件，API 26 手机没问题，API 27 手机没问题
- targetSdk=27，满足上述条件，API 26 手机Crash，API 27 手机没问题
推测是Google8.0手机的bug，在之后的版本已经修复。
3.2 Android P适配
3.2.1 webview数据目录变更
如果在api设置为28后，多进程使用同一个目录webView
抛出异常：
Caused by: java.lang.RuntimeException: Using WebView from more than one process at once with the same data directory is not supported.
解决：为不同的进程设置不同的webview数据目录
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
String processName = getProcessName(this);
if (!"com.xx.xxx".equals(processName)){//判断不等于默认进程名称
WebView.setDataDirectorySuffix(processName);}
}
public String getProcessName(Context context) {
if (context == null) return null;
ActivityManager manager = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
for (ActivityManager.RunningAppProcessInfo processInfo : manager.getRunningAppProcesses()) {
if (processInfo.pid == android.os.Process.myPid()) {
return processInfo.processName;
}
}
return null;
}
3.2.2 Apache HTTP客户端弃用
在 Android 6.0 中，谷歌取消了对 Apache HTTP 客户端的支持。 从 Android 9 开始，默认情况下该内容库已从 bootclasspath 中移除且不可用于应用。要继续使用 Apache HTTP 客户端，以 Android 9 及更高版本为目标的应用可以向其 AndroidManifest.xml 添加以下内容：
<uses-library android:name="org.apache.http.legacy" android:required="false"/>
3.2.3 非sdk接口管控
非SDK接口限制就是某些SDK中的私用方法，如private方法，你通过Java反射等方法获取并调用了。那么这些调用将在target>=P或target>=Q的设备上被限制使用，当你使用了这些方法后，会报错。谷歌官方描述
官方检查器veridex用来检测一个apk中哪里使用了非SDK接口。
扫描结果类似于下图（图片来自Android P版本 （七）veridex工具扫描非 SDK 接口，veridex使用方法也可以参考此文）：
- greylist: 灰名单，即当前版本仍能使用的非SDK接口，但在下一版本中可能变成被限制的非SDK接口
- blacklist：黑名单，使用了就会报错。也是我们项目中必须解决的非SDK接口
- greylist-max-o： 在targetSDK<=O中能使用，但是在targetSDK>=P中被限制的非SDK接口
- greylist-max-p： 在targetSDK<=P中能使用，但是在targetSDK>=Q中被限制的非SDK接口
3.2.4 前台服务
针对 Android 9 或更高版本并使用前台服务的应用需要请求FOREGROUND_SERVICE权限，系统会自动为请求权限的应用授予此权限。如果针对 Android 9 或更高版本的应用尝试创建一个前台服务且未请求 FOREGROUND_SERVICE，则系统会引发 SecurityException。
3.3 Android Q适配
3.3.1应用存储空间变更
为了让用户更好地控制自己的文件，减少文件混乱情况，Android Q 更改了应用对设备外部存储设备中的文件（例如存储在路径 /sdcard 下的文件）的访问方式。Android Q 会继续使用
READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE权限，这些权限与面向用户的存储运行时权限相对应。不过，默认情况下，以 Android Q 为目标平台的应用（以及选择接受这些变更的应用）在访问外部存储设备中的文件时会进入过滤视图。此类应用只能查看特定于应用的目录和特定类型的媒体，因此应用无需请求任何其他用户权限。
注意：在AndroidQ早期测试版(beta1、beta2)中引入的特定于媒体集合的权限（READ_MEDIA_IMAGES、READ_MEDIA_AUDIO 和 READ_MEDIA_VIDEO）现已过时。
默认情况下，如果应用以 Android Q 为目标平台，则在访问外部存储设备中的文件时会进入过滤视图。应用可以使用· Context.getExternalFilesDir() ·将专用于自己的文件存储在特定于自己的目录中。具有过滤视图的应用对其创建的文件始终拥有读/写权限，无论文件位于特定于此应用的目录以内还是以外。应用无需声明任何存储权限即可访问这些文件。
只有在满足以下两个条件时，应用才能访问其他应用创建的文件：
您的应用已获得
READ_EXTERNAL_STORAGE权限。-
这些文件位于以下其中一个明确定义的媒体集合中：
- 照片：存储在 MediaStore.Images 中。
- 视频：存储在 MediaStore.Video 中。
- 音乐：存储在 MediaStore.Audio 中。
为了访问另一应用创建的任何其他文件（包括“downloads”目录下的文件），应用必须使用存储访问框架，用户可以通过该框架选择特定文件。
Android Q版本正式版谷歌尚未发布 ~ [未完待续]
适配的资料参考
Google Q版本应用兼容性整改指导
华为开发者联盟文档中心
Google Android-8.0-migration
