Android 10（API 级别 29）引入了许多功能和行为变更，旨在更好地保护用户的隐私。这些变更让用户能够更清楚地了解和控制自己的数据以及他们授予应用的权限。 这些功能可能意味着，与旧版平台相比，应用所依赖的特定行为或数据可能会有所不同。 如果您的应用遵循当前处理用户数据的最佳实践，那么对应用的影响应该微乎其微。
本页面列出了每项变更的摘要。
重大变更
本部分介绍了 Android 10 中与隐私权相关的重要变更。
外部存储访问权限范围限定为应用文件和媒体
默认情况下，以 Android 10 及更高版本为目标平台的应用在访问外部存储设备中的文件时存在范围限制，即分区存储。此类应用可以查看外部存储设备内以下类型的文件，无需请求任何与存储相关的用户权限：
- 应用专用目录中的文件，使用
getExternalFilesDir()访问。 - 应用创建的照片、视频和音频片段（通过媒体库访问）。
如需详细了解分区存储以及如何共享、访问和修改在外部存储设备上保存的文件，请参阅有关如何管理外部存储设备中的文件以及如何访问和修改媒体文件的指南。
在后台运行时访问设备位置信息需要权限
为了让用户更好地控制应用对位置信息的访问权限，Android 10 引入了 ACCESS_BACKGROUND_LOCATION 权限。
不同于 ACCESS_FINE_LOCATION 和 ACCESS_COARSE_LOCATION 权限，ACCESS_BACKGROUND_LOCATION 权限仅会影响应用在后台运行时对位置信息的访问权限。除非符合以下条件之一，否则应用将被视为在后台访问位置信息：
- 属于该应用的 Activity 可见。
该应用正在运行一项前台服务，该服务已声明前台服务类型为
location。如需为应用中的服务声明前台服务类型，请将应用的
targetSdkVersion或compileSdkVersion设置为29或更高级别。详细了解前台服务如何继续执行需要访问位置信息的用户发起的操作。
如果您的应用创建和监控地理围栏，并且以 Android 10（API 级别 29）或更高版本为目标平台，您必须声明 ACCESS_BACKGROUND_LOCATION 权限。
以 Android 9 或更低版本为目标平台时自动授予访问权限
如果您的应用在 Android 10 或更高版本上运行，但其目标平台是 Android 9（API 级别 28）或更低版本，则 Android 平台具有以下行为：
- 如果您的应用为
ACCESS_FINE_LOCATION或ACCESS_COARSE_LOCATION声明了<uses-permission>元素，系统会在安装期间自动为ACCESS_BACKGROUND_LOCATION添加<uses-permission>元素。 - 如果您的应用请求了
ACCESS_FINE_LOCATION或ACCESS_COARSE_LOCATION，系统会自动将ACCESS_BACKGROUND_LOCATION添加到请求中。
在设备升级到 Android 10 后访问
如果用户向您的应用授予了设备位置信息访问权限（ACCESS_COARSE_LOCATION 或 ACCESS_FINE_LOCATION），然后将其设备从 Android 9 升级到 Android 10，系统会自动更新授予您应用的一组基于位置信息的权限。升级后您的应用收到的一组权限取决于其目标 SDK 版本及其定义的权限，如下表所示：
表 1. 设备升级到 Android 10 后 位置信息权限状态的变化
| 目标平台版本 | 是否已授予粗略或精确 权限？ |
是否在清单中定义了后台权限 ？ |
更新后的默认权限状态 |
|---|---|---|---|
| Android 10 | 是 | 是 | 前台和后台访问权 |
| Android 10 | 是 | 否 | 仅前台访问权 |
| Android 10 | 否 | （被系统忽略） | 无访问权 |
| Android 9 或更低版本 | 是 | 在设备升级时由系统自动添加 | 前台和后台访问权 |
| Android 9 或更低版本 | 否 | （被系统忽略） | 无访问权限 |
请注意，即使系统自动更新了应用对设备位置信息的访问权限，用户也可以更改此访问权限级别。例如，用户可能会将应用的访问权限降级为仅限前台，或完全撤消访问权限。在尝试访问设备的位置信息之前（尤其是在前台服务中），应用应检查用户是否仍允许应用接收此位置信息。
在 Android 10 设备上更新目标 API 级别时，访问权限被撤消
假设您的应用已安装在搭载 Android 10 的设备上。如果您在这种情况下将应用更新为以 Android 10 为目标平台，设备会撤消 ACCESS_BACKGROUND_LOCATION 权限。
如需详细了解如何在应用处于后台时检索设备的位置信息，请参阅有关接收定期位置信息更新的指南。
针对从后台启动 activity 的限制
从 Android 10 开始，系统会限制从后台启动 activity。此行为变更可帮助尽可能减少对用户的干扰，并让用户更好地控制屏幕上显示的内容。只要您的应用启动 activity 是因用户互动直接引发的，该应用就极有可能不会受到这些限制的影响。
如需详细了解从后台启动 activity 的建议替代方法，请参阅有关如何在应用中提醒用户注意有时效性的事件的指南。
标识符和数据
本部分列出了针对如何使用标识符和数据的变更。
移除了联系人关系密切程度
从 Android 10 开始，平台不会跟踪联系人亲密程度信息。因此，如果您的应用对用户的联系人进行搜索，系统将不会按互动频率对搜索结果排序。
ContactsProvider 相关指南中包含一条通知，其中说明了从 Android 10 开始在所有设备上废弃的特定字段和方法。
随机分配 MAC 地址
在搭载 Android 10 或更高版本的设备上，系统默认传输随机分配的 MAC 地址。
如果您的应用处理企业用例，则平台会提供与 MAC 地址相关的多项操作的 API：
- 获取随机分配的 MAC 地址：设备所有者应用和资料所有者应用可以通过调用
getRandomizedMacAddress()检索分配给特定网络的随机分配 MAC 地址。 - 获取实际的出厂 MAC 地址：设备所有者应用可以通过调用
getWifiMacAddress()检索设备的实际硬件 MAC 地址。此方法对于跟踪设备队列非常有用。
对 /proc/net 文件系统的访问权限实施了限制
在搭载 Android 10 或更高版本的设备上，应用无法访问 /proc/net，包括与设备的网络状态相关的信息。需要访问此信息的应用（如 VPN）应使用 NetworkStatsManager 或 ConnectivityManager 类。
对不可重置的设备标识符实施了限制
从 Android 10 开始，应用必须具有 READ_PRIVILEGED_PHONE_STATE 特许权限才能访问设备的不可重置标识符（包括 IMEI 和序列号）。
受影响的方法包括：
BuildTelephonyManager
如果您的应用没有该权限，而您仍尝试请求有关不可重置标识符的信息，则平台的响应会因目标 SDK 版本而异：
- 如果您的应用以 Android 10 或更高版本为目标平台，则会发生
SecurityException。 - 如果您的应用以 Android 9（API 级别 28）或更低版本为目标平台，并且具有
READ_PHONE_STATE权限，则该方法会返回null或占位数据。否则，系统会显示SecurityException。
许多使用场景都不需要不可重置的设备标识符。例如，如果您的应用出于广告跟踪或用户分析目的而使用不可重置的设备标识符，请改为使用 Android 广告 ID 来实现这些特定用例。如需了解详情，请参阅唯一标识符最佳实践。
限制了对剪贴板数据的访问权限
对于 Android 10 或更高版本，除非您的应用是默认输入法 (IME) 或是目前聚焦的应用，否则它无法访问剪贴板中的数据。
保护 USB 设备序列号
如果您的应用以 Android 10 或更高版本为目标平台，则在用户向您的应用授予访问 USB 设备或配件的权限之前，您的应用无法读取序列号。
如需详细了解如何使用 USB 设备，请参阅有关如何配置 USB 主机的指南。
摄像头和连接性
本部分列出了相机元数据和连接性 API 的特定变更。
对访问摄像头详情和元数据的权限实施了限制
Android 10 更改了 getCameraCharacteristics() 方法默认返回的信息的广度。具体而言，您的应用必须具有 CAMERA 权限才能访问此方法的返回值中可能包含的设备特定元数据。
如需详细了解这些变更，请参阅需要权限的相机字段部分。
对启用和停用 WLAN 实施了限制
以 Android 10 或更高版本为目标平台的应用无法启用或停用 Wi-Fi。WifiManager.setWifiEnabled() 方法始终返回 false。
如果您需要提示用户启用或停用 Wi-Fi，请使用设置面板。
对直接访问已配置的 Wi-Fi 网络实施了限制
为了保护用户隐私，只有系统应用和设备政策控制器 (DPC) 支持手动配置 Wi-Fi 网络列表。给定的 DPC 可以是设备所有者，也可以是资料所有者。
如果应用以 Android 10 或更高版本为目标平台，并且应用不是系统应用或 DPC，则下列方法不会返回有用数据：
getConfiguredNetworks()方法始终返回空列表。每个返回整数值的网络操作方法（
addNetwork()和updateNetwork()）始终返回 -1。每个返回布尔值的网络操作（
removeNetwork()、reassociate()、enableNetwork()、disableNetwork()、reconnect()和disconnect()）始终返回false。
如果您的应用需要连接到 Wi-Fi 网络，请使用以下替代方法：
- 如需触发与 Wi-Fi 网络的即时本地连接，请在标准
NetworkRequest对象中使用WifiNetworkSpecifier。 - 如需添加 Wi-Fi 网络以供考虑为用户提供互联网访问权限，请使用
WifiNetworkSuggestion对象。您可以通过分别调用addNetworkSuggestions()和removeNetworkSuggestions()来添加和移除自动连接网络选择对话框中显示的网络。这些方法不需要任何位置权限。
一些电话 API、蓝牙 API 和 WLAN API 需要精确位置权限
如果您的应用以 Android 10 或更高版本为目标平台，则必须具有 ACCESS_FINE_LOCATION 权限才能使用 Wi-Fi、Wi-Fi Aware 或蓝牙 API 中的多种方法。以下部分列出了受影响的类和方法。
电话
TelephonyManagergetCellLocation()getAllCellInfo()requestNetworkScan()requestCellInfoUpdate()getAvailableNetworks()getServiceState()
TelephonyScanManagerrequestNetworkScan()
TelephonyScanManager.NetworkScanCallbackonResults()
PhoneStateListeneronCellLocationChanged()onCellInfoChanged()onServiceStateChanged()
WLAN
WifiManagerstartScan()getScanResults()getConnectionInfo()getConfiguredNetworks()
WifiAwareManagerWifiP2pManagerWifiRttManager
蓝牙
BluetoothAdapterstartDiscovery()startLeScan()
BluetoothAdapter.LeScanCallbackBluetoothLeScannerstartScan()
权限
本部分介绍了 Android 权限模型的相关更新。
限制对屏幕内容的访问
为了保护用户的屏幕内容，Android 10 通过更改 READ_FRAME_BUFFER、CAPTURE_VIDEO_OUTPUT 和 CAPTURE_SECURE_VIDEO_OUTPUT 权限的范围，防止应用以静默方式访问设备的屏幕内容。从 Android 10 开始，这些权限仅限签名访问。
需要访问设备屏幕内容的应用应使用 MediaProjection API，此 API 会显示要求用户同意访问的提示。
面向用户的权限检查（针对旧版应用）
如果您的应用以 Android 5.1（API 级别 22）或更低版本为目标平台，当用户首次在搭载 Android 10 或更高版本的设备上使用您的应用时，会看到一个权限屏幕，如图 1 所示。用户可以在此界面中撤消系统之前在安装时向您的应用授予的权限。
身体活动识别
Android 10 针对需要检测用户步数或对用户的身体活动（例如步行、骑车或坐车）进行分类的应用引入了 android.permission.ACTIVITY_RECOGNITION 运行时权限。此项权限旨在让用户了解设备传感器数据在“设置”中的使用方式。
Google Play 服务中的某些库（例如 Activity Recognition API 和 Google 健身 API）不会提供结果，除非用户已向您的应用授予此权限。
设备上唯一需要您声明此权限的内置传感器是计步器和步测器传感器。
如果您的应用以 Android 9（API 级别 28）或更低版本为目标平台，并且满足以下所有条件，系统会根据需要自动向您的应用授予 android.permission.ACTIVITY_RECOGNITION 权限：
- 清单文件包含
com.google.android.gms.permission.ACTIVITY_RECOGNITION权限。 - 清单文件不包含
android.permission.ACTIVITY_RECOGNITION权限。
如果系统自动授予了 android.permission.ACTIVITY_RECOGNITION 权限，则在您将应用更新为以 Android 10 为目标平台后，应用会保留该权限。不过，用户可以随时在系统设置中撤消此权限。
从界面中移除了权限组
从 Android 10 开始，应用无法在界面中查找权限的分组方式。