安卓Q版本兼容性适配指导v2.3.pdf

应用2019上架谷歌Play商店适配指导

Google P版本变化点 说明 第三方应用影响 适配指导

ART 非SDK接口管控 Android 9 引入了针对非 SDK 接口的使用限制，无论是直接使用还是

通过反射或 JNI 间接使用。 无论应用是引用非 SDK 接口还是尝试使用

反射或 JNI 获取其句柄，均适用这些限制。

所有使用非SDK接口的三方应用 • 重新做接口扫描

• 关注应用有没有使用深灰名单和黑名单非SDK接口，需要

适配和整改

• 无法整改的接口说明详细使用场景和理由反馈给谷歌申请

加灰名单

内联方法不能跨

如果应用内内联方法出现跨dex场景，系统将会直接abort，导致应用

使用热修复+插件框架的应用（淘

• 尽量避免使用不同的classloader来加载相关的（有互相调

加以下内容：<uses-library

android:name="org.apache.http.legacy"

android:required="false"/>

• 使用 HttpURLConnection 类替代apache-http

1. 谷歌API LEVEL要求，应用2019上架谷歌Play商店需要应用升级自己的targetSdkVersion到28，具体参考：

https://android-developers.googleblog.com/2019/02/expanding-target-api-level-requirements.html

2. 2018年要求升级targetSdkVersion到26；

3. P版本上通过targetSdkVersion控制生效的变更需要重点关注，其他版本变更的适配请关注：

https://developer.android.google.cn/distribute/best-practices/develop/target-sdk.html

Android Q版本变更列表

需要应用按照通知提醒的方式适配解决

• 如果确实需要隐藏，可以通过担保应用担保来适配

serviceTypes);

• 有问题的接口需要应用适配和整改

• 无法整改的接口说明详细使用场景和理由反馈给谷歌申请加

灰名单

需要应用适配解决

Android Q版本变更列表

Google Q版本变化点 说明 第三方应用影响 Q版本处理策略

• Android Q更改了默认情况下getCameraCharacteristics()方法返回的

信息的广度。特别是，您的应用必须具有CAMERA权限才能访问此方

法的返回值中包含的潜在设备特定元数据。

相机场景 需要应用适配解决

• 查询sql语句管控，不合法的查询列会导致返回的查询数据为空，除了

影响应用的多媒体查询，可能导

致查询结果为空

• 应用不能再通过获取的“_data”值作为文件真实路径判断

文件是否存在或者直接进行读写

• 主要影响TargetSdkVersion<24的应用

• 屏通知增加权限：对于TargetSdkVersion>=Q且通知设置了全屏属性

(fullscreenIntent)，需要增加USE_FULL_SCREEN_INTENT权限通知

• 优先级(Importance)调整：增加通知助手NotificationAssistant去调

整通知优先级

不适配可能出现：

• 通知无法横幅显示

• 通知无法全屏显示

• 通知无法响铃、震动

需要应用适配解决

Android Q版本变更列表

Google Q版本变化点 说明 第三方应用影响 Q版本处理策略

• 2D 绘制，hwui通路增加skiavulkan pipeline；

• 3D 绘制，opengl接口增加Angle实现，可以选择通过vulkan实现

opengl API

• vulkan版本升级到vulkan1.1；

• 对外接口没有变化，不会导致

兼容性问题，但是应用也需要

排查有没有依赖OpenGL的私

有接口

• 可能存在显示问题

应用排查是否依赖OpenGL的私有接口，如果有需要整改

• TargetSdkVersion>=Q:除非您的应用具有ACCESS_FINE_LOCATION

权限，否则在Android Q上运行时，您的应用无法在Wi-Fi，Wi-Fi

Aware或蓝牙API中使用多种方法。

对通过wifi，网络和蓝牙接口定位

有影响

应用升级TargetSdkVersion的话需要适配

• 更新的应用，2019-11-1以后上架谷歌play要求应用的native代码需要

提供64位的版本

• 新开发的应用，2019-8-1以后上架谷歌Play要求应用的

TargetSdkVersion>=28

• 更新的应用，2019-11-1以后上架谷歌play要求应用的

TargetSdkVersion>=28

需要上架play商店的应用 重点关注TargetSdkVersion控制生效的一些特性，特别是P

版本

• 应用的TargetSdkVersion<23，应用首次启动会弹框警告 所有三方应用 需要应用升级TargetSdkVersion到23

1. Android Q为每个应用程序在外

部存储设备提供了一个独立的存储

沙箱，应用通过路径创建的文件都

保存在应用的沙箱目录

2. 共享集合：如果应用的一些文件

用读写自己创建的文件不需要权限

，但是如果需要读取其他应用创建

的多媒体文件就需要申请对应的权

限，通过MediaProvider接口读取

4. 读写其他应用的下载公共集合文

件需要使用SAF的方式读写

5. 目前版本该特性没有默认开启，

需要开发者通过命令开启：adb

shell sm set-isolated-storage on

6. 参考谷歌提供的官方适配指导文档：https://developer.android.google.cn/preview/privacy/scoped-storage