自 2025 年 3 月 27 日起,我们建议您使用 android-latest-release
而非 aosp-main
构建 AOSP 并为其做出贡献。如需了解详情,请参阅 AOSP 的变更。
Android 兼容性定义文档
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
欢迎阅读 Android 兼容性定义文档 (CDD)。本文档列举了设备需要满足哪些要求才能与最新的 Android 版本兼容。设备实现必须满足此兼容性定义文档(包括以参考资料的形式纳入的任何文档)中列出的要求,才会被视为与 Android 兼容。对于 Android 平台的每个版本,我们都将提供详细的 CDD。CDD 代表 Android 兼容性的“政策”要求。
请务必注意,Android 兼容性计划的政策中明确规定,任何测试套件(包括 Android 兼容性测试套件 [CTS])都无法真正面面俱到。例如,CTS 包含可检查 OpenGL 图形 API 是否存在以及其行为是否正确的测试,但任何软件测试都无法验证这类图形在屏幕上实际显示时的正确性。从更笼统的角度来说,无法测试硬件功能(如键盘、屏幕密度、Wi-Fi 和蓝牙)是否存在。
CDD 的作用是整理和阐明具体要求,并消除歧义。CDD 并非综合全面的指南。由于 Android 是一系列开放源代码,因此代码本身就是该平台及其 API 的综合“规范”。CDD 用作引用其他内容(如 SDK API 文档)的“纲要”,提供一个 Android 源代码的使用框架,从而促进最终实现一个兼容的系统。
如果您要打造与指定 Android 版本兼容的设备,请先查看该版本的源代码,然后阅读相应的 CDD 并遵循其准则。
如需查看 CDD 即将发生的更改,请转到
Android 兼容性定义(预览版)。
您可以采用 HTML 网页形式查看最新的 CDD。
在下面查找已发布的 CDD 版本和已获批准的发行版本字符串:
本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-05-01。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-05-01。"],[],[],null,["# Android Compatibility Definition Document\n\nWelcome to the Android Compatibility Definition Document (CDD). This document\nenumerates the requirements that must be met in order for devices to be\ncompatible with the latest version of Android. To be considered compatible with\nAndroid, device implementations MUST meet the requirements\npresented in this Compatibility Definition, including any documents\nincorporated via reference. For each release of the Android platform, a\ndetailed CDD will be provided. The CDD represents the \"policy\" aspect of\nAndroid compatibility.\n\nIt is important the policy of the Android compatibility program is codified\nexplicitly as no test suite, including the\n[Android Compatibility Test Suite (CTS)](/docs/compatibility/cts),\ncan truly be comprehensive. For instance, the CTS includes a test that checks for the presence and\ncorrect behavior of OpenGL graphics APIs, but no software test can verify that the\ngraphics actually appear correctly on the screen. More generally, it's\nimpossible to test the presence of hardware features such as keyboards, display\ndensity, Wi-Fi, and Bluetooth.\n\nThe CDD's role is to codify and clarify specific requirements, and\neliminate ambiguity. The CDD does not attempt to be comprehensive. Since\nAndroid is a single corpus of open-source code, the code itself is the\ncomprehensive \"specification\" of the platform and its APIs. The CDD acts as a\n\"hub\" referencing other content (such as SDK API documentation) that provides\na framework in which the Android source code may be used so that the end\nresult is a compatible system.\n\nIf you want to build a device compatible with a given Android version,\nstart by checking out the source code for that version, and then read the\ncorresponding CDD and stay within its guidelines.\n\n\nYou may view the latest CDD as an [HTML](/docs/compatibility/android-cdd) web page.\n\nFind released versions of the CDD and approved release version strings here:\n\n| Version | PDF | HTML/XHTML | Strings |\n|---------|---------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------|-------------------------------------------------|\n| 16 | --- | [android-16-cdd.html](/docs/compatibility/16/android-16-cdd) | [Version 16](/docs/compatibility/16/versions) |\n| 15 | --- | [android-15-cdd.html](/docs/compatibility/15/android-15-cdd) | [Version 15](/docs/compatibility/15/versions) |\n| 14 | --- | [android-14-cdd.html](/docs/compatibility/14/android-14-cdd) | [Version 14](/docs/compatibility/14/versions) |\n| 13 | --- | [android-13-cdd.html](/docs/compatibility/13/android-13-cdd) | [Version 13](/docs/compatibility/13/versions) |\n| 12 | [android-12-cdd.pdf](/static/docs/compatibility/12/android-12-cdd.pdf) | [android-12-cdd.html](/docs/compatibility/12/android-12-cdd) | [Version 12](/docs/compatibility/12/versions) |\n| 11 | [android-11-cdd.pdf](/static/docs/compatibility/11/android-11-cdd.pdf) | [android-11-cdd.html](/docs/compatibility/11/android-11-cdd) | [Version 11](/docs/compatibility/11/versions) |\n| 10 | [android-10-cdd.pdf](/static/docs/compatibility/10/android-10-cdd.pdf) | [android-10-cdd.html](/docs/compatibility/10/android-10-cdd) | [Version 10](/docs/compatibility/10/versions) |\n| 9 | [android-9-cdd.pdf](/static/docs/compatibility/9/android-9-cdd.pdf) | [android-9-cdd.html](/docs/compatibility/9/android-9-cdd) | [Version 9](/docs/compatibility/9/versions) |\n| 8.1 | [android-8.1-cdd.pdf](/static/docs/compatibility/8.1/android-8.1-cdd.pdf) | [android-8.1-cdd.html](/docs/compatibility/8.1/android-8.1-cdd) | [Version 8.1](/docs/compatibility/8.1/versions) |\n| 8.0 | [android-8.0-cdd.pdf](/static/docs/compatibility/8.0/android-8.0-cdd.pdf) | [android-8.0-cdd.html](/docs/compatibility/8.0/android-8.0-cdd) | [Version 8.0](/docs/compatibility/8.0/versions) |\n| 7.1 | [android-7.1-cdd.pdf](/static/docs/compatibility/7.1/android-7.1-cdd.pdf) | [android-7.1-cdd.html](/docs/compatibility/7.1/android-7.1-cdd) | [Version 7.1](/docs/compatibility/7.1/versions) |\n| 7.0 | [android-7.0-cdd.pdf](/static/docs/compatibility/7.0/android-7.0-cdd.pdf) | [android-7.0-cdd.html](/docs/compatibility/7.0/android-7.0-cdd) | [Version 7.0](/docs/compatibility/7.0/versions) |\n| 6.0 | [android-6.0-cdd.pdf](/static/docs/compatibility/6.0/android-6.0-cdd.pdf) | [android-6.0-cdd.html](/docs/compatibility/6.0/android-6.0-cdd) | [Version 6.0](/docs/compatibility/6.0/versions) |\n| 5.1 | [android-5.1.cdd.pdf](/static/docs/compatibility/5.1/android-5.1-cdd.pdf) | [android-5.1-cdd.html](/docs/compatibility/5.1/android-5.1-cdd) | [Version 5.1](/docs/compatibility/5.1/versions) |\n| 5.0 | [android-5.0.cdd.pdf](/static/docs/compatibility/5.0/android-5.0-cdd.pdf) | [android-5.0-cdd.html](/docs/compatibility/5.0/android-5.0-cdd) | [Version 5.0](/docs/compatibility/5.0/versions) |\n| 4.4 | [android-4.4.cdd.pdf](/static/docs/compatibility/4.4/android-4.4-cdd.pdf) | [android-4.4-cdd.html](/docs/compatibility/4.4/android-4.4-cdd) | [Version 4.4](/docs/compatibility/4.4/versions) |\n| 4.3 | [android-4.3.cdd.pdf](/static/docs/compatibility/4.3/android-4.3-cdd.pdf) | [android-4.3-cdd.html](/docs/compatibility/4.3/android-4.3-cdd) | [Version 4.3](/docs/compatibility/4.3/versions) |\n| 4.2 | [android-4.2.cdd.pdf](/static/docs/compatibility/4.2/android-4.2-cdd.pdf) | [android-4.2-cdd.html](/docs/compatibility/4.2/android-4.2-cdd) | [Version 4.2](/docs/compatibility/4.2/versions) |\n| 4.1 | [android-4.1.cdd.pdf](/static/docs/compatibility/4.1/android-4.1-cdd.pdf) | [android-4.1-cdd.html](/docs/compatibility/4.1/android-4.1-cdd) | [Version 4.1](/docs/compatibility/4.1/versions) |\n| 4.0 | [android-4.0.cdd.pdf](/static/docs/compatibility/4.0/android-4.0-cdd.pdf) | [android-4.0-cdd.html](/docs/compatibility/4.0/android-4.0-cdd) | [Version 4.0](/docs/compatibility/4.0/versions) |\n| 2.3 | [android-2.3.cdd.pdf](/static/docs/compatibility/2.3/android-2.3-cdd.pdf) [android-2.3.3-cdd.pdf](/static/docs/compatibility/2.3/android-2.3.3-cdd.pdf) | [android-2.3-cdd.html](/docs/compatibility/2.3/android-2.3-cdd) | [Version 2.3](/docs/compatibility/2.3/versions) |\n| 2.2 | [android-2.2.cdd.pdf](/static/docs/compatibility/2.2/android-2.2-cdd.pdf) | [android-2.2-cdd.html](/docs/compatibility/2.2/android-2.2-cdd) | [Version 2.2](/docs/compatibility/2.2/versions) |\n| 2.1 | [android-2.1.cdd.pdf](/static/docs/compatibility/2.1/android-2.1-cdd.pdf) | [android-2.1-cdd.html](/docs/compatibility/2.1/android-2.1-cdd) | [Version 2.1](/docs/compatibility/2.1/versions) |\n| 1.6 | [android-1.6.cdd.pdf](/static/docs/compatibility/1.6/android-1.6-cdd.pdf) | [android-1.6-cdd.html](/docs/compatibility/1.6/android-1.6-cdd) | |"]]