从 2025 年 3 月 27 日起，我们建议使用 android-latest-release 而不是 aosp-main 来构建 AOSP 并为其做贡献。如需了解详情，请参阅AOSP 变更。

Android 14、Android 14-QPR1 和 Android 14-QPR2 版本说明
通过集合保持井井有条根据您的偏好保存内容并对其进行分类。

本页总结了 Android 14、Android 14-QPR1 和 Android 14-QPR2 版本中的主要功能，并提供了指向其他信息的链接。这些功能摘要是根据功能在本网站上的文档位置进行组织的。

架构

backend.[cpp|ndk].additional_shared_libraries

backend.[cpp|ndk].additional_shared_libraries 在 Android 14 中引入，可向原生库添加依赖项，并且与 ndk_header 和 cpp_header 结合使用时非常有用。如需了解详情，请参阅定义 AIDL 接口。

gen_trace 值

从 Android 14 开始，gen_trace 对于 cpp 和 java 后端均设置为 true。如需了解详情，请参阅定义 AIDL 接口。

内核支持

从 Android 14 开始，不再支持 5.4 内核。请参阅功能和启动内核上的更新内核信息。

内核唤醒源统计信息

Android 14-QPR2 将唤醒源统计信息添加到 logcat。这些统计信息可识别内核中在每次挂起和恢复周期期间保持系统唤醒状态的组件，并且可用于调试内核性能和改进电池续航时间。内核唤醒源统计信息仅在用户调试和工程版本中可用，这些版本已将 suspend.debug.wakestats_log.enabled 设置为 true。如需了解详情，请参阅 logKernelWakeLockStats。

音频

动态音响条模式

借助 Android 14 框架支持，可以将具有内置或连接扬声器的机顶盒 (STB) 和 OTT 设备配置为连接设备的音响条。如需了解详情，请参阅动态音响条模式。

将 Audio HAL 迁移到 AIDL

从 Android 14 开始，Audio HAL 接口使用 AIDL 进行定义。如需了解详情，请参阅AIDL 实现和AIDL 和 HIDL Audio HAL 比较。

多路 USB 设备路由更新

Android 14 USB 框架支持同时路由到多个 USB 设备。如需了解详情，请参阅组合音频设备路由。

USB 设备上的首选混音器属性

Android 14 提供了开发者 API，应用可以使用这些 API 查询和配置 USB 音频播放的首选混音器属性。如需了解详情，请参阅USB 设备上的首选混音器属性。

声音剂量

Android 14 通过持续监控声音剂量测量值并向用户发出关于有害暴露级别的警告，为音频框架和 Audio HAL 中的声音剂量提供支持。如需了解详情，请参阅声音剂量。

从 Android 14-QPR1 开始，声音剂量的计算功能已启用。

相机

相机扩展功能

Android 14 将以下功能添加到相机扩展接口的 1.4.0 版本

设备用作网络摄像头

Android 14-QPR1 添加了对将设备用作 USB 网络摄像头的支持。支持此功能的 Android 设备会宣传为 UVC 设备，这使得具有不同操作系统的各种 USB 主机（例如，Linux、macOS、Windows 和 ChromeOS）可以将设备的摄像头用作网络摄像头。如需了解详情，请参阅将设备用作网络摄像头。

参考 USB 相机 HAL

Android 14 将参考 USB 相机 HAL 迁移到 AIDL，并弃用了 HIDL 实现。如需了解关于 USB 相机 HAL 的信息，请参阅外部 USB 相机。

Ultra HDR

Android 14 添加了对使用 JPEG_R 图像格式捕获 Ultra HDR 压缩图像的支持。此格式向后兼容 SDR JPEG 图像，并支持 HDR 内容渲染。如需了解详情，请参阅Ultra HDR。

广色域捕获

Android 14 添加了对 Display P3 广色域捕获的支持，这使得设备可以使用 ImageReader 类以 JPEG 格式捕获广色域彩色图像，而无需使用 10 位 HDR。如需了解详情，请参阅广色域捕获。

兼容性

相机 ITS 更新

Android 14 引入了对相机 ITS 测试的更新，其中包括 Python 和软件包版本的更新、更新后的测试以及新测试。如需了解更多详情，请参阅Android 14 相机图像测试套件版本说明。

