跳至主要内容
文档
新变化
版本说明
最新安全公告
最新兼容性定义文档 (CDD)
网站更新
开始使用
简介
启动
下载
构建
测试
创建
参与
社区
工具、build 和相关参考文档
安全
概览
公告
功能
测试
最佳实践
核心主题
架构
音频
摄像头
连接
数据
显示
字体
图形
互动
媒体
性能
权限
电源
运行时
设置
Storage
测试
版本更新记录
虚拟化
兼容性
兼容性定义文档 (CDD)
兼容性测试套件 (CTS)
Android 设备
Cuttlefish
企业版
电视
汽车
开始使用
开发指南
开发工具
测试工具和基础架构
版本详情
参考文档
HIDL
HAL
Trade Federation
安全测试套件
Android 代码搜索
/
English
Deutsch
Español – América Latina
Français
Indonesia
Italiano
Polski
Português – Brasil
Tiếng Việt
Türkçe
Русский
עברית
العربيّة
فارسی
हिंदी
বাংলা
ภาษาไทย
中文 – 简体
中文 – 繁體
日本語
한국어
登录
文档
新变化
开始使用
安全
核心主题
兼容性
Android 设备
汽车
参考文档
文档
更多
新变化
开始使用
安全
核心主题
兼容性
Android 设备
汽车
参考文档
Android 代码搜索
概览
架构
概览
硬件抽象层 (HAL)
概览
HIDL(已废弃)
概览
接口和软件包
接口哈希
服务和数据传输
快速消息队列
使用 Binder IPC
使用 MemoryBlock
网络栈配置工具
模型线程
转换 HAL 模块
数据类型
Safe Union
接口版本控制
代码样式指南
HIDL C++
概览
软件包
接口
数据类型
函数
HIDL Java
概览
数据类型
接口方法和错误
导出常量
其他
HIDL 框架向后兼容性验证
动态可用的 HAL
旧版 HAL (AOSP <=v7)
内核
概览
内核版本说明
稳定的内核版本和更新
Android 通用内核
GKI 项目
GKI 开发
GKI 版本控制方案
GKI 发布 build
概览
android12-5.10 发布 build
android13-5.10 发布 build
android13-5.15 发布 build
android14-5.15 发布 build
android14-6.1 发布 build
android15-6.6 发布 build
android16-6.12 发布 build
GKI 已废弃的 build
android12-5.10 的已废弃 build
android13-5.10 的已废弃 build
android13-5.15 的已废弃 build
android14-5.15 的已废弃 build
android14-6.1 的已废弃 build
android15-6.6 的已废弃 build
android16-6.12 的已废弃 build
GKI 发布流程
GKI 16-6.12 android-mainline errata
维持稳定的 KMI
内核 ABI 监控
概览
运行 ABI 监控
使用符号列表
模块
概览
将内核功能配置为 GKI 模块
供应商模块准则
可加载的内核模块
内核模块支持
测试 GKI 模块
启动时间优化
调试功能
为 GKI 开发内核代码
Android 内核文件系统支持
使用 eBPF 扩展内核
在 Android 12 中使用 DebugFS
可通过 FIPS 140-3 认证的 GKI 加密模块
EROFS
Android 内核常见问题解答
内核网络单元测试
将 ION 堆转换为 DMA-BUF 堆 (5.4 内核)
增量文件系统
配置
概览
将系统属性作为 API 实现
添加系统属性
实现 Config File Schema API
归档
概览
ConfigStore
创建 HAL 接口
实现服务
客户端使用
添加 ConfigStore 类和项
设备树叠加层
概览
实现 DTO
DTO 语法
编译和验证
使用多个 DT
DTB 和 DTBO 分区
优化 DTO
供应商 NDK (<=AOSP 14)
概览
启用 VNDK
VNDK 构建系统支持
VNDK 扩展
VNDK 快照设计
生成 VNDK 快照
生成供应商快照
链接器命名空间
目录、规则和 sepolicy
RenderScript
ABI 稳定性
预构建 ABI 使用情况检查工具
供应商接口对象
概览
清单
兼容性矩阵
FCM 生命周期
设备清单开发
匹配规则
其他资源
AIDL
概览
AIDL 语言
AIDL 后端
稳定的 AIDL
适用于 HAL 的 AIDL
动态运行 AIDL 服务
以 AIDL 编写的注释
将 FMQ 与 AIDL 搭配使用
AIDL 模糊测试
AIDL 样式指南
使用 Binder 进行进程间通信
概览
处理线程
继承优先级
引导加载程序
概览
规范化启动原因
启动映像头文件
实现 bootconfig
恢复映像
DTB 映像
实现 OTA 更新
锁定和解锁引导加载程序
AVB 属性中的版本信息
将 fastboot 移至用户空间
通用引导加载程序
概览
部署 GBL
分区
概览
分区布局
供应商启动分区
供应商分区和 ODM DLKM 分区
Android 共享系统映像
Ramdisk 分区
通用 boot 分区
ODM 分区
产品划分
实现 GKI 模块分区
强制执行产品分区接口
Trusty OS 分区
16 KB 页面大小
概览
在 ARM64 上使用页面大小为 16 KB 的 Cuttlefish
在 x86-64 上模拟页面大小为 16 KB 的 Cuttlefish
构建并刷写支持 16 KB 的 Pixel 8 设备
刷写支持 16 KB 页面大小的 Pixel
获取页面大小
针对 16 KB 模式优化性能
16 KB 系统属性
启用 16 KB 切换开关
启用 16 KB 向后兼容选项
供应商 API 级别
音频
概览
术语
实现
音频 HAL
AIDL 音频 HAL
AIDL HAL 中的可配置音频政策支持
AIDL 和 HIDL 音频 HAL 比较
HIDL
HIDL 音频 HAL
配置音频政策
配置共享库
配置预处理效果
数据格式
属性
效果
高解析度音频
设备类型限制
AAudio 和 MMAP
音频预热时间
延迟时间
概览
贡献者
用于减少延迟的设计
测量音频延迟时间
音频环回适配器
测量
面向应用开发者的说明
避免优先级倒置
采样率转换
调试
MIDI
概览
MIDI 架构
MIDI 测试程序
USB
USB 数字音频
USB 设备上的首选混音器属性
TV 音频
并发捕获
声音触发器
组合音频设备路由
空间音频
空间音频和头部追踪
实现
通过 LE 音频实现头部追踪
声音剂量
动态条形音箱模式
摄像头
概览
架构
相机 HAL
HAL 子系统
核心概念
3A 模式和状态转换
相机调试
错误和信息流处理
元数据和控件
输出流、剪裁和缩放
创建和提交请求
数据流配置
性能
Camera HAL3 缓冲区管理 API
会话参数
单一生产方,多个使用方
相机功能
10 位相机输出
相机焦外成像
并发相机流式传输
相机扩展
相机扩展验证工具
相机预览防抖
外接 USB 摄像头
高动态范围模式
HEIF 图片处理
单色相机
运动追踪
多摄像头支持
系统相机
手电筒强度控制
Ultra HDR
将设备用作摄像头
广色域拍摄
版本控制
相机版本支持
连接
概览
蓝牙
概览
蓝牙服务
低功耗蓝牙
使用 BLE 的助听器音频支持
BLE 广播
验证和调试
HCI 要求
在线状态校准
Android OS 识别
NFC
FeliCa 的主机卡模拟
NFC 脱离主机的付款同步
安全 NFC
快速访问电子钱包
Android 专有 NCI 命令
通话和短信
5G 非独立组网 (NSA)
实现电话号码屏蔽功能
来电通知
网域选择服务
实现紧急呼叫功能
Android 紧急电话号码数据库
紧急电话号码和紧急呼叫
实现 IMS
IMS 服务授权
IMS 单注册
电话账号建议
实现 RTT
支持第三方通话应用
可视语音信箱
运营商
概览
5G 网络切片
APN 和 CarrierConfig
运营商识别号
实现流量套餐
设备标识符
eSIM 卡
实现 eSIM 卡
为支持 eSIM 卡需满足的调制解调器要求
eUICC API
多个已启用的配置文件
处理 eUICC API 错误
可下载的测试配置文件
eSIM 卡转移运营商集成
改进 VPN 用户体验
多运营商网络支持
为流量已用完的用户自定义设备行为
RIL 重构
小基站支持
UICC 运营商特权
时间
概览
位置信息时区检测
电话时区检测
网络时间检测
GNSS 时间检测
外部时间检测
时间源优先级
时区政策和建议
时区规则
超宽带
概览
UWB HAL 接口
Wi-Fi
概览
Wi-Fi HAL
Wi-Fi 基础架构功能
测试、调试和调整 Wi-Fi
Android 数据包过滤器
运营商 WLAN
随机分配 MAC 地址的行为
实现随机分配 MAC 地址
Passpoint(热点 2.0)
WLAN STA/AP 并发
Wi-Fi STA/STA 并发
首次使用时信任 (TOFU)
Wi-Fi 感知
Wi-Fi/移动网络共存信道规避
Wi-Fi Direct
WLAN Easy Connect
WLAN 热点 (SoftAP)
Wi-Fi AP/AP 并发
WLAN 低延迟模式
Wi-Fi 网络选择
WLAN 首选分流网络扫描
Wi-Fi 往返时间 (RTT)
WPA3 和 Wi-Fi Enhanced Open
Wi-Fi 7
配套设备配置文件
Connectivity Diagnostics API
连接界面
网络选择
测距:带外消息序列和载荷规范
信号强度报告
数据
概览
流量使用情况标签说明
流量节省程序模式
eBPF 流量监控
从流量消耗数据中排除特定的网络类型
网络接口统计信息概览
网络共享流量
网络共享硬件分流
流量统计周期的重置日期
内核概览
内核变更
显示
概览
应用
实现自适应图标
应用快捷方式
实现圆形图标
对话通知和 widget
窗口模糊处理
widget 和快捷方式
实现同步应用转换
颜色
颜色管理
刘海屏
勿扰
HDR 视频播放
实现护眼模式
将 HDR 亮度色调映射到 SDR 兼容的范围
Material You 设计
动态配色
多窗口模式
概览
桌面窗口化功能
分屏交互
画中画
窗口放大功能
多屏幕
概览
推荐做法
测试和开发环境
常见问题解答
多项恢复
activity 启动政策
显示屏支持
系统装饰支持
锁定屏幕
输入法支持
输入路由
多区音频
通知
通知历史记录
“选择启用通知”的权限
任务管理器
零售演示模式
旋转建议
实现文本分类器
SDR 和 HDR 组合
系统界面中的媒体控件
WindowManager 扩展
字体
实现自定义字体回退
图形
概览
架构
BufferQueue 和 Gralloc
实现 DMABUF 和 GPU 内存计算
使用 Winscope 跟踪窗口转换
概览
运行 Winscope
捕获跟踪记录
概览
系统应用中的 ViewCapture
设备上
使用 Winscope
使用 adb 命令
加载跟踪记录
分析跟踪记录
概览
时间轴导航
跟踪记录搜索
SurfaceFlinger
WindowManager
Protolog
Shell 过渡
ViewCapture
Surface 和 SurfaceHolder
概览
SurfaceView 和 GLSurfaceView
SurfaceTexture
TextureView
SurfaceFlinger 和 WindowManager
概览
SurfaceFlinger 中的系统属性
硬件混合渲染器 HAL
概览
实现 HWC HAL
热插拔处理
适用于 HWC HAL 的 AIDL
客户端帧缓冲区管理
减少图形的内存消耗
层和显示屏
VSync
Frame pacing
多种刷新率
自适应刷新率
EGLSurface 和 OpenGL ES
概览
实现 OpenGL ES 和 EGL
OpenGLRenderer 配置
Vulkan
概览
实现 Vulkan
同步框架
测试
实现测试
与 Android CTS 集成
drawElements 质量计划测试
使用 AutoSingleLayer 进行无信号缓冲区锁存
向 Android 添加新像素格式
Android 中的 HDR 屏幕截图
互动
概览
输入源
概览
按键布局文件
按键字符映射文件
输入设备配置文件
迁移指南
键盘设备
触摸设备
getevent 工具
validatekeymaps 工具
触感反馈
概览
实现触感反馈
概览
实现常量和基元
在 HAL 和 API 之间映射常量
实现分段线性封套效果
评估硬件
触感反馈框架的用户体验基础
触感反馈用户体验设计
硬件评估
概览
设置测试设备
设置测试软件
测量和记录目标效果
分析波形
使用性能图比较结果
神经网络
概览
爆发执行和快速消息队列
编译缓存
控制流
设备发现和分配
内存池
实现 NNAPI 驱动程序的最佳实践
服务质量
供应商扩展
外设
概览
音频配件
概览
3.5 毫米耳机
耳机规格
耳机插孔设备规格
USB 耳机
耳机规格
适配器规格
设备规格
耳机预期行为
耳机测试
自定义配件
概览
Android 开放配件
概览
AOA 2.0
AOA 1.0
停用 USB 数据信号传输
触控笔
传感器
概览
传感器堆栈
传感器类型
互动
头部跟踪器 HID 协议
电源
批处理
功耗
模式
报告模式
挂起模式
传感器已关闭
传感器 HAL
Sensors AIDL HAL
传感器 Multi-HAL
传感器 HAL 2.0
传感器 HAL 1.0
HAL 版本废弃
Context Hub 运行时环境
概览
媒体
概览
媒体模块
MediaProvider 模块
自定义媒体组件
MediaCodec 低延时解码
媒体框架强化
SoC 供应商依赖项
OEM 依赖项
DRM
兼容的媒体转码
导出视频编码统计信息
面向 OEM 的 RoI 实现指南
性能
概览
APK 缓存
缓存的应用冻结器
优化启动时间
运行状况
概览
实现 Health 2.1
Cgroup 抽象层
低内存终止守护程序
自动反馈导向优化(12 或更高版本)
使用配置文件引导型优化
任务快照
兼容性预写式日志记录
应用休眠
游戏性能提升
MM 事件历史内存统计信息
获取系统健康状况信息
权限
概览
Ambient 权能
后台位置信息访问权限提醒
联系人提供程序和亲密程度
自主访问控制
不可变的设备 ID
原生库的命名空间
特许权限许可名单
预安装系统软件包
隐私指示标志
平台签名的共享 UID 许可名单
隐私指示标志
限制机会性位置信息
受限的屏幕读取
Android 角色
运行时权限
签名权限许可名单
三态位置权限
实现 USB HAL
配套应用串流
全屏 intent 限制
Capture Content for Notes
电源
概览
电源管理
热缓解
电量统计信息 HAL
应用电源管理
采用低电耗模式的平台电源管理
性能管理
应用后台行为跟踪器
支持无电池设备
测量组件功耗
测量设备耗电量
测量耗电量值
常规省电模式
电视待机模式