Tài liệu này mô tả cách phát hành GKI, kể cả hằng tuần, hằng tháng và cuối tuần bản phát hành khẩn cấp của ban nhạc. Mục tiêu của tài liệu này là cung cấp cho OEM (Nhà sản xuất thiết bị gốc) hướng dẫn về nơi nhận GKI cũng như quy trình tách khỏi nhóm khắc phục khẩn cấp. OEM cũng có thể sử dụng Hướng dẫn phát triển GKI để tìm hiểu thêm về cách họ có thể làm việc với nhóm Android Kernel nhằm tối ưu hoá hạt nhân GKI cho sản phẩm của họ.
Tần suất phát hành GKI
GKI sẽ được phát hành theo tần suất hằng tháng sau khi KMI tạm ngưng hoạt động.
Bản phát hành GKI Android 13, 14 và 15
Bảng sau đây chỉ áp dụng cho android13-5.10, android13-5.15 và android14-6.1.
| Bản dựng được GKI chứng nhận hằng tháng | Hạn chót nhận phòng | Ngày sẵn sàng tải trước GKI | Đã xác nhận? |
|---|---|---|---|
| Tháng 10 | Ngày 14 tháng 10 năm 2022 | Ngày 31 tháng 10 năm 2022 | Có |
| Tháng 11 | Ngày 14 tháng 11 năm 2022 | Ngày 30 tháng 11 năm 2022 | Có |
| Tháng 12 | Ngày 9 tháng 12 năm 2022 | Ngày 21 tháng 12 năm 2022 | Có |
| Tháng 1 | Ngày 17 tháng 1 năm 2023 | Ngày 31 tháng 1 năm 2023 | Có |
| Tháng 2 | Ngày 15 tháng 2 năm 2023 | Ngày 28 tháng 2 năm 2023 | Có |
| Tháng 3 | Ngày 15 tháng 3 năm 2023 | Ngày 31 tháng 3 năm 2023 | Có |
| Tháng 4 | Ngày 13 tháng 4 năm 2023 | Ngày 28 tháng 4 năm 2023 | Có |
| Tháng 5 | Ngày 17 tháng 5 năm 2023 | Ngày 31 tháng 5 năm 2023 | Có |
| Tháng 6 | Ngày 15 tháng 6 năm 2023 | Ngày 30 tháng 6 năm 2023 | Có |
| Tháng 7 | Ngày 18 tháng 7 năm 2023 | ngày 31 tháng 7 năm 2023 | Có |
| Tháng 8 | Ngày 16 tháng 8 năm 2023 | Ngày 31 tháng 8 năm 2023 | Có |
| Tháng 9 | Ngày 14 tháng 9 năm 2023 | Ngày 29 tháng 9 năm 2023 | Có |
| Tháng 10 | Ngày 18 tháng 10 năm 2023 | Ngày 31 tháng 10 năm 2023 | Có |
| Tháng 11 | Ngày 10 tháng 11 năm 2023 | Ngày 30 tháng 11 năm 2023 | Có |
| Tháng 12 | Ngày 7 tháng 12 năm 2023 | Ngày 22 tháng 12 năm 2023 | Có |
| Tháng 1 | Ngày 16 tháng 1 năm 2024 | Ngày 31 tháng 1 năm 2024 | Có |
| Tháng 2 | Ngày 13 tháng 2 năm 2024 | Ngày 29 tháng 2 năm 2024 | Có |
| Tháng 3 | Ngày 13 tháng 3 năm 2024 | Ngày 29 tháng 3 năm 2024 | Có |
| Tháng 4 | Ngày 16 tháng 4 năm 2024 | Ngày 30 tháng 4 năm 2024 | Có |
| Tháng 5 | Ngày 14 tháng 5 năm 2024 | Ngày 31 tháng 5 năm 2024 | Có |
| Tháng 6 | Ngày 12 tháng 6 năm 2024 | Ngày 28 tháng 6 năm 2024 | Có |
| Tháng 7 | Ngày 16 tháng 7 năm 2024 | Ngày 31 tháng 7 năm 2024 | Có |
| Tháng 8 | Ngày 15 tháng 8 năm 2024 | Ngày 30 tháng 8 năm 2024 | Có |
| Tháng 9 | Ngày 17 tháng 9 năm 2024 | Ngày 30 tháng 9 năm 2024 | Có |
| Tháng 10 | Ngày 15 tháng 10 năm 2024 | Ngày 31 tháng 10 năm 2024 | Có |
| Tháng 11 | Ngày 11 tháng 11 năm 2024 | Ngày 27 tháng 11 năm 2024 | Có |
| Tháng 12 | Ngày 6 tháng 12 năm 2024 | Ngày 23 tháng 12 năm 2024 | Có |
Kể từ tháng 1 năm 2024, chúng tôi sẽ tiếp tục phát hành android14-5.15 hằng tháng
theo tần suất hằng tháng cụ thể được nêu trong bảng bên dưới.
android15-6.6 vẫn sẽ tiếp tục phát hành theo lịch trình như cũ, bắt đầu từ tháng 7 năm 2024.
| Bản dựng được GKI chứng nhận hằng tháng | Hạn chót nhận phòng | Ngày sẵn sàng tải trước GKI | Đã xác nhận? |
|---|---|---|---|
| Tháng 1 | Ngày 16 tháng 1 năm 2024 | Ngày 31 tháng 1 năm 2024 | Có |
| Tháng 2 | Ngày 13 tháng 2 năm 2024 | Ngày 29 tháng 2 năm 2024 | Có |
| Tháng 3 | Ngày 4 tháng 3 năm 2024 | Ngày 15 tháng 3 năm 2024 | Có |
| Tháng 4 | Ngày 1 tháng 4 năm 2024 | Ngày 17 tháng 4 năm 2024 | Có |
| Tháng 5 | Ngày 1 tháng 5 năm 2024 | Ngày 17 tháng 5 năm 2024 | Có |
| Tháng 6 | Ngày 3 tháng 6 năm 2024 | Ngày 17 tháng 6 năm 2024 | Có |
| Tháng 7 | Ngày 1 tháng 7 năm 2024 | Ngày 15 tháng 7 năm 2024 | Có |
| Tháng 8 | Ngày 1 tháng 8 năm 2024 | Ngày 16 tháng 8 năm 2024 | Có |
| Tháng 9 | Ngày 2 tháng 9 năm 2024 | Ngày 16 tháng 9 năm 2024 | Có |
| Tháng 10 | Ngày 1 tháng 10 năm 2024 | Ngày 14 tháng 10 năm 2024 | Có |
| Tháng 11 | Ngày 1 tháng 11 năm 2024 | Ngày 15 tháng 11 năm 2024 | Có |
| Tháng 12 | Ngày 2 tháng 12 năm 2024 | Ngày 16 tháng 12 năm 2024 | Có |
Bản phát hành GKI Android 12
Sau tháng 5 năm 2024, các bản phát hành GKI android12-5.10 sẽ diễn ra theo tần suất hằng quý và
được xuất bản vào giữa tháng.
Bảng sau đây chỉ áp dụng cho android12-5.10.
| Bản dựng được GKI chứng nhận hằng tháng | Hạn chót nhận phòng | Ngày sẵn sàng tải trước GKI | Đã xác nhận? |
|---|---|---|---|
| Tháng 7 | Ngày 3 tháng 7 năm 2023 | Ngày 14 tháng 7 năm 2023 | Có |
| Tháng 9 | Ngày 1 tháng 9 năm 2023 | Ngày 15 tháng 9 năm 2023 | Có |
| Tháng 11 | Ngày 3 tháng 11 năm 2023 | Ngày 17 tháng 11 năm 2023 | Có |
| Tháng 1 | Ngày 5 tháng 1 năm 2024 | Ngày 19 tháng 1 năm 2024 | Có |
| Tháng 3 | Ngày 4 tháng 3 năm 2024 | Ngày 15 tháng 3 năm 2024 | Có |
| Tháng 5 | Ngày 1 tháng 5 năm 2024 | Ngày 17 tháng 5 năm 2024 | Có |
| Tháng 8 | Ngày 1 tháng 8 năm 2024 | Ngày 16 tháng 8 năm 2024 | Có |
| Tháng 11 | Ngày 1 tháng 11 năm 2024 | Ngày 15 tháng 11 năm 2024 | Có |
| Tháng 2 | Ngày 3 tháng 2 năm 2025 | Ngày 17 tháng 2 năm 2025 | Có |
Tính hợp lệ của bản dựng GKI cho OEM (Nhà sản xuất thiết bị gốc)
Nhà sản xuất thiết bị gốc có thể sử dụng GKI Android mới phát hành. OEM có thể ra mắt bằng Các bản dựng được GKI chứng nhận, miễn là tuân thủ các yêu cầu về LTS (hỗ trợ dài hạn) trong Bản tin về bảo mật Android (ASB).
Bản phát hành hoạt động phát triển hằng tuần
Bản phát hành được thử nghiệm với mực nhỏ nhằm đảm bảo chúng vượt qua tiêu chuẩn chất lượng tối thiểu.Bạn có thể tự phục vụ tệp nhị phân GKI trên ci.android.com khi các thay đổi được hợp nhất. Bản dựng hằng tuần sẽ không được chứng nhận, mặc dù có thể được dùng làm đường cơ sở để phát triển và kiểm thử. Không thể sử dụng bản dựng hằng tuần cho bản dựng thiết bị chính thức cho người dùng cuối.
Bản phát hành được chứng nhận hằng tháng
Các bản phát hành hằng tháng của GKI chứa một boot.img đã thử nghiệm, trong đó có
chứng chỉ được chèn để chứng thực tệp nhị phân được tạo từ một nguồn đã biết
đường cơ sở của mã.
Mỗi tháng, hệ thống sẽ chọn một bản phát hành thử nghiệm hằng tháng của GKI (chưa được chứng nhận) sau ngày hạn chót nhận phòng nhận phòng, đây thường là tuần thứ hai của trong tháng đó. Sau khi chọn bản phát hành hằng tháng, những thay đổi trong bản phát hành cho tháng đó sẽ không được chấp nhận. Trong cửa sổ đang đóng , thì chỉ có thể giải quyết các bản sửa lỗi gây ra thất bại trong kiểm thử. Chiến lược phát hành đĩa đơn đối tượng phát hành bản phát hành phải trải qua quy trình bảo đảm chất lượng (như được mô tả trong GKI) —để đảm bảo các bài kiểm tra tính tuân thủ vượt qua Bản dựng GSI+GKI gồm có một thiết bị tham chiếu cũng như con mực.
Hình 1. Tiến trình phát hành GKI
Quy trình khôi phục khẩn cấp
API trả lại tức là quá trình hợp nhất lại, tạo lại, kiểm thử lại và xác nhận lại tệp nhị phân sau bản phát hành công khai của nhân GKI. Bạn có thể yêu cầu gửi lại tệp nhị phân được chứng nhận cho bất kỳ nội dung nào sau đây trường hợp:
- Để cập nhật danh sách biểu tượng.
- Để áp dụng bản sửa lỗi cho một lỗi, bao gồm cả các lỗi phát hiện được trong quá trình phê duyệt phòng thí nghiệm của nhà mạng.
- Cách thêm hook của nhà cung cấp.
- Để áp dụng bản vá cho một tính năng hiện có.
- Để áp dụng bản vá bảo mật (sau 6 tháng).
Các bản vá bảo mật được tự động hợp nhất vào nhánh phát hành để 6 tháng sau khi chi nhánh được phát hành. Sau hạn chót nhận đơn đặt hàng 6 tháng, bạn phải yêu cầu một phản hồi để áp dụng các bản vá bảo mật cho một nhánh.
Nguyên tắc về yêu cầu đảo ngược
Trước khi yêu cầu ghim lại, hãy lưu ý các nguyên tắc sau:
Chỉ cho phép quay lại trên các nhánh phát hành sau bản phát hành công khai ban đầu của bản dựng hằng tháng đã phát hành.
Yêu cầu trả lại chỉ được chấp nhận cho một nhánh phát hành nhất định cho một tối đa 6 tháng kể từ lần phát hành công khai đầu tiên. Sau 6 tháng, các nhánh chỉ đủ điều kiện để trả lại các bản vá bảo mật được trích dẫn trong Bản tin về bảo mật Android.
Khi yêu cầu LTS , được xác định theo Bản tin về bảo mật Android (ASB) làm cho nhánh không tuân thủ, nên nhánh đó sẽ không được dùng nữa. Yêu cầu trả về cho các nhánh không dùng nữa đều không được chấp nhận. Ngày ngừng sử dụng một GKI cụ thể nhánh phát hành được đưa vào ghi chú bản dựng phát hành GKI hàng tháng trong Bản phát hành. Để phục vụ cho việc lập kế hoạch trong tương lai, chúng tôi sẽ cập nhật các yêu cầu về LTS (hỗ trợ dài hạn) vào tháng 5 và tháng 11 hằng năm. Ví dụ:
android12-5.10-2023-07nhánh (5.10.177) không được hỗ trợ cho respin sau ngày 1 tháng 5 năm 2024, vìandroid12-5.10-2023-07nhánh (5.10.177) không tuân thủ các yêu cầu LTS của ASB-2024-05.Tính năng quay lại chỉ áp dụng khi sửa lỗi khẩn cấp, cập nhật danh sách biểu tượng hoặc để áp dụng bản vá nhằm khắc phục một tính năng hiện có.
Tất cả các bản vá được đưa vào nhánh phát hành hằng tháng phải được hợp nhất vào nhánh phát triển GKI chính. Ví dụ: nếu cần một bản vá cho một trả về của
android12-5.10-2022-09, ảnh này phải được hợp nhất vàoandroid12-5.10.Bạn phải chọn các bản vá từ nhánh phát triển GKI chính và tải bản vá lên nhánh phát hành hằng tháng.
Trong yêu cầu trả về, bạn phải chỉ định mức độ ưu tiên (khẩn cấp) cho yêu cầu. Ưu tiên này giúp nhóm GKI hỗ trợ đối tác kịp thời hơn, hiệu quả hơn. Đối với các yêu cầu quan trọng hoặc khẩn cấp, hãy đánh dấu mức độ ưu tiên là P0. Cho P0 và P1 yêu cầu của bạn, bạn cũng phải chứng minh sự cấp bách. Bảng sau đây cung cấp ánh xạ mức độ ưu tiên lỗi và thời gian giải quyết (ESRT):
Mức độ ưu tiên Tiếng ESRT P0 2 ngày làm việc P1 5 ngày làm việc P2 10 ngày làm việc P3 15 ngày làm việc
Bạn phải gửi yêu cầu trả lại riêng cho từng nhánh phát hành. Ví dụ: nếu cần một respin cho cả
android12-5.10-2022-08vàandroid12-5.10-2022-09, bạn phải tạo 2 yêu cầu trả lại.Sau khi cung cấp bản dựng và yêu cầu trả lại được đánh dấu là đã khắc phục, bạn không nên mở lại yêu cầu trả về để thêm CL bổ sung. Bạn phải gửi yêu cầu trả lại nếu có các bản vá bổ sung cần được hợp nhất.
Đối với mỗi CL đang được xem xét, hãy thêm các thẻ sau.
Bug: bạn phải thêm mã lỗi vào thông báo cam kết cho mỗi CL.Change-Id: phải giống với Mã thay đổi của việc thay đổi nhánh cơ sở.
Nếu yêu cầu trả lại cần bạn phản hồi và bạn không phản hồi trong vòng Trong vòng 3 ngày làm việc, mức độ ưu tiên sẽ được hạ cấp xuống một cấp (ví dụ: P0 được hạ cấp xuống P1). Nếu bạn không phản hồi trong hai tuần, lỗi là được đánh dấu là Không khắc phục (Lỗi thời).
Gửi yêu cầu trả lại
Sơ đồ dưới đây minh hoạ quy trình trả lại. Quá trình này bắt đầu khi Đối tác OEM (bạn) gửi yêu cầu khôi phục.
Hình 2. Quá trình trả lại
Cách tham gia quy trình trả lại:
- Điền vào biểu mẫu yêu cầu trả về GKI.
và liên hệ ngay với Nhà quản lý tài khoản hỗ trợ kỹ thuật của Google. Biểu mẫu này
tạo ra lỗi yêu cầu trả về GKI. Bạn có thể thấy các lỗi yêu cầu xoay vòng
(người yêu cầu), nhóm GKI và những cá nhân cụ thể mà bạn thêm vào
danh sách CC của lỗi.
- Nếu bạn đã có bản sửa lỗi, yêu cầu phải trỏ đến bản vá gửi trong AOSP để Google có thể xem xét. Nếu bạn không gửi bản vá khả thi, bản vá phải được đính kèm dưới dạng tệp văn bản vào yêu cầu.
- Nếu bạn không có bản sửa lỗi, yêu cầu phải có nhiều nội dung thông tin nhất có thể, bao gồm cả số phiên bản kernel và nhật ký, để Google có thể giúp gỡ lỗi sự cố.
- Nhóm Google GKI sẽ xem xét và phê duyệt hoặc giao lại yêu cầu cho cho bạn nếu cần thêm thông tin.
- Sau khi đã thống nhất khắc phục, nhóm Google GKI sẽ xem xét mã (CR+2) thay đổi. Quá trình xem xét bắt đầu theo khung thời gian ESRT. Nhóm GKI hợp nhất, xây dựng, kiểm thử cho sự hồi quy và chứng nhận thay đổi.
- Tệp nhị phân được phát hành vào ci.android.com. Chiến lược phát hành đĩa đơn Khung thời gian ESRT kết thúc và nhóm Google GKI sẽ đánh dấu yêu cầu là đã khắc phục và hãy tham chiếu đến bản dựng respin. Bản dựng respin cũng được đăng trên Trang bản dựng phát hành Hình ảnh hạt nhân chung (GKI).
Điều kiện của GKI
| Các loại bản dựng GKI | Thực thi chất lượng | Ghi chú |
|---|---|---|
| Hằng tuần | Kiểm tra mực nang
|
|
| Hằng tháng (được chứng nhận) | Kiểm tra mực nang
|
|
| Respins (được chứng nhận) | Kiểm tra mực nang
|
|
Nơi lấy cấu phần phần mềm bản dựng
Bạn có thể lấy cấu phần phần mềm của tất cả các bản phát hành từ ci.android.com.
Bạn có thể tìm thêm thông tin về CI, bao gồm cả thông tin kết quả về tính năng Tích hợp liên tục với Android bảng điều khiển.
Câu hỏi thường gặp
Có thể tạo tệp nhị phân GKI mới dựa trên GKI đã phát hành không?
Đúng, đây gọi là phản hồi. Quá trình ghim lại được hỗ trợ miễn là bản dựng GKI được phát hành (trong đó yêu cầu quay lại kích thước) tuân thủ LTS các yêu cầu trong Bản tin về bảo mật Android (ASB).
Có thể tái tạo tệp nhị phân GKI không?
Có, hãy tham khảo ví dụ bên dưới.
GKI 2.0
5.10 kernel prebuilts from build 7364300
https://ci.android.com/builds/submitted/7364300/kernel_aarch64/latest
Để tái hiện ví dụ này, hãy tải manifest_$id.xml xuống và thực thi lệnh sau
:
repo init -u https://android.googlesource.com/kernel/manifestmv manifest_7364300.xml .repo/manifestsrepo init -m manifest_7364300.xml --depth=1repo sync # build the GKI images # You may want to use LTO=thin to build faster for developmentBUILD_CONFIG=common/build.config.gki.aarch64 build/build.sh # (optional) build virtual platform modulesBUILD_CONFIG=common-modules/virtual-device/build.config.virtual_device.aarch64 build/build.sh
Bạn có thể truy xuất bản sao cấu phần phần mềm GKI từ out/.../dist.
Tệp nhị phân GKI (bao gồm cả bản vá xoay tròn khẩn cấp) đã được xây dựng trên cơ sở mã mới nhất chưa?
Không. Respins chỉ chứa các bản vá phía trên bản vá được chứng nhận hàng tháng đã được chọn. Các respin này chứa tất cả lỗi chặn khởi chạy bản sửa lỗi được báo cáo cho đến bất kỳ thời điểm nào mà OEM (Nhà sản xuất thiết bị gốc) sử dụng cơ sở tương ứng bản phát hành hằng tháng. Hãy xem ví dụ sau đây về quy trình của loại tình huống này.
- OEM1 và OEM2 quyết định sử dụng bản phát hành nhị phân GKI từ tháng 11 năm 2021.
- OEM1 và OEM2 tìm thấy các vấn đề cần bản vá để hỗ trợ. Các bản vá này có thể khác nhau hoặc có thể giống nhau.
- Các phản hồi so với tệp nhị phân tháng 11 năm 2021 có chế độ chặn khởi chạy các bản sửa lỗi được cả OEM1 và OEM2 báo cáo trong cửa sổ trả lại, nhưng không có gì khác.
- Các vấn đề được đề cập trong dấu đầu dòng thứ hai cũng được đưa vào GKI tiếp theo bản phát hành hằng tháng.
Phản hồi tháng 10 có tất cả bản vá mà OEM đã gửi, nhưng các bản vá khác của OEM ảnh hưởng đến chúng tôi vì chúng chưa được thử nghiệm cụ thể với sản phẩm của chúng tôi. Có thể chỉ đưa vào bản vá của chúng tôi không?
Điều này là không thể. Một "mỗi nhà sản xuất thiết bị gốc" đường dẫn trả lại hiện không thể mở rộng. Thay vào đó, nhóm GKI xem xét kỹ lưỡng từng thay đổi sau khi đánh giá bản dựng và thử nghiệm các thay đổi với tất cả phần cứng có sẵn trước khi tạo một phần cứng mới bản dựng. Nếu nhóm GKI nhận thấy vấn đề chỉ xảy ra với một OEM/thiết bị/kiểu máy, nhóm GKI có thể đảm bảo rằng mã được thêm bởi thay đổi chỉ thực thi trên thiết bị/kiểu máy/SKU đang bị ảnh hưởng.
Lợi ích chính của tính năng phản hồi hợp nhất là mọi thiết bị việc sử dụng cùng một cơ sở phát hành sẽ có lợi ích lẫn nhau, đặc biệt là khi các lỗi mà họ phát hiện ra là chung và có thể áp dụng cho tất cả người dùng. Đã phát hiện các lỗi nhân hệ điều hành cốt lõi trong thử nghiệm nhà mạng là một ví dụ cụ thể về khái niệm này.
Có trường hợp nào mà Google cung cấp thông tin cụ thể về bản vá của OEM và tình huống sự cố để OEM có thể đánh giá tác động và rủi ro khi triển khai bản vá với sản phẩm của họ không?
Google sẽ không bao giờ thêm thay đổi nào vào bản dựng trả lại cho đến khi hiểu được vấn đề và mọi thông tin chi tiết đã được thu thập. Nội dung này được thấy trong nhật ký thay đổi (thông báo cam kết). Google không tiết lộ việc Google ảnh hưởng đến thiết bị cụ thể nào, nhưng OEM luôn có thể xem nội dung mô tả và giải pháp về vấn đề trong nhật ký thay đổi.