CDD 更新

Android 14 兼容性定义文档在以前的版本基础上进行了迭代，并针对新功能和先前发布的功能的要求变更进行了更新。如需查看 Android 14 中的变更列表，请参阅Android 14 兼容性定义版本说明。

CTS 版本说明

请参阅Android 14 CTS 版本说明，了解 Android 14 的主要 CTS 变更列表。

用于存在感应校准的 CTS 验证程序测试

Android 14 添加了 CTS 验证程序测试，用于验证更新后的 WLAN 邻居感知网络 (NAN) 和 BLE RSSI 存在感应校准要求。其中包括 NAN 精度、BLE RSSI 准确度和 BLE Rx/Tx 偏移精度测试。如需了解详情，请参阅存在感应校准。

性能等级 14 (PC14) - 视频编码质量 (VEQ) CTS 测试

Android 14 为性能等级 14 (PC14) 设备引入了视频编码质量 (VEQ) 要求。PC14-VEQ 要求通过名为 CtsVideoEncodingQualityHostTest 的新 CTS 测试进行验证。如需了解详情，请参阅运行 PC14-VEQ 测试。

连接

5G 切片追加销售

Android 14-QPR1 引入了 5G 切片追加销售功能，该功能让运营商可以通过 5G 网络切片向用户提供增强的网络功能（延迟和带宽）。如需了解详情，请参阅5G 切片追加销售。

助听器设备的 ASHA 广播

为了改进 ASHA 和 LE Audio 双模式助听器设备上的蓝牙配对体验，Android 14 允许使用 ASHA 功能字节中的第二个位（以 0 为索引）来指示设备是否支持协调集识别服务 (CSIS)。如需了解详情，请参阅使用蓝牙 LE 的助听器音频支持。

eSIM 多启用配置文件 (MEP) 更新

Android 14 支持 GSMA SGP V22 3.0 中指定的 MEP-A1 和 MEP-B 选项，用于选择发行商安全域根 (ISD-R) 和 eSIM 端口。如需了解详情，请参阅多启用配置文件。

GNSS

Android 14 引入了以下 GNSS 功能和 API，这些功能和 API 通过 GNSS AIDL HAL 接口提供

GnssCapabilities.getGnssSignalTypes：返回 GNSS 芯片组支持的 GNSS 信号类型列表。
GnssCapabilities.hasAccumulatedDeltaRange：确定 GNSS 芯片组是否支持累积增量范围。
GnssMeasurementsEvent.isFullTracking：指示 GNSS 引擎是否处于完全跟踪模式。

搭载 Android 14 的设备必须使用 GNSS AIDL HAL。GNSS 框架支持 HIDL HAL，以用于升级到 Android 14 的设备，但新的 GNSS 功能仅通过 GNSS AIDL HAL 接口提供。

强烈建议搭载 Android 14 或更高版本的芯片组和设备（包括 GPS 或 GNSS 接收器并通过 android.hardware.location.gps 功能标记向应用报告功能）支持累积增量范围功能。

IMS API 更新

Android 14 引入了以下对 ImsService 的更新

添加了 SipDetails 类，该类允许 ImsService 报告在 IMS 注册、IMS 发布或 IMS 订阅过程结束时从网络传送的 SIP 响应中的关键信息。这让实现 RCS 单注册的应用在发生网络或设备问题时，可以更清楚地了解 SIP 交易响应，以便可以快速解决错误或中断。

以下类中添加了 SipDetails 报告
- ImsRegistrationImplBase、RegistrationManager.RegistrationCallback 和 ImsRegistrationAttributes：允许在从网络返回 SIP REGISTER 响应时报告详细的 SIP 交易结果信息。
- RcsUceAdapter.CapabilitiesCallback 和 RcsCapabilityExchangeImplBase.SubscribeResponseCallback：允许在从网络返回 SIP SUBSCRIBE 响应时报告更详细的信息。
- RcsUceAdapter.OnPublishStateChangedListener、PublishAttributes, CapabilityExchangeEventListener 和 RcsCapabilityExchangeImplBase.PublishResponseCallback：允许在从网络返回 SIP PUBLISH 响应时报告更详细的信息。
添加了 MediaQualityStatus 和 MediaThreshold 类，以提供对 IMS 媒体质量报告的支持。MmTelFeature 中的以下方法允许将媒体质量更新报告给其他系统应用（例如 QualifiedNetworksService），这有助于确定何时更改 IMS PDN 传输
媒体质量更新通过 TelephonyCallback#MediaQualityStatusChangedListener 接口报告。
在 AOSP 中添加了对基于终端的呼叫等待的支持，如 IR.92 要求（2.3.4 通信等待）中所定义。这样就无需依赖每个 ImsService 实现来实现这些要求。

