Tài liệu này mô tả cách GKI được phát hành, bao gồm các bản phát hành khẩn cấp hàng tuần, hàng tháng và ngoài băng tần. Mục tiêu của tài liệu này là cung cấp cho OEM hướng dẫn về nơi nhận GKI cũng như quy trình khắc phục tình trạng khẩn cấp ngoài băng tần. Các 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 Nhân Android nhằm tối ưu hóa nhân GKI cho các sản phẩm của mình.
Nhịp độ phát hành GKI
GKI được phát hành theo nhịp hàng tháng sau khi KMI bị đóng băng.
Bản phát hành GKI Android 13 và 14
Bảng sau chỉ áp dụng cho android13-5.10 , android13-5.15 và android14-6.1 .
| Bản dựng được chứng nhận hàng tháng của GKI | Ngày hết hạn nhận phòng | Ngày sẵn sàng tải trước GKI | Đã xác nhận? |
|---|---|---|---|
| Tháng Mười | Ngày 14 tháng 10 năm 2022 | Ngày 31 tháng 10 năm 2022 | Đúng |
| Tháng mười một | Ngày 14 tháng 11 năm 2022 | Ngày 30 tháng 11 năm 2022 | Đúng |
| Tháng 12 | Ngày 9 tháng 12 năm 2022 | Ngày 21 tháng 12 năm 2022 | Đúng |
| Tháng Một | Ngày 17 tháng 1 năm 2023 | Ngày 31 tháng 1 năm 2023 | Đúng |
| Tháng hai | Ngày 15 tháng 2 năm 2023 | Ngày 28 tháng 2 năm 2023 | Đúng |
| Bước đều | Ngày 15 tháng 3 năm 2023 | Ngày 31 tháng 3 năm 2023 | Đúng |
| Tháng tư | Ngày 13 tháng 4 năm 2023 | Ngày 28 tháng 4 năm 2023 | Đúng |
| Có thể | Ngày 17 tháng 5 năm 2023 | Ngày 31 tháng 5 năm 2023 | Đúng |
| Tháng sáu | Ngày 15 tháng 6 năm 2023 | Ngày 30 tháng 6 năm 2023 | Đúng |
| Tháng bảy | Ngày 18 tháng 7 năm 2023 | Ngày 31 tháng 7 năm 2023 | Đúng |
| Tháng tám | Ngày 16 tháng 8 năm 2023 | Ngày 31 tháng 8 năm 2023 | Đúng |
| Tháng 9 | Ngày 14 tháng 9 năm 2023 | Ngày 29 tháng 9 năm 2023 | Đúng |
| Tháng Mười | Ngày 18 tháng 10 năm 2023 | Ngày 31 tháng 10 năm 2023 | Đúng |
| Tháng mười một | Ngày 10 tháng 11 năm 2023 | Ngày 30 tháng 11 năm 2023 | Đúng |
| Tháng 12 | Ngày 7 tháng 12 năm 2023 | Ngày 22 tháng 12 năm 2023 | Đúng |
| Tháng Một | Ngày 16 tháng 1 năm 2024 | Ngày 31 tháng 1 năm 2024 | Đúng |
| Tháng hai | Ngày 13 tháng 2 năm 2024 | Ngày 29 tháng 2 năm 2024 | Đúng |
| Bước đều | Ngày 13 tháng 3 năm 2024 | Ngày 29 tháng 3 năm 2024 | Đúng |
| Tháng tư | Ngày 16 tháng 4 năm 2024 | Ngày 30 tháng 4 năm 2024 | Đúng |
| Có thể | Ngày 14 tháng 5 năm 2024 | Ngày 31 tháng 5 năm 2024 | Đúng |
| Tháng sáu | Ngày 12 tháng 6 năm 2024 | Ngày 28 tháng 6 năm 2024 | Đúng |
| Tháng bảy | Ngày 16 tháng 7 năm 2024 | Ngày 31 tháng 7 năm 2024 | Đúng |
| Tháng tám | Ngày 15 tháng 8 năm 2024 | Ngày 30 tháng 8 năm 2024 | Đúng |
| Tháng 9 | Ngày 17 tháng 9 năm 2024 | Ngày 30 tháng 9 năm 2024 | Đúng |
| Tháng Mười | Ngày 15 tháng 10 năm 2024 | Ngày 31 tháng 10 năm 2024 | Đúng |
| Tháng mười một | Ngày 11 tháng 11 năm 2024 | Ngày 27 tháng 11 năm 2024 | Đúng |
| Tháng 12 | Ngày 6 tháng 12 năm 2024 | Ngày 23 tháng 12 năm 2024 | Đúng |
Bắt đầu từ tháng 1 năm 2024, chúng tôi sẽ tiếp tục phát hành hàng tháng android14-5.15 theo nhịp hàng tháng được chỉ định trong bảng bên dưới.
| Bản dựng được chứng nhận hàng tháng của GKI | Ngày hết hạn nhận phòng | Ngày sẵn sàng tải trước GKI | Đã xác nhận? |
|---|---|---|---|
| Tháng Một | Ngày 16 tháng 1 năm 2024 | Ngày 31 tháng 1 năm 2024 | Đúng |
| Tháng hai | Ngày 13 tháng 2 năm 2024 | Ngày 29 tháng 2 năm 2024 | Đúng |
| Bước đều | Ngày 4 tháng 3 năm 2024 | Ngày 15 tháng 3 năm 2024 | Đúng |
| Tháng tư | Ngày 1 tháng 4 năm 2024 | Ngày 17 tháng 4 năm 2024 | Đúng |
| Có thể | Ngày 1 tháng 5 năm 2024 | Ngày 17 tháng 5 năm 2024 | Đúng |
| Tháng sáu | Ngày 3 tháng 6 năm 2024 | Ngày 17 tháng 6 năm 2024 | Đúng |
| Tháng bảy | Ngày 1 tháng 7 năm 2024 | Ngày 15 tháng 7 năm 2024 | Đúng |
| Tháng tám | Ngày 1 tháng 8 năm 2024 | Ngày 16 tháng 8 năm 2024 | Đúng |
| Tháng 9 | Ngày 2 tháng 9 năm 2024 | Ngày 16 tháng 9 năm 2024 | Đúng |
| Tháng Mười | Ngày 1 tháng 10 năm 2024 | Ngày 14 tháng 10 năm 2024 | Đúng |
| Tháng mười một | Ngày 1 tháng 11 năm 2024 | Ngày 15 tháng 11 năm 2024 | Đúng |
| Tháng 12 | Ngày 2 tháng 12 năm 2024 | Ngày 16 tháng 12 năm 2024 | Đúng |
Bản phát hành GKI Android 12
Sau tháng 5 năm 2023, các bản phát hành GKI android12-5.10 sẽ có tiến độ 2 tháng và được xuất bản vào giữa tháng. Bảng sau chỉ áp dụng cho android12-5.10 .
| Bản dựng được chứng nhận hàng tháng của GKI | Ngày hết hạn nhận phòng | Ngày sẵn sàng tải trước GKI | Đã xác nhận? |
|---|---|---|---|
| Tháng bảy | Ngày 3 tháng 7 năm 2023 | Ngày 14 tháng 7 năm 2023 | Đúng |
| Tháng 9 | Ngày 1 tháng 9 năm 2023 | Ngày 15 tháng 9 năm 2023 | Đúng |
| Tháng mười một | Ngày 3 tháng 11 năm 2023 | Ngày 17 tháng 11 năm 2023 | Đúng |
| Tháng Một | Ngày 5 tháng 1 năm 2024 | Ngày 19 tháng 1 năm 2024 | Đúng |
| Bước đều | Ngày 4 tháng 3 năm 2024 | Ngày 15 tháng 3 năm 2024 | Đúng |
| Có thể | Ngày 1 tháng 5 năm 2024 | Ngày 17 tháng 5 năm 2024 | Đúng |
Tính hợp lệ của bản dựng GKI dành cho OEM
Các OEM có thể sử dụng Android GKI được phát hành gần đây. OEM có thể ra mắt các bản dựng được chứng nhận GKI miễn là chúng tuân thủ các yêu cầu LTS trong Bản tin bảo mật Android (ASB).
Bản phát hành phát triển hàng tuần
Các bản phát hành được thử nghiệm với mực nang để đảm bảo chúng vượt qua tiêu chuẩn chất lượng tối thiểu .Các tệp nhị phân GKI có sẵn để tự phục vụ từ ci.android.com khi các thay đổi được hợp nhất. Các bản dựng hàng tuần sẽ không được chứng nhận, mặc dù có thể được sử dụng làm cơ sở để phát triển và thử nghiệm. Không thể sử dụng bản dựng hàng tuần để tạo bản dựng thiết bị sản xuất cho người dùng cuối.
Bản phát hành được chứng nhận hàng tháng
Bản phát hành hàng tháng của GKI chứa boot.img đã được thử nghiệm bao gồm chứng chỉ do Google chèn vào để chứng thực rằng các tệp nhị phân được xây dựng từ đường cơ sở mã nguồn đã biết.
Mỗi tháng, một ứng cử viên phát hành hàng tháng của GKI (không được chứng nhận) được chọn sau ngày hết hạn đăng ký, thường là bản dựng hàng tuần thứ hai của tháng đó. Sau khi ứng cử viên phát hành hàng tháng được chọn, những thay đổi mới sẽ không được chấp nhận trong bản phát hành của tháng đó. Trong thời gian đóng cửa, chỉ có thể giải quyết các bản sửa lỗi gây ra lỗi kiểm thử. Ứng viên phát hành phải trải qua quá trình đảm bảo chất lượng—như được mô tả trong phần chứng nhận GKI —để đảm bảo các bài kiểm tra tuân thủ vượt qua bản dựng GSI+GKI với thiết bị tham chiếu cũng như mực nang.
Hình 1. Dòng thời gian phát hành GKI
Quá trình hô hấp khẩn cấp
Vòng quay lại đề cập đến quá trình hợp nhất lại, xây dựng lại, kiểm tra lại và chứng nhận lại tệp nhị phân sau khi phát hành công khai hạt nhân GKI . Bạn có thể yêu cầu quay lại tệp nhị phân được chứng nhận trong bất kỳ trường hợp nào sau đây:
- Để 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 lỗi được tìm thấy trong quá trình phê duyệt của phòng thí nghiệm của nhà cung cấp dịch vụ.
- Để thêm một hook nhà cung cấp .
- Để áp dụng một 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 một nhánh phát hành trong tối đa 6 tháng sau khi nhánh phát hành. Sau thời hạn 6 tháng, bạn phải yêu cầu phản hồi để áp dụng các bản vá bảo mật cho một chi nhánh.
Trước khi yêu cầu quay lại, hãy lưu ý các nguyên tắc sau:
Phản hồi chỉ được phép trên các nhánh phát hành sau khi bản phát hành công khai ban đầu của bản dựng hàng tháng được tung ra.
Yêu cầu phản hồi chỉ được chấp nhận đối với một nhánh phát hành nhất định trong tối đa sáu tháng sau lần phát hành công khai đầu tiên. Sau sáu tháng, các chi nhánh chỉ đủ điều kiện phản hồi đối với các bản vá bảo mật được trích dẫn trong Bản tin bảo mật Android .
Khi các yêu cầu LTS do Bản tin bảo mật Android (ASB) xác định khiến nhánh không tuân thủ thì nhánh đó sẽ không được dùng nữa. Yêu cầu phản hồi cho các nhánh không được dùng nữa sẽ không được chấp nhận. Ngày không dùng nữa đối với một nhánh phát hành GKI nhất định được bao gồm trong ghi chú xây dựng bản phát hành GKI hàng tháng trong Bản phát hành . Để lập kế hoạch trong tương lai, các yêu cầu LTS được cập nhật vào tháng 5 và tháng 11 hàng năm. Ví dụ: nhánh
android12-5.10-2023-07(5.10.177) không được hỗ trợ cho các vòng quay sau ngày 1 tháng 5 năm 2024, vì nhánhandroid12-5.10-2023-07(5.10.177) không tuân thủ Yêu cầu LTS của ASB-2024-05.Vòng quay chỉ áp dụng cho các bản 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á để sửa một tính năng hiện có.
Tất cả các bản vá đi 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 có bản vá cho vòng quay
android12-5.10-2022-09thì bản vá đó 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 quay lại, 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 tốt hơn một cách kịp thời. Đối với các yêu cầu quan trọng hoặc nhạy cảm về thời gian, hãy đánh dấu mức độ ưu tiên là P0 . Đối với các yêu cầu P0 và P1, bạn cũng phải chứng minh mức độ khẩn cấp. Bảng sau đây cung cấp ánh xạ về mức độ ưu tiên của lỗi và thời gian giải quyết (ESRT):
Sự ưu tiên 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 quay lại riêng cho mỗi nhánh phát hành. Ví dụ: nếu cần quay lại cho cả
android12-5.10-2022-08vàandroid12-5.10-2022-09, bạn phải tạo hai yêu cầu quay lại.Sau khi bản dựng được cung cấp và yêu cầu quay lại được đánh dấu là đã sửa, bạn không nên mở lại yêu cầu quay lại để thêm CL bổ sung. Bạn phải gửi yêu cầu quay lại mới nếu có thêm bản vá 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. Tiến trình yêu cầu quay lại bị chặn nếu không có thông tin này.
-
Bug: ID lỗi phải được thêm vào thông báo cam kết cho mỗi CL. -
Change-Id: phải giống với Id thay đổi của thay đổi nhánh cơ sở.
-
Nếu yêu cầu quay lại yêu cầu bạn phản hồi và bạn không phản hồi trong vòng ba ngày làm việc thì mức độ ưu tiên sẽ bị hạ xuống một cấp (ví dụ: P0 bị hạ cấp xuống P1 ). Nếu bạn không phản hồi trong hai tuần, lỗi sẽ được đánh dấu là Không sửa được (Lỗi thời) .
Gửi yêu cầu quay lại
Sơ đồ sau đây cho thấy quá trình quay lại. Quá trình bắt đầu khi Đối tác OEM (bạn) gửi yêu cầu quay lại.
Hình 2. Quá trình quay lại
Để tham gia vào quá trình quay lại:
- Điền vào mẫu yêu cầu GKI Respin . và liên hệ ngay với Người quản lý tài khoản kỹ thuật của Google. Biểu mẫu này tạo ra lỗi yêu cầu quay lại GKI. Lỗi yêu cầu phản hồi sẽ hiển thị với bạn (người yêu cầu), nhóm GKI và các 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 sẽ trỏ đến bản gửi bản vá trong AOSP để Google có thể xem xét bản sửa lỗi đó. Nếu việc gửi bản vá không khả thi thì 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ó cách khắc phục thì yêu cầu phải chứa càng nhiều thông tin càng tốt, 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 GKI của Google xem xét yêu cầu và phê duyệt hoặc giao lại cho bạn nếu cần thêm thông tin.
- Sau khi bản sửa lỗi được thống nhất, mã nhóm Google GKI sẽ xem xét (CR+2) thay đổi đó. Việc xem xét bắt đầu khung thời gian ESRT. Nhóm GKI hợp nhất, xây dựng, kiểm tra hồi quy và chứng nhận thay đổi.
- Tệp nhị phân được phát hành cho ci.android.com . Khung thời gian ESRT kết thúc và nhóm Google GKI đánh dấu yêu cầu là đã sửa và tham chiếu bản dựng vòng quay. Bản dựng respin cũng được đăng trên trang bản phát hành Hình ảnh hạt nhân chung (GKI) .
Bằng cấp 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
| |
| Phản hồi (được chứng nhận) | Kiểm tra mực nang
|
|
Nơi để có được các tạo phẩm xây dựng
Bạn có thể lấy hiện vật cho 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ả kết quả kiểm tra trên trang tổng quan Tích hợp liên tục của Android .
Câu hỏi thường gặp
Có thể xây dựng tệp nhị phân GKI mới dựa trên GKI đã được phát hành không?
Vâng, điều này được gọi là một phản ứng quay. Quá trình quay lại được hỗ trợ miễn là bản dựng GKI đã phát hành (trên đó yêu cầu quay lại) tuân thủ các yêu cầu LTS trong Bản tin bảo mật Android (ASB).
Có thể tái tạo các 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 tạo ví dụ này, hãy tải xuống manifest_$id.xml và thực hiện 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 tạo tác GKI của mình từ out/.../dist .
Tệp nhị phân GKI (bao gồm cả bản vá quay vòng khẩn cấp) đã được xây dựng trên cơ sở mã mới nhất chưa?
Không. Phản hồi chỉ chứa các bản vá nằm trên các hạt nhân được chứng nhận hàng tháng đã được chọn. Các vòng quay này chứa tất cả các bản sửa lỗi chặn khởi chạy được các OEM báo cáo cho đến bất kỳ thời điểm nhất định nào bằng cách sử dụng bản phát hành cơ sở hàng tháng tương ứng. Xem ví dụ sau đây về cách loại kịch bản này xảy ra.
- 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 có bản vá để được hỗ trợ. Những bản vá này có thể khác nhau hoặc có thể giống nhau.
- Các vòng quay trên cùng của hệ nhị phân tháng 11 năm 2021 có các bản sửa lỗi chặn khởi chạy được báo cáo bởi cả OEM1 và OEM2 trong thời gian quay lại, nhưng không có gì khác.
- Các vấn đề được đề cập trong phần thứ hai cũng được đưa vào các bản phát hành hàng tháng tiếp theo của GKI.
Vòng quay tháng 10 có tất cả các bản vá lỗi do OEM gửi, nhưng các bản vá OEM khác ảnh hưởng đến chúng tôi vì chúng chưa được thử nghiệm cụ thể với các sản phẩm của chúng tôi. Có thể chỉ bao gồm bản vá của chúng tôi?
Điều này là không thể. Đường dẫn phản hồi "mỗi OEM" hiện không thể mở rộng được. Thay vào đó, nhóm GKI xem xét kỹ lưỡng từng thay đổi trong các bản dựng phản hồi và kiểm tra các thay đổi đó với tất cả phần cứng có sẵn trước khi tạo bản dựng mới. Nếu nhóm GKI nhận thấy rằng sự cố chỉ xảy ra với một OEM/thiết bị/kiểu máy thì nhóm GKI có thể đảm bảo rằng mã được thêm vào do thay đổi chỉ thực thi trên thiết bị/kiểu máy/SKU bị ảnh hưởng.
Lợi ích chính của vòng quay hợp nhất là mọi thiết bị sử dụng cùng một cơ sở phát hành đều có lợi cho nhau, đặc biệt nếu các lỗi mà chúng phát hiện là chung và có thể áp dụng cho tất cả người dùng. Các lỗi lõi lõi được tìm thấy trong quá trình kiểm tra sóng mang là một ví dụ cụ thể của khái niệm này.
Có trường hợp nào Google cung cấp thông tin cụ thể về các bản vá lỗi OEM và các kịch bản sự cố để các OEM có thể đánh giá tác động và rủi ro khi triển khai các bản vá lỗi cho sản phẩm của họ không?
Google sẽ không bao giờ thêm thay đổi vào bản dựng phản hồi cho đến khi hiểu được vấn đề và tất cả thông tin chi tiết đã được thu thập. Điều này được thấy trong nhật ký thay đổi (thông báo cam kết). Google không tiết lộ thiết bị cụ thể nào bị ảnh hưởng, nhưng các OEM luôn có thể tìm thấy mô tả vấn đề và giải pháp trong nhật ký thay đổi.