AndroidQ介绍与版本适配
此文涉及的版本适配包括 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