GKI 1.0: Kiểm tra khả năng tương thích

Trang này mô tả cách lấy hình ảnh khởi động có cấu phần phần mềm bản dựng nhân để kiểm thử khả năng tương thích.

Tải hình ảnh khởi động

Trong AOSP, bạn có thể lấy hình ảnh khởi động tạo sẵn từ ci.android.com. Hình ảnh khởi động nằm trong tệp lưu trữ aosp_arm64-img-*.zip trong mục tiêu bản dựng aosp_arm64 như sau:

Đối tác có thể lấy hình ảnh khởi động đã ký hoặc chưa ký như sau:

  • Tải hình ảnh khởi động chưa ký dựa trên android12-5.4 từ nhánh aosp-main tại ci.android.com (xem trong mục tiêu bản dựng aosp_arm64). Các hình ảnh khởi động này chứa một ổ đĩa RAM được tạo từ nhánh main của AOSP. Đừng sử dụng hình ảnh boot-debug; các hình ảnh này chỉ dành cho các thiết bị trước GKI.
  • Nhận hình ảnh khởi động đã ký dựa trên android11-5.4 từ partner.android.com. Các hình ảnh khởi động này chứa một ổ đĩa RAM được tạo từ nhánh r-fs-release. Quy trình ký boot.img tuân theo quy trình tương tự như quy trình ký GSI.

Cả hình ảnh khởi động đã ký và chưa ký đều có các tuỳ chọn nén nhân sau:

  • boot-5.4.img là một hạt nhân không nén.
  • boot-5.4-gz là một hạt nhân nén gzip.
  • boot-5.4-lz4 là một nhân nén lz4.
Để kiểm thử khả năng tương thích, hãy sử dụng hình ảnh khởi động có nhân chỉ xuất các ký hiệu xuất hiện trên danh sách ký hiệu KMI (các ký hiệu là trimmed).

Đối với mục đích phát triển, bạn có thể sử dụng các tệp tạo sẵn của hạt nhân và hình ảnh khởi động GKI để xuất tất cả các biểu tượng trong hạt nhân (các biểu tượng là untrimmed). Các tệp tạo sẵn của hạt nhân chưa được cắt bớt được tạo trong mục tiêu kernel_debug_aarch64 cho một bản dựng hạt nhân cụ thể trên ci.android.com. Hình ảnh khởi động GKI chưa được cắt bớt được tạo trong các bản dựng userdebug cùng với hình ảnh khởi động GKI đã cắt bớt thông thường và có tên tệp kết thúc bằng -allsyms.img.

Nhận cấu phần phần mềm bản dựng hạt nhân

Khi gỡ lỗi các vấn đề trong tệp boot.img GKI, bạn cũng nên liên kết các cấu phần phần mềm bản dựng với hạt nhân trong tệp đó. Ví dụ: bạn có thể sử dụng vmlinux chưa bị loại bỏ để gỡ lỗi và tệp kê khai để tạo lại bản dựng hạt nhân GKI cục bộ. Cách lấy cấu phần phần mềm bản dựng:

  1. Tìm số bản dựng cho hạt nhân được tạo sẵn dùng để tạo boot.img GKI. Số bản dựng xuất hiện ở cuối phiên bản hạt nhân, trước đó là các chữ cái ab. Ví dụ sau đây cho thấy số bản dựng được in đậm:

    [ 0.000000] Linux version 5.4.49-00947-g9d21bcd4897b-ab6638796

    Bạn cũng có thể xác định số bản dựng của hạt nhân bằng cách sử dụng grep để tìm hình ảnh khởi động chứa hạt nhân không nén:

    grep -a "Linux version " boot-5.4.img

  2. Mở bản dựng nhân được tạo sẵn bằng cách sử dụng số bản dựng trong URL sau: https://ci.android.com/builds/submitted/<number>/kernel_aarch64/latest

    Ví dụ: sử dụng số bản dựng từ bước 1, URL sẽ như sau: https://ci.android.com/builds/submitted/6638796/kernel_aarch64/latest

    Khi sử dụng bản dựng chưa cắt bớt, hãy thay thế kernel_aarch64 trong đường liên kết bằng kernel_debug_aarch64.