Phiên bản GKI

Trang này mô tả sơ đồ lập phiên bản cho Hình ảnh hạt nhân chung (GKI). Hình ảnh hạt nhân chung (GKI) có một mã định danh duy nhất được gọi là bản phát hành hạt nhân. Bản phát hành hạt nhân bao gồm phiên bản giao diện mô-đun hạt nhân (KMI) và cấp độ phụ. Bản phát hành kernel dành riêng cho hình ảnh được phát hành, trong khi phiên bản KMI đại diện cho giao diện mà bản phát hành được xây dựng từ đó. Một phiên bản KMI có thể hỗ trợ nhiều bản phát hành kernel. Bản phát hành kernel chỉ được gắn với một phiên bản KMI. Trong trường hợp không chắc chắn khi phải thay đổi giao diện mô-đun hạt nhân, việc tạo KMI sẽ được lặp lại để phản ánh sự thay đổi trong phiên bản KMI.

Tóm tắt các điều khoản

Bảng sau đây tóm tắt các thuật ngữ quan trọng được sử dụng trên trang này và dành cho các bản cập nhật GKI.

Tên Biểu tượng Ví dụ Sự miêu tả
Phát hành hạt nhân hậu tố wxy-zzz-k 5.4.42-android12-0-foo Mã định danh duy nhất cho bản phát hành GKI. Đây là giá trị được trả về bởi uname .
Phiên bản KMI wx-zzz-k 5.4-android12-0 Mô tả giao diện mô-đun hạt nhân (KMI) giữa GKI và các mô-đun hạt nhân có thể tải động (DLKM).
cấp dưới y 42 Mô tả thứ tự phát hành của các bản phát hành kernel trong cùng một phiên bản KMI.

Bảng sau liệt kê các thuật ngữ liên quan khác làm tài liệu tham khảo.

Tên Biểu tượng Ví dụ Sự miêu tả
wxy wxy 5.4.42

Để biết chi tiết, hãy xem Tệp tạo hạt nhân Linux (tìm kiếm "KERNELRELEASE").

wxy được sử dụng trực tiếp xuyên suốt tài liệu này. Đây cũng thường được gọi là số phiên bản gồm ba phần . Thuật ngữ được sử dụng trong VINTF, phiên bản kernel , có thể gây nhầm lẫn với các thuật ngữ khác, đặc biệt là w .

Biến này được gọi là kernel_version_tuple trong libkver .

Bộ dữ liệu này không được giảm bớt bởi bất kỳ bản cập nhật nào, kể cả OTA hoặc đường truyền chính.

Nhánh hạt nhân zzz-wx android12-5.4 Thuật ngữ này được sử dụng trong các loại nhánh hạt nhân thông thường .
Phiên bản w 5 Thuật ngữ này không được sử dụng trong tài liệu này. Biến này được gọi là phiên bản trong libkver .
Cấp độ bản vá x 4 Thuật ngữ này không được sử dụng trong tài liệu này. Biến này được gọi là patch_level trong libkver .
Bản phát hành Android zzzz android12

Đây là số phát hành Android (món tráng miệng) mà hạt nhân được liên kết.

Khi so sánh trường AndroidRelease , phần số được trích xuất từ ​​chuỗi để so sánh.

Số lượng phát hành Android không được giảm bớt bởi bất kỳ bản cập nhật nào, kể cả OTA hoặc dòng chính.

Tạo KMI k 0

Đây là một con số bổ sung được thêm vào để đối phó với các sự kiện không thể xảy ra. Nếu bản sửa lỗi bảo mật yêu cầu thay đổi KMI trong cùng một bản phát hành Android thì thế hệ KMI sẽ tăng lên.

Số tạo KMI bắt đầu bằng 0.

Thiết kế phiên bản

Phát hành hạt nhân

Sự định nghĩa

Đối với các thiết bị đi kèm GKI, bản phát hành kernel được xác định như sau:

KernelRelease :=
Version.PatchLevel.SubLevel-AndroidRelease-KmiGeneration-suffix
w      .x         .y       -zzz           -k            -something

Để biết thêm thông tin, hãy xem Xác định bản phát hành kernel từ thiết bị .

Sau đây là một ví dụ về bản phát hành kernel.

5.4.42-android12-0-00544-ged21d463f856

Sự miêu tả

Bản phát hành kernel là ID duy nhất của bản phát hành GKI. Nếu hai tệp nhị phân GKI có cùng bản phát hành kernel thì chúng phải giống nhau theo từng byte.

Bản phát hành kernel bao gồm phiên bản KMI, cấp phụ và hậu tố. Vì mục đích của tài liệu này, hậu tố sau khi tạo KMI bị bỏ qua.

Phiên bản KMI

Sự định nghĩa

Phiên bản KMI được định nghĩa như sau:

KmiVersion :=
Version.PatchLevel-AndroidRelease-KmiGeneration
w      .x         -zzz           -k

