Android Q（Android 10 API 29）新特性及适配指南手机共享「Android Q（Android 10 API 29）新特性及适配指南」

在开始版本中，官方的改动较大，相应的开发者适配成本还是很高的。
这里按照流程，大概说明一下Android Q适配需要注意的内容。虽然是大概介绍，但应该是目前最全的适配攻略了…

• 存储变更（Scoped Storage in Android 10）
• 非SDK 接口
• 设备ID
• 权限
• 新功能——夜间模式

官方适配文档：
https://developer.android.com/about/versions/10

从Android Q（Android 10 API 29）开始，即便应用请求了权限，其对全局外部存储的访问也受到限制，鼓励开发者采用的新规范来。，需要请求权限来，由于此权限的强大访问能力，，确保应用的用途正当且必要。

为了解决Android文件混乱的问题，从Android Q（Android 10 API 29）开始，Android对进行一定的限制。

• 通过 与访问应用专属存储目录；
• 通过申请权限，使用 API，访问共享媒体目录（如Photos、Screenshots等目录）。
• 通过API Storage Access Framework读取手机的文件夹，。

1.1 应用专属路径

通过 与访问应用专属存储目录，：

• 内部存储路径
• 外部存储路径

1.2 手机共享路径

通过申请权限，使用 API，访问共享媒体目录（如Photos、Screenshots等目录）：

• 图片：Photos、Screenshots 使用MediaStore.Images API访问
• 视频：使用MediaStore.Video API访问
• 音频：使用 MediaStore.Audio API访问

1.3 Downloads文件夹

读取手机的Downloads文件夹，不需要任何权限，需要使用API Storage Access Framework

1.4 Scoped Storage的 targetSdk低于29的情况

如果应用的并，那么该应用可以暂时继续使用旧的存储访问方式，但建议对应的开发者尽快迁移到Scoped Storage模型。

1.5 Scoped Storage的 requestLegacyExternalStorage=“true”

对于适配难度较大的应用，Android提供了一种方式可以暂时。
在androidmanifest配置文件中将设置为，可以。
将设置为，可以，但Google明确表示这是一个，并且在未来的Android版本中可能会移除或不再支持。因此，开发者应计划逐步迁移应用至遵循Scoped Storage模型。

requestLegacyExternalStorage="true"的使用方式如下：

官方描述如下：
https://developer.android.google.cn/training/data-storage/use-cases

1.6 官方文档参考：

外部存储访问权限范围限定为应用文件和媒体：
https://developer.android.com/about/versions/10/privacy/changes#scoped-storage

Manage scoped external storage access：
https://developer.android.com/training/data-storage/files/external-scoped

requestLegacyExternalStorage="true"官方描述：
https://developer.android.google.cn/training/data-storage/use-cases

MANAGE_EXTERNAL_STORAGE权限官方描述：
https://developer.android.google.cn/training/data-storage/manage-all-files

官方文档：针对非 SDK 接口的限制

官方从 Android 9（API 级别 28）开始，对应用使用的非 SDK 接口实施了限制。
如果你的APP通过引用或尝试，这些限制就会起作用。官方给出的解释是为了风险。

2.1 非SDK接口检测工具

官方给出了一个检测工具，下载地址
Google官方 veridex下载：
https://android.googlesource.com/platform/prebuilts/runtime/+/master/appcompat

CSDN资源镜像 veridex下载：
https://download.csdn.net/download/aiwusheng/80980831

veridex使用方法：

2.2 blacklist、greylist、greylist-max-o、greylist-max-p含义

以上截图中，blacklist、greylist、greylist-max-o、greylist-max-p含义如下：

• blacklist 黑名单：禁止使用的非SDK接口，运行时直接Crash（因此必须解决）
• greylist 灰名单：即当前版本仍能使用的非SDK接口，但在下一版本中可能变成被限制的非SDK接口
• greylist-max-o： 在targetSDK<=O中能使用，但是在targetSDK>=P中被禁止使用的非SDK接口
• greylist-max-p： 在targetSDK<=P中能使用，但是在targetSDK>=Q中被禁止使用的非SDK接口

如果觉得我没有说清楚，可以看以下

2.3、Android Q 加固 与 热修复

关于加固与热修复，官方也提供了相应的API

• 加固
  

• 热修复
  

注：
未适配Android Q的应用，若使用了blacklist 相关接口，在Android Q系统上打开时，会直接Crash！
未适配Android Q的应用，若使用了blacklist 相关接口，在Android Q系统上打开时，会直接Crash！
未适配Android Q的应用，若使用了blacklist 相关接口，在Android Q系统上打开时，会直接Crash！

，曾经用等设备信息标识设备的方法，从Android 10开始统统失效。而且无论你的APP是否是配过Android 10。

3.1 IMEI等设备信息

从Android10开始不再允许请求权限。
而且，无论你的App是否适配过Android Q（既是否大于等于29），均无法再获取到设备等设备信息。

受影响的API如下：

的应用，其在获取设备ID时，会直接返回
的应用，其在获取设备ID时，会直接跑出异常

如果您的App希望，可按以下方式进行适配：

谁能访问设备ID？

从Android 10开始，哪些应用还能访问设备ID？

Google官方的描述如下：
https://source.android.com/devices/tech/config/immutable-device-ids?hl=zh-cn

• 默认的短信应用。
• 具有 READ_PRIVILEGED_PHONE_STATE 权限，并且在 privapp-permission.xml 文件中列入白名单的应用。
  这些应用还必须加载到 system/priv-app 目录中。
• 具有 UICC 运营商权限中定义的运营商权限的应用。
• 具有 READ_PHONE_STATE 权限的设备所有者或资料所有者（无需列入白名单）。
  

从Android10开始，默认情况下，在搭载 Android 10 或更高版本的设备上，系统会传输随机分配的 MAC 地址。（既从Android 10开始，普通应用已经无法获取设备的真正mac地址，标识设备已经无法使用mac地址）

Google给出的解决方案是：如果您的应用有 的需求，可用来标识设备。

• ANDROID_ID的生成规则为：
• ANDROID_ID重置规则：

也就是，曾经用等设备信息标识设备的方法，从Android 10开始统统失效。而且无论你的APP是否是配过Android 10。

求高手留言解答：
在Android 10系统上，目前本人尚未找到标识设备唯一性的办法，如果大家有办法希望留言告知！！！

主要包括：

• 在后台运行时访问设备位置信息
• 从后台启动 Activity 的限制
• 屏幕录制
• 摄像头和麦克风
• 剪切板隐私限制

4.1 在后台运行时访问设备位置信息

Android 10 引入了 权限。
若应用在后台运行时，访问手机位置，需要动态申请该权限，用户则可以选择拒绝。

官方给出的数据，大部分用户对位置信息是比较敏感的。而且大部分用户是不允许应用在后台使用位置信息的。

4.2 从后台启动 Activity 的限制

具体内容请查看官方文档

4.3 屏幕录制

不需要手动申请权限，但官方 API内部会向用户弹窗申请权限

4.4 摄像头和麦克风

Android 9 摄像头和麦克风 后台权限已经移除了

4.5 活动探知——新增权限

4.6 剪切板隐私限制

从Android P开始，除非你的应用是默认输入法，否则它无法访问用户的剪贴板数据；但向剪切板写入数据不影响。

关于夜间模式，感兴趣的同学，可以查看我的另一篇文档：