要在 AOSP 中启用此功能
- 设置功能 ImsService#CAPABILITY_TERMINAL_BASED_CALL_WAITING 并实现 MmTelFeature#setTerminalBasedCallWaitingStatus 方法。
- 在每个运营商的基础上配置以下 CarrierConfigManager 密钥，以针对特定运营商启用基于终端的呼叫等待
  - ImsSs#KEY_UT_TERMINAL_BASED_SERVICES_INT_ARRAY
  - ImsSs#SUPPLEMENTARY_SERVICE_CW
  - ImsSs#KEY_TERMINAL_BASED_CALL_WAITING_SYNC_TYPE_INT
  - ImsSs#KEY_TERMINAL_BASED_CALL_WAITING_DEFAULT_ENABLED_BOOL
为了改进 ImsService 的线程处理，在 ImsSmsImplBase 上添加了一个构造函数，该构造函数允许实现者在类构造期间提供执行器。此执行器可用于在特定线程上调度入站 IPC 请求。

合格网络服务

Android 14 将合格网络服务 (QNS) 服务添加到 Telephony 模块。此服务是 QualifiedNetworksService.java 的实现。

QNS 根据设备的网络状态和运营商政策评估可用的接入网络，确定每种 APN 类型（例如，IMS、MMS 和 EMERGENCY）的最佳接入网络，并将信息报告给电话通信框架，以便为数据网络选择传输类型。QNS 提供了 100 多个运营商配置，以支持运营商要求。

QNS 是一项可选服务。要启用 QNS，请将 config_qualified_networks_service_package 配置的值设置为 com.android.telephony.qns。

<string name="config_qualified_networks_service_package">
    com.android.telephony.qns
</string>

暂停和恢复 WLAN 感知探索会话

Android 14 支持特权应用暂停和恢复 WLAN 感知活动探索会话。这使得设备可以更快地恢复探索会话并降低功耗。如需了解详情，请参阅暂停和恢复。

Telecom VoIP API

Android 14 引入了 TelecomManager#addCall API，该 API 取代了 ConnectionService 类以用于 VoIP 用例。此 API 构成了新的 Telecom CallsManager Jetpack 类的基础，该类简化了将 VoIP 呼叫与 Android 平台集成的过程。Jetpack 类为开发者提供了可在 Android 14 或更高版本上使用的单个 API 界面，以及封装现有 ConnectionService 类的向后兼容性层。我们建议开发者直接使用 Telecom CallsManager Jetpack 类，以面向最大范围的 Android SDK 版本。

时间和时区检测更新

Android 14 引入了以下针对 Android 上时间和时区检测的更新

为时间建议添加了时间上限。如需了解详情，请参阅允许的时间范围。
添加了对多个 NTP 服务器的支持。如需了解详情，请参阅服务器。
更新了仅支持位置时区检测的设备的行为。如需了解详情，请参阅仅支持位置时区检测算法的设备。
添加了 API，以允许位置时区提供程序报告状态信息。如需了解详情，请参阅LTZP 状态 API。

超宽带测试

Android 14 添加了新的手动 CTS 测试，以验证是否符合超宽带 (UWB) 要求。如需详细了解如何设置设备和运行此测试，请参阅UWB 要求。

UWB HAL 接口

Android 14 为 UWB HAL 接口添加了以下内容

Android OID

ANDROID_RANGE_DIAGNOSTICS

UWB 会话配置消息参数

ENABLE_DIAGNOSTICS
DIAGRAMS_FRAME_REPORTS_FIELDS

UWB 功能消息参数

