Tên mã, thẻ và số bản dựng

Các bản phát hành phát triển Android được tổ chức thành các nhóm, với các tên mã theo thứ tự bảng chữ cái được lấy cảm hứng từ các món ăn ngon. Trang này cung cấp thông tin về tên mã Nền tảng, phiên bản, cấp độ API và bản phát hành NDK cùng với giải thích về định nghĩa ID bản dựng được liên kết với chúng.

Lưu ý rằng bạn có thể yêu cầu chi tiết phiên bản tên mã bổ sung, tùy thuộc vào trường hợp sử dụng của bạn. Ví dụ: bạn có thể cần tên mã thiết bị Android và tổ hợp phím để khởi động vào chế độ flashboot hoặc nguồn nhân và mã nhị phân để tạo nhân theo cách thủ công. Chúng được tóm tắt trong phần Tài liệu tham khảo và tài nguyên tên mã cho các trường hợp sử dụng , với các liên kết để bạn tìm thông tin mà bạn cần cho các chủ đề này:

• Khởi động vào chế độ flashboot yêu cầu tổ hợp phím cho các thiết bị có tên mã Thiết bị Android tương ứng.
• Các hạt nhân phải được xây dựng thủ công yêu cầu tên mã và vị trí tương ứng để lấy các nguồn và tệp nhị phân của hạt nhân.
• Các bản dựng tạo nguồn từ nhiều kho lưu trữ Git yêu cầu ghép nối tên mã thiết bị để có được thiết lập thư mục nguồn chính xác để tải xuống các nguồn và công cụ xây dựng.

Tên mã nền tảng, phiên bản, cấp độ API và bản phát hành NDK

Bảng này liệt kê các tên mã, số phiên bản tương ứng của chúng và các cấp API liên quan.

Xây dựng định nghĩa ID

Trong Android 8.0.0 (Oreo) trở lên, các bản dựng riêng lẻ được xác định bằng định dạng ID bản dựng PVBB.YYMMDD.bbb[.Cn] , trong đó:

• P đại diện cho chữ cái đầu tiên của tên mã của bản phát hành nền tảng, ví dụ: O là Oreo.
• V đại diện cho một ngành dọc được hỗ trợ. Theo quy ước, P đại diện cho nhánh nền tảng chính.
• BB là một mã chữ và số cho phép Google xác định nhánh mã chính xác mà bản dựng được tạo từ đó.
• YYMMDD xác định ngày phát hành được phân nhánh từ hoặc đồng bộ hóa với nhánh phát triển. Không phải lúc nào cũng có ngày chính xác mà bản dựng được tạo vì thông thường các biến thể nhỏ được thêm vào bản dựng hiện có để sử dụng lại mã ngày giống như bản dựng hiện có.
• bbb xác định các phiên bản riêng lẻ liên quan đến cùng một mã ngày, bắt đầu tuần tự bằng 001 .
• Cn là một chữ và số tùy chọn xác định một hotfix trên bản dựng PVBB.YYMMDD.bbb hiện có, bắt đầu từ A1 .

Các bản phát hành Android cũ hơn sử dụng mã ID bản dựng khác, ngắn hơn (ví dụ: FRF85B ) trong đó:

• Chữ cái đầu tiên là tên mã của họ phát hành, ví dụ F là Froyo.
• Chữ cái thứ hai là mã nhánh cho phép Google xác định nhánh mã chính xác mà bản dựng được tạo từ đó. Theo quy ước, R là nhánh phát hành chính.
• Chữ cái thứ ba và hai số tiếp theo là mã ngày. Chữ cái đếm phần tư ( A là Q1 2009, F là Q2 2010, v.v.). Hai số đếm ngày trong quý ( F85 là ngày 24 tháng 6 năm 2010). Mã ngày không phải lúc nào cũng là ngày chính xác mà bản dựng được tạo vì thông thường các biến thể nhỏ được thêm vào bản dựng hiện có để sử dụng lại mã ngày giống như bản dựng hiện có.
• Chữ cái cuối cùng xác định các phiên bản riêng lẻ liên quan đến cùng một mã ngày, tuần tự bắt đầu bằng A (ẩn và thường được bỏ qua cho ngắn gọn).

Thẻ mã nguồn và bản dựng

Bắt đầu với Donut, danh sách chính xác các thẻ và bản dựng nằm trong bảng sau. ID bản dựng cung cấp thông tin như bản phát hành nền tảng, nhánh mã và ngày bản phát hành được phân nhánh từ hoặc được đồng bộ hóa với nhánh phát triển.

The branches froyo, gingerbread, ics-mr0, ics-mr1, jb-dev, jb-mr1-dev, jb-mr1.1-dev, jb-mr2-dev, and kitkat-dev represent development branches that don't exactly match configurations tested by Google. As such, these branches might contain a variety of changes in addition to the official tagged releases and might not be as thoroughly tested.

To differentiate between releases, you can get a list of changes associated with each project by issuing the following command and passing it the two branch tags:

repo forall -pc 'git log --no-merges --oneline branch-1..branch-2'

For example:

repo forall -pc 'git log --no-merges --oneline android-4.4.2_r2..android-4.4.2_r1'

To send the output to a text file:

  repo forall -pc 'git log --no-merges --oneline android-4.4.2_r2..android-4.4.2_r1' > /tmp/android-4.4.2_r2-android-4.4.2_r1-diff.txt

Honeycomb GPL modules

For Honeycomb, the entire platform source code isn't available. However, the parts of Honeycomb licensed under the GPL and LGPL are available under the following tags.

No manifest contains exactly these modules, but some manifests allow building those components. The following commands work for 3.0_r1.1:

repo init -b main -m base-for-3.0-gpl.xml
repo sync
repo forall -c git checkout android-3.0_r1.1

To use another version, change the git checkout parameter and (if necessary) the -m parameter in repo init . The git checkout command outputs an error for any non-GPL projects where it can't find the tag.

Codename references and resources for use cases

Resources for the type of codenames information that's needed to support specific setup use cases are listed below:

• If you're booting into Fastboot mode (from a device that's undergoing a cold boot), you need the key combinations that correspond to the Android device you're using. For a listing of devices with their corresponding Android Device codenames (for example, Nexus 5x is codenamed Bullhead and uses a specific key combination), see Booting into fast boot mode to obtain the key combinations you need.
• If your build requires sources from multiple Git repositories, use the repo approach to download sources and build tools; this ensures a correct source directory setup. To get BRANCH names for the kernels you require, see Downloading sources and build tools for a list of device-code name pairings (such as Pixel 5 - redfin), cross-referenced to their binary paths in the AOSP tree and corresponding repo branches.