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

Các bản phát hành phát triển Android được sắp xếp thành các gia đình, với các tên mã theo thứ tự bảng chữ cái 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ề các đị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à các tổ hợp phím để khởi động vào chế độ flashboot hoặc các nguồn nhân và mã nhị phân để xây dựng nhân theo cách thủ công. Chúng được tóm tắt trong phần tham chiếu Tên mã và tài nguyên 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 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 nhân phải được xây dựng theo cách thủ công yêu cầu tên mã và các vị trí tương ứng để lấy các nguồn và mã nhị phân của nhân.
• Các bản dựng tạo nguồn cho 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à xây dựng công cụ.

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 được liên kết.

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 chiều 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 ra.
• YYMMDD xác định ngày mà 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. Không phải lúc nào cũng là ngày chính xác tạo một bản dựng vì thông thường các biến thể nhỏ được thêm vào một bản dựng hiện có để sử dụng lại cùng một mã ngày 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 tùy chọn, chữ và số 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 ra. Theo quy ước, R là nhánh phát hành chính.
• Chữ cái thứ ba và hai số theo sau là mã ngày. Chữ cái này tính các quý ( 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 tạo ra một bản dựng vì nó thường xảy ra đối với các biến thể nhỏ được thêm vào một bản dựng hiện có để sử dụng lại cùng một mã ngày 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 tháng, bắt đầu tuần tự bằng A (ẩn và thường được bỏ qua cho ngắn gọn).

Các thẻ và bản dựng mã nguồn

Bắt đầu với Donut, danh sách chính xác các thẻ và bản dựng có 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 hoặ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 master -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.