SUPPORTED_MIN_SLOT_DURATION_RSTU
SUPPORTED_MAX_RANGING_SESSION_NUMBER
SUPPORTED_CHANNELS_AOA

状态代码

STATUS_ERROR_STOPPED_DUE_TO_OTHER_SESSION_CONFLICT
STATUS_REGULATION_UWB_OFF

状态变更原因代码

REASON_ERROR_INVALID_CHANNEL_WITH_AOA
REASON_ERROR_STOPPED_DUE_TO_OTHER_SESSION_CONFLICT
REASON_REGULATION_UWB_OFF

如需了解更多详情，请参阅UWB HAL 接口。

WLAN 7

Android 14 引入了新功能和改进，以支持 WLAN 7。如需了解详情，请参阅WLAN 7。

WLAN 供应商 HAL

从 Android 14 开始，WLAN 供应商 HAL 使用 AIDL 进行定义。如需了解更多信息，请参阅WLAN HAL。

Cuttlefish

Cuttlefish WLAN 功能更新

从 Android 14 开始，Cuttlefish WLAN 功能包括 WmediumdService 和 OpenwrtControlService 工具，用于控制 Cuttlefish 设备上的 WLAN。如需了解更多详情，请参阅Cuttlefish：WLAN。

显示

WindowManager 扩展程序

Android 14 在 WindowManager 扩展程序中添加了对双显示模式、加载时的性能影响以及 COMMON_STATE_USE_BASE_STATE 设备专用状态标识符的支持。

企业

企业设备政策解决框架

从 Android 14 开始，多个设备政策管理代理可以使用 DevicePolicyManager API 设置政策。如需了解详情，请参阅设备政策解决框架。

图形

Android 基准配置文件 (ABP) 和 Vulkan 实现

任何支持 Android 14 或更高版本以及 Vulkan API 的设备都必须满足 Android Baseline 2021 配置文件中定义的所有功能。如需了解详情，请参阅实现 Vulkan。

减少图形缓冲区内存消耗

从 Android 14 开始，您可以强制清除图形缓冲区缓存，以减少图形内存消耗。如需了解更多信息，请参阅减少图形内存消耗。

Vulkan 1.1 采用

对于 Android 14 及更高版本，所有支持 Vulkan 的设备都必须具有 Vulkan 1.1 驱动程序。如需了解更多信息，请参阅 Android 14 CDD 要求。

性能

提升游戏性能

从 Android 14 开始，名为 GAME 的新电源模式支持在游戏使用期间自定义手机性能。如需了解详情，请参阅提升游戏性能。

权限

捕获笔记内容

从 Android 14 开始，“捕获笔记内容”API 让用户可以直接通过默认的记事应用捕获屏幕截图。如需了解详情，请参阅捕获笔记内容。

COMPANION_DEVICE_GLASSES 角色

Android 14 中的 COMPANION_DEVICE_GLASSES 角色允许用户通过应用管理其眼镜设备，并执行访问联系人以及管理通知和电话呼叫等功能。如需了解更多详情，请参阅Android 角色上的 COMPANION_DEVICE_GLASSES。

COMPANION_DEVICE_NEARBY_DEVICE_STREAMING 角色

Android 14 中的 COMPANION_DEVICE_NEARBY_DEVICE_STREAMING 角色允许应用在已连接设备之间创建和管理通信渠道，以便在设备之间流式传输应用和发送通知。只有 OEM 可以授予此角色。如需了解更多详情，请参阅Android 角色上的 COMPANION_DEVICE_NEARBY_DEVICE_STREAMING。

全屏 intent 限制

为了防止广告垃圾邮件和凭据网络钓鱼，从 Android 14 开始，发送全屏通知的默认 USE_FULL_SCREEN_INTENT 权限只能授予提供通话和闹钟功能的应用。如需了解详情，请参阅全屏 intent 限制。

NOTES 角色

Android 14 中的 NOTES 角色支持记事功能，并提高了 Android 平板电脑的效率。借助 NOTES 角色，OEM 可以让最终用户在使用 Android 平板电脑上的手写笔时，在其首选记事应用上获得一致的记事体验。如需了解更多详情，请参阅Android 角色上的 NOTES。

电源

将 Thermal HAL 迁移到 AIDL

