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, 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 GKI phát triển để 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 được phát hành theo tần suất hằng tháng sau khi KMI ngừng hoạt động.

Bản phát hành GKI cho Android 13, 14 và 15

Bảng sau đây chỉ áp dụng cho android13-5.10, android13-5.15android14-5.15. Vui lòng xem ngày phát hành vào tháng 9 năm 2024 trong thông báo này.

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 11 Ngày 11 tháng 11 năm 2024 Ngày 27 tháng 11 năm 2024
Tháng 1 Ngày 17 tháng 1 năm 2025 Ngày 31 tháng 1 năm 2025
Tháng 2 Ngày 14 tháng 2 năm 2025 Ngày 28 tháng 2 năm 2025

Bảng sau chỉ áp dụng cho android14-6.1android15-6.6. Vui lòng xem ngày phát hành vào tháng 9 năm 2024 trong thông báo này.

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 1 tháng 10 năm 2024 Ngày 14 tháng 10 năm 2024
Tháng 11 Ngày 1 tháng 11 năm 2024 Ngày 15 tháng 11 năm 2024
Tháng 12 Ngày 2 tháng 12 năm 2024 Ngày 16 tháng 12 năm 2024
Tháng 1 Ngày 6 tháng 1 năm 2025 Ngày 22 tháng 1 năm 2025

Bản phát hành GKI cho 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 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 Bạn đã xác nhận chưa?
Tháng 7 Ngày 3 tháng 7 năm 2023 Ngày 14 tháng 7 năm 2023
Tháng 9 Ngày 1 tháng 9 năm 2023 Ngày 15 tháng 9 năm 2023
Tháng 11 Ngày 3 tháng 11 năm 2023 Ngày 17 tháng 11 năm 2023
Tháng 1 Ngày 5 tháng 1 năm 2024 Ngày 19 tháng 1 năm 2024
Tháng 3 Ngày 4 tháng 3 năm 2024 Ngày 15 tháng 3 năm 2024
Tháng 5 Ngày 1 tháng 5 năm 2024 Ngày 17 tháng 5 năm 2024
Tháng 8 Ngày 1 tháng 8 năm 2024 Ngày 16 tháng 8 năm 2024
Tháng 11 Ngày 1 tháng 11 năm 2024 Ngày 15 tháng 11 năm 2024
Tháng 2 Ngày 3 tháng 2 năm 2025 Ngày 17 tháng 2 năm 2025

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 Bạch mực 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 Android Khoảng tin cậy (CI) 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ị phát hành chính thức dành 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ó một mã 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.

Tiến trình phát hành GKI 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ách cập nhật danh sách ký hiệu.
  • Để á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:

  • Bạn chỉ được phép thực hiện thao tác quay lại trên các nhánh phát hành sau khi bản phát hành công khai đầu tiên của một bản dựng hằng tháng được ra mắt.

  • Chúng tôi chỉ chấp nhận yêu cầu phát hành lại cho một nhánh phát hành nhất định trong tối đa 6 tháng sau bả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-07 nhá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-07 nhá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á đ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 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ào android12-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ả 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 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-08android12-5.10-2022-09, bạn phải tạo 2 yêu cầu trả lại.

  • Sau khi cung cấp một bản dựng và yêu cầu gửi lại được đánh dấu là đã khắc phục, bạn không nên mở lại yêu cầu gửi lại để thêm các CL khác. 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: 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.

Quy trình khôi phục khẩn cấp Hình 2. Quá trình trả lại

Cách tham gia quy trình trả lại:

  1. Điền vào biểu mẫu yêu cầu gửi lại 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 chứa nhiều thông tin nhất có thể, bao gồm cả số phiên bản hạt nhân và nhật ký để Google có thể giúp gỡ lỗi vấn đề.
  2. 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.
  3. Sau khi đã thống nhất cách 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.
  4. 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
  • Giày bốt
  • Tập hợp con của VTS
  • Một số con của CTS
  • Chưa được chứng nhận. Chỉ dành cho mục đích thử nghiệm và hiển thị thiết bị
    .
  • Không thể dùng để khởi chạy thiết bị.
Hằng tháng (được chứng nhận) Kiểm tra mực nang
  • Giày bốt
  • VTS
  • CTS (Bộ kiểm tra tính tương thích)
Kiểm thử phần cứng để đối chiếu
  • Giày bốt
  • VTS
  • CTS (Bộ kiểm tra tính tương thích)
Respins (được chứng nhận) Kiểm tra mực nang
  • Giày bốt
  • VTS
  • Một số con của CTS
Kiểm thử thiết bị tham chiếu
  • Giày bốt
  • VTS
  • Được xây dựng dựa trên bản dựng được GKI chứng nhận.
  • Bản dựng được chứng nhận sau khi đủ điều kiện.

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

Dưới đâ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 tệp nhị phân GKI mới dựa trên GKI đã phát hành không?

Có, đây được gọi là lượt thử lạ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ó, 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 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/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ấ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 khẩn cấp) đã được tạo trên cơ sở mã mới nhất chưa?

Không. Respins chỉ chứa các bản vá bên trên bản vá được chứng nhận hàng tháng đã được chọn. Các bản phát hành lại này chứa tất cả bản sửa lỗi lỗi chặn khởi chạy do OEM báo cáo cho đến thời điểm bất kỳ bằng cách sử dụng bản phát hành cơ sở tương ứng 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" không thể mở rộng đường dẫn trả lại. 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ị hoặc mô hình phân bổ này, 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 hoặc SKU chịu ả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 là chung và á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 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 của việc 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ộ thiết bị cụ thể nào bị ảnh hưởng, nhưng 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.