Quy trình phát hành Hình ảnh hạt nhân chung (GKI)

Trang này mô tả cách phát hành GKI, bao gồm cả các bản phát hành khẩn cấp hằng tuần, hằng quý 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 lấy GKI cũng như quy trình sửa lỗi khẩn cấp ngoài băng tần. Các OEM cũng có thể sử dụng hoạt động phát triển GKI để tìm hiểu thêm về cách họ có thể hợp tác với nhóm Nhân Android để tối ưu hoá nhân GKI cho sản phẩm của mình.

Lịch trình phát hành GKI

GKI được phát hành theo quý sau khi KMI ngừng hoạt động.

Tính hợp lệ của bản dựng GKI đối với OEM

Các OEM có thể sử dụng GKI Android mới phát hành. Nhà sản xuất thiết bị gốc (OEM) có thể ra mắt các bản dựng được chứng nhận GKI miễn là các bản dự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 được chứng nhận hằng quý

Các bản phát hành hằng quý của GKI có chứa một boot.img đã được kiểm thử, bao gồm một chứng chỉ do Google chèn vào để chứng thực rằng các tệp nhị phân được tạo từ một đường cơ sở mã nguồn đã biết.

Mỗi quý, một bản phát hành ứng cử viên hằng quý của GKI (chưa được chứng nhận) sẽ đượ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 bạn chọn phiên bản phát hành thử nghiệm hằng quý, các thay đổi mới sẽ không được chấp nhận vào bản phát hành của tháng đó. Trong thời gian đóng cửa, chỉ những bản sửa lỗi gây ra lỗi kiểm thử mới được giải quyết. Bản phát hành ứng cử viên trải qua quy trình đảm bảo chất lượng (như mô tả trong phần kiểm định GKI) để đảm bảo các bài kiểm thử tuân thủ vượt qua bản dựng GSI+GKI bằng thiết bị tham chiếu cũng như cuttlefish.

Hình 1. Lịch phát hành GKI

Điều kiện đối với GKI

Nơi lấy các cấu phần phần mềm

Bạn có thể lấy các cấu phần phần mềm 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 thử trên trang tổng quan Tích hợp liên tục trên Android.

Câu hỏi thường gặp

Sau đây là một số câu hỏi thường gặp liên quan đến quy trình phát hành GKI.

Có thể tạo một tệp nhị phân GKI mới dựa trên một GKI đã phát hành hay không?

Có, đây được gọi là respin. Quy trình phát hành lại được hỗ trợ miễn là bản dựng GKI đã phát hành (mà bạn yêu cầu phát hành lại) tuân thủ các yêu cầu về LTS trong Bản tin về bảo mật Android (ASB).

Có thể sao chép các tệp nhị phân GKI không?

Có, sau đây là một ví dụ:

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 manifest_$id.xml xuống và thực thi lệnh sau:

repo init -u https://android.googlesource.com/kernel/manifest
mv manifest_7364300.xml .repo/manifests
repo init -m manifest_7364300.xml --depth=1
repo sync
# build the GKI images
# You may want to use LTO=thin to build faster for development
BUILD_CONFIG=common/build.config.gki.aarch64 build/build.sh
# (optional) build virtual platform modules
BUILD_CONFIG=common-modules/virtual-device/build.config.virtual_device.aarch64 build/build.sh

Bạn có thể truy xuất bản sao của 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á khẩn cấp) có được tạo trên cơ sở mã mới nhất không?

Không. Bản phát hành lại chỉ chứa các bản vá nằm trên các nhân được chứng nhận hằng quý mà bạn đã chọn. Các bản phát hành lại này chứa tất cả các bản sửa lỗi chặn khởi chạy mà OEM đã báo cáo cho đến một thời điểm bất kỳ bằng cách sử dụng bản phát hành cơ sở hằng quý tương ứng. Hãy xem ví dụ sau đây về cách xảy ra 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 phát hiện thấy các vấn đề cần có bản vá để được hỗ trợ. Các bản vá này có thể khác nhau hoặc có thể giống nhau.
• Các bản phát hành lại trên bản nhị phân tháng 11 năm 2021 có các bản sửa lỗi chặn khởi chạy do cả OEM1 và OEM2 báo cáo trong cửa sổ phát hành 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ó trong các bản phát hành GKI hằng quý tiếp theo.

Bản phát hành lại tháng 10 có tất cả các bản vá do 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 kiểm thử 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 không?

Bạn không thể làm việc này. Đường dẫn respin "cho mỗi OEM" không thể mở rộng. Thay vào đó, nhóm GKI sẽ xem xét kỹ lưỡng từng thay đổi trong các bản dựng respin và kiểm thử các thay đổi đó với tất cả phần cứng hiện có trước khi tạo một bản dựng mới. Nếu nhóm GKI nhận thấy vấn đề này chỉ xảy ra trên một OEM, thiết bị hoặc mô hình cụ thể, thì nhóm GKI có thể đảm bảo rằng mã do thay đổi này thêm vào chỉ thực thi trên thiết bị, mô hình hoặc SKU chịu ảnh hưởng.

Lợi ích chính của việc phát hành lại 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 ích từ nhau, đặc biệt nếu các lỗi mà chúng phát hiện là lỗi chung và áp dụng cho tất cả người dùng. Lỗi nhân cốt lõi được phát hiện trong quá trình kiểm thử của nhà mạng là một ví dụ cụ thể về 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á của OEM và các tình huống có vấn đề để OEM có thể đánh giá tác động và rủi ro khi triển khai các bản vá với 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 respin cho đến khi hiểu rõ vấn đề và thu thập được tất cả thông tin chi tiết. Điều này được thể hiện trong nhật ký thay đổi (thông báo cam kết). Google không tiết lộ thiết bị cụ thể mà vấn đề này ảnh hưởng, nhưng các OEM luôn có thể tìm thấy nội dung mô tả và giải pháp cho vấn đề trong nhật ký thay đổi.