从 Android 14 开始，Thermal HAL 接口使用 AIDL 进行定义。如需了解详情，请参阅散热缓解。

PowerManager.ACQUIRE_CAUSES_WAKEUP 权限

Android 14 引入了 android.permission.TURN_SCREEN_ON 权限，这是一种特殊的应用访问权限，用户可在其“设置”中授予。今后，已弃用的 PowerManager#ACQUIRE_CAUSES_WAKEUP 常量需要此权限才能生效。您可以预先将该权限授予签名应用和特权应用。支持开启屏幕的推荐方法是使用 R.attr.turnScreenOn，这不需要新权限。

运行时

JDWP 线程创建

Android 14 添加了 persist.debug.dalvik.vm.jdwp.enabled 系统属性，以控制是否在用户调试版本中创建 Java 调试线协议 (JDWP) 线程。如需了解详情，请参阅JDWP 选项。

OpenJDK 17 更新

Android 14 继续致力于刷新 Android 的核心库，使其与最新的 OpenJDK LTS 版本中的功能保持一致，包括库更新以及对应用和平台开发者的 Java 17 语言支持。如需详细了解这些变更及其对 Android 开发者有何影响，请参阅OpenJDK 17 更新。

安全性

Android 14 安全版本说明

Android 安全版本说明详细说明了在 2022-09-01 安全补丁程序级别中修补的漏洞。在 AOSP 上发布的 Android 14 的默认安全补丁程序级别为 2023-09-01。如需了解更多详情，请参阅Android 14 安全版本说明。

停用 2G

Android 14 允许用户在任何实现功能常量“CAPABILITY_USES_ALLOWED_NETWORK_TYPES_BITMASK”的设备上，在无线装置硬件级别停用 2G。这会阻止设备扫描或连接到 2G 网络。请参阅停用 2G 文档，了解所有变更。

停用移动网络空密码/完整性模式

Android 14 在移动网络设置菜单中引入了一个新的切换开关，可以轻松停用非紧急呼叫的空密码。所有采用无线装置 HAL 2.0 及更高版本的设备都支持新的切换开关，OEM 可以选择启用该开关。允许用户停用空密码可通过防止 SMS 和语音流量在空中被动拦截（且无加密）来增强用户的隐私。

文件名加密

对于在 Android 14 中具有加速加密指令的设备，AES-HCTR2 是文件名加密的首选模式。如需了解更多详情，请参阅基于文件

多个 IMEI

Android 14 在 Android 密钥证明记录中添加了对多个 IMEI 的支持。OEM 可以通过为第二个 IMEI 添加 KeyMint 标记来实现此功能。设备具有多个移动无线装置的情况越来越普遍，现在 OEM 可以支持具有两个 IMEI 的设备。如需了解更多详情，请参阅证明。

只读文件

如果您的应用以 Android 14 为目标平台并使用动态代码加载 (DCL)，则所有动态加载的文件都必须标记为只读。否则，系统将抛出异常。我们建议应用尽可能避免动态加载代码，因为这样做会大大增加应用遭受代码注入或代码篡改的风险。

安全中心

Android 13 推出了 Android 安全中心，以提供重定向入口，方便用户访问特定的安全和隐私设置。Android 14 继续改进了安全中心。请查看安全中心文档，了解所有更改。

存储

媒体权限中的选择器选项

从 Android 14 开始，当应用请求访问用户的媒体库时，用户可以选择仅共享特定的媒体给该应用。有关更多详情，请参阅权限。

电视

使用 AIDL 的 TV 输入 HAL

从 Android 14 开始，TV 输入 HAL 接口使用 AIDL 定义。

虚拟化

Guest OS 安全保障

从 Android 14 开始，对加密存储卷的写入是保密的。有关更多信息，请参阅 Guest OS。

pKVM hypercall

Android 14 中的 pKVM 虚拟机监控程序提供了一个新的内存释放 hypercall。有关更多信息，请参阅 pKVM hypercall。

pKVM 供应商模块

Android 14 中引入了 pKVM 供应商模块。有关更多信息，请参阅 pKVM 供应商模块。

Android 14、Android 14-QPR1 和 Android 14-QPR2 版本说明 通过集合保持井井有条 根据您的偏好保存内容并对其进行分类。

架构