Lưu ý rằng cấp độ phụ, y không phải là một phần của phiên bản KMI. Ví dụ trong Kernel Release thì phiên bản KMI là:

5.4-android12-0

Sự miêu tả

Phiên bản KMI mô tả giao diện mô-đun hạt nhân (KMI) giữa GKI và các mô-đun hạt nhân có thể tải động (DLKM).

Nếu hai bản phát hành hạt nhân có cùng phiên bản KMI thì chúng sẽ triển khai cùng một giao diện mô-đun hạt nhân. Các DLKM tương thích với cái này cũng tương thích với cái kia.

Phiên bản KMI không được giảm bớt bởi bất kỳ bản cập nhật OTA nào.

cấp dưới

Cấp phụ, y , mô tả thứ tự phát hành của các bản phát hành kernel trong cùng một phiên bản KMI.

Đối với hai bản phát hành kernel có cùng phiên bản KMI nhưng có cấp phụ Y1 và Y2 tương ứng:

  • Nếu Y1 nhỏ hơn hoặc bằng Y2, thiết bị chạy Y1 có thể nhận được bản cập nhật lên Y2.
  • Nếu Y1 lớn hơn Y2, thiết bị chạy Y1 không thể cập nhật lên Y2.

Nghĩa là, nếu phiên bản KMI không thay đổi thì cấp độ phụ không được giảm bởi bất kỳ bản cập nhật OTA nào.

Xác định phát hành kernel từ thiết bị

Có thể tìm thấy bản phát hành kernel đầy đủ bằng cách thực thi uname -r hoặc uname(2) với đoạn mã sau:

std::string get_kernel_release() {
  struct utsname buf;
  return uname(&buf) == 0 ? buf.release : "";
}

Một đầu ra ví dụ là:

5.4.42-android12-0-00544-ged21d463f856

Vì mục đích của tài liệu này, mọi thứ sau quá trình tạo KMI đều bị bỏ qua khi trích xuất thông tin kernel. Chính thức hơn, đầu ra của uname -r được phân tích cú pháp bằng biểu thức chính quy sau (giả sử zzz luôn bắt đầu bằng "android"):

^(?P<w>\d+)[.](?P<x>\d+)[.](?P<y>\d+)-(?P<z>android\d+)-(?P<k>\d+).*$

Thông tin bị bỏ qua có thể bao gồm thông tin như số bản dựng ci.android.com , số lượng bản vá trên hạt nhân cơ sở và hàm băm SHA của cam kết git.

libkver

Thư viện libkver cung cấp giao diện C++ để phân tích bản phát hành kernel hoặc chuỗi phiên bản KMI. Để biết danh sách các API mà libkver hiển thị, hãy xem packages/modules/Gki/libkver/include/kver .

Kiểm tra VINTF

Đối với Android 11 trở xuống, phần phát hành Android của phiên bản KMI được nhà sản xuất thiết bị chỉ định thủ công trong tệp kê khai thiết bị. Để biết chi tiết, xem quy tắc khớp hạt nhân VINTF .

Từ Android S, phần phát hành Android của phiên bản KMI có thể được trích xuất từ ​​kernel và đưa vào bảng kê khai thiết bị tại thời điểm xây dựng.

Vì các yêu cầu cấu hình kernel thường không thay đổi nên không cần mã hóa k trong ma trận tương thích. Tuy nhiên, trong trường hợp không thể xảy ra khi yêu cầu cấu hình kernel cần phải thay đổi, hãy đảm bảo những điều sau:

  • Yêu cầu tương ứng từ ma trận tương thích sẽ bị loại bỏ.
  • Các bài kiểm tra VTS bổ sung được thêm vào để kiểm tra các yêu cầu mới có điều kiện về việc tạo KMI.

Phiên bản hình ảnh khởi động trong siêu dữ liệu OTA

Ngay cả khi hình ảnh khởi động được cập nhật thông qua bản cập nhật OTA, nó vẫn phải được gói trong định dạng tải trọng OTA, payload.bin . Tải trọng OTA mã hóa trường version cho mỗi phân vùng. Khi update_engine xử lý tải trọng OTA, nó sẽ so sánh trường này để đảm bảo phân vùng không bị hạ cấp.

Để tránh nhầm lẫn, trường version cho phân vùng khởi động trong siêu dữ liệu OTA được gọi là boot image version .

Bởi vì ramdisk luôn được xây dựng từ đầu nên việc sử dụng dấu thời gian của ramdisk là đủ để mô tả toàn bộ image khởi động. Không cần mã hóa bản phát hành kernel trong phiên bản ảnh khởi động, trừ khi bạn ghép ảnh khởi động cũ vào tệp nhị phân kernel mới trong tương lai.

Trước khi cập nhật OTA, máy khách OTA sẽ kiểm tra phiên bản boot image theo cách tương tự như bất kỳ phân vùng nào khác.