Trang này mô tả cách tạo bản trình bày ABI hạt nhân Android và chạy tính năng giám sát ABI. Phương thức này áp dụng cho Android 14 trở lên. Đối với các phiên bản thấp hơn, hãy tham khảo Các phiên bản kernel cũ hơn.
Ngoài ra, hãy xem tài liệu tham khảo về Kleaf: Hỗ trợ giám sát ABI (GKI) và Hỗ trợ giám sát ABI (Thiết bị).
Tạo nhân và phần trình bày ABI của nhân
Sau khi tải các nguồn GKI xuống, hãy chạy lệnh sau để tạo nhân hệ điều hành GKI và cấu phần phần mềm ABI:
tools/bazel run //common:kernel_aarch64_abi_distLệnh này tạo bản trình bày ABI hiện tại rồi sao chép bản trình bày đó vào out_abi/kernel_aarch64/dist/abi.stg cùng với nhân và mô-đun đã tạo.
Bạn có thể chỉ định các đối số bổ sung cho công cụ ABI ở cuối lệnh sau --. Ví dụ: để thay đổi đích đến cho ABI và tạo cấu phần phần mềm, bạn có thể sử dụng tuỳ chọn --dist_dir:
tools/bazel run //common:kernel_aarch64_abi_dist -- --dist_dir=out/distPhân tích sự khác biệt về ABI giữa bản dựng và bản trình bày tham chiếu
Mục tiêu //common:kernel_aarch64_abi_dist, được thực thi trong lệnh ở trên, phân tích và báo cáo mọi sự khác biệt về ABI tìm thấy giữa bản dựng và bản trình bày tham chiếu nằm ở common/android/abi_gki_aarch64.stg (được xác định trong BUILD.bazel). Những sự khác biệt này được in ra ở cuối bản dựng, như minh hoạ trong ví dụ sau:
INFO: From [stg] Comparing Kernel ABI @//common:kernel_aarch64_abi_diff:
INFO: ABI DIFFERENCES HAVE BEEN DETECTED!
Báo cáo được in được lấy từ cấu phần phần mềm bản dựng nằm tại out_abi/kernel_aarch64/dist/abi_stgdiff/abi.report.short, cùng với các báo cáo ở các định dạng khác.
Quy trình tự động hoá phải sử dụng mã thoát của lệnh bản dựng. Mã này sẽ khác 0 nếu tìm thấy sự khác biệt.
Xin lưu ý rằng các nhánh giai đoạn phát triển, bao gồm cả android-mainline, không có nội dung đại diện ABI tham chiếu.
Nếu không có hàm này, //common:kernel_aarch64_abi_dist sẽ không phát hiện thấy bất kỳ sự khác biệt nào.
Cập nhật bản trình bày ABI tham chiếu
Mọi thay đổi ảnh hưởng đến ABI của hạt nhân, chẳng hạn như bản cập nhật danh sách biểu tượng, đều cần được phản ánh trong bản trình bày ABI tham chiếu (common/android/abi_gki_aarch64.stg, được xác định trong BUILD.bazel).
Để thực hiện việc này, bạn cần chạy lệnh sau:
tools/bazel run //common:kernel_aarch64_abi_updateLệnh này thực hiện mọi thao tác trong bước Phân tích sự khác biệt về ABI, đồng thời cập nhật nội dung trình bày tham chiếu trong các nguồn. Sau đó, bạn có thể tải ABI đã cập nhật lên trong cùng một cam kết với thay đổi đó. Đưa các điểm khác biệt về ABI từ báo cáo trong $DIST_DIR/abi.report.short vào thông báo cam kết.
Giám sát ABI và mục tiêu thiết bị
Bạn chỉ cần định cấu hình tính năng giám sát ABI cho các mục tiêu bản dựng nhân chính. Cấu hình bản dựng hỗn hợp (cấu hình xác định base_kernel) biên dịch trực tiếp với hạt nhân GKI chỉ cần thêm tính năng hỗ trợ theo dõi danh sách biểu tượng thiết bị.
Bạn nên cập nhật định nghĩa ABI bằng bản dựng GKI.
Ngoài ra, hãy xem tài liệu tham khảo về Kleaf: Hỗ trợ giám sát ABI (Thiết bị).
Các phiên bản kernel cũ
Android 13
Hướng dẫn tạo bản dựng hầu như giống với Android 14, ngoại trừ định dạng ABI là XML và cách trình bày ABI tham chiếu là common/android/abi_gki_aarch64.xml.
Android 13 trở xuống
Giống như trong Android 13, định dạng ABI là XML.
Các nhân cũ sử dụng build.sh thay vì Kleaf. Để theo dõi ABI, bạn nên sử dụng build_abi.sh. Phương thức này chấp nhận các biến môi trường giống nhau để tuỳ chỉnh bản dựng như build.sh. Ví dụ:
BUILD_CONFIG=common/build.config.gki.aarch64 build/build_abi.shThao tác này sẽ tạo hạt nhân và trích xuất bản trình bày ABI vào thư mục con OUT_DIR (là out_abi theo mặc định) và tương đương với mục tiêu //common:kernel_aarch64_abi_dist của Kleaf (xem phần Cấu phần phần mềm cho hạt nhân và ABI của bản dựng).
Bản trình bày ABI tham chiếu được lưu trữ trong android/abi_gki_aarch64.xml do biến ABI_DEFINITION trong common/build.config.gki.aarch64 xác định.
Nếu bạn cần cập nhật nội dung trình bày ABI của hạt nhân, cách thuận tiện nhất là sử dụng các tuỳ chọn --update và --print-report:
BUILD_CONFIG=common/build.config.gki.aarch64 build/build_abi.sh --update --print-report--print-report in ra sự khác biệt về ABI giữa tệp hiện có và ABI mới tạo.
Tuỳ chọn --update sẽ ghi đè cách biểu diễn ABI tham chiếu. Phương thức này cũng thực hiện cập nhật danh sách biểu tượng khi sử dụng BUILD_CONFIG cho một thiết bị đã định cấu hình KMI_SYMBOL_LIST.