Kể từ ngày 27 tháng 3 năm 2025, bạn nên sử dụng android-latest-release
thay vì aosp-main
để xây dựng và đóng góp cho AOSP. Để biết thêm thông tin, hãy xem phần Thay đổi đối với AOSP.
Tài liệu định nghĩa về khả năng tương thích với Android
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Chào mừng bạn đến với Tài liệu định nghĩa về khả năng tương thích (CDD) cho Android. Tài liệu này liệt kê các yêu cầu phải đáp ứng để thiết bị tương thích với phiên bản Android mới nhất. Để được coi là tương thích với Android, việc triển khai thiết bị PHẢI đáp ứng các yêu cầu được nêu trong Định nghĩa về khả năng tương thích này, bao gồm mọi tài liệu được đưa vào thông qua tham chiếu. Đối với mỗi bản phát hành của nền tảng Android, chúng tôi sẽ cung cấp một CDD chi tiết. CDD thể hiện khía cạnh "chính sách" của khả năng tương thích với Android.
Điều quan trọng là chính sách của chương trình tương thích với Android phải được mã hoá rõ ràng vì không có bộ kiểm thử nào, bao gồm cả Bộ kiểm thử tính tương thích với Android (CTS), có thể thực sự toàn diện. Ví dụ: CTS bao gồm một kiểm thử để kiểm tra sự hiện diện và hành vi chính xác của các API đồ hoạ OpenGL, nhưng không có kiểm thử phần mềm nào có thể xác minh rằng đồ hoạ thực sự xuất hiện chính xác trên màn hình. Nói chung, bạn không thể kiểm thử sự hiện diện của các tính năng phần cứng như bàn phím, mật độ màn hình, Wi-Fi và Bluetooth.
Vai trò của CDD là hệ thống hoá và làm rõ các yêu cầu cụ thể, đồng thời loại bỏ sự mơ hồ. CDD không cố gắng cung cấp thông tin toàn diện. Vì Android là một tập hợp mã nguồn mở duy nhất, nên chính mã này là "thông số kỹ thuật" toàn diện của nền tảng và các API của nền tảng đó. CDD đóng vai trò là "hub" tham chiếu đến nội dung khác (chẳng hạn như tài liệu API SDK) cung cấp một khung trong đó có thể sử dụng mã nguồn Android để kết quả cuối cùng là một hệ thống tương thích.
Nếu bạn muốn tạo một thiết bị tương thích với một phiên bản Android nhất định, hãy bắt đầu bằng cách xem mã nguồn cho phiên bản đó, sau đó đọc CDD tương ứng và tuân thủ các nguyên tắc của CDD đó.
Bạn có thể xem CDD mới nhất dưới dạng trang web HTML.
Tìm các phiên bản đã phát hành của CDD và chuỗi phiên bản phát hành đã phê duyệt tại đây:
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[],[],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) | |"]]