Chạy tính năng giám sát ABI

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 Phiên bản kernel cũ hơn.

Ngoài ra, hãy xem tài liệu tham khảo cho 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 chạy lệnh sau để tạo cấu phần phần mềm nhân hệ điều hành GKI và ABI:

tools/bazel run //common:kernel_aarch64_abi_dist

Lệ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 hệ điều hành và các 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à cấu phần phần mềm bản dựng, bạn có thể sử dụng tuỳ chọn --dist_dir:

tools/bazel run //common:kernel_aarch64_abi_dist -- --dist_dir=out/dist

Phâ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ư 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 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 ở định dạng khác.

Tính năng tự động hoá sẽ sử dụng mã thoát của lệnh bản dựng, mã này khác 0 nếu phát hiện 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ó giá trị này, //common:kernel_aarch64_abi_dist sẽ không phát hiện thấy sự khác biệt nào.

Cập nhật bản trình bày ABI tham chiếu

Bất kỳ thay đổi nào ảnh hưởng đến ABI của nhân hệ điều hành, chẳng hạn như cập nhật danh sách biểu tượng, 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_update

Lệnh này thực hiện mọi việc trong bước Phân tích sự khác biệt về ABI đồng thời cập nhật thêm nội dung 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.

Hoạt động 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. Kết hợp các cấu hình bản dựng (cấu hình xác định base_kernel) sẽ biên dịch trực tiếp bằng nhân GKI chỉ cần thêm hỗ trợ theo dõi biểu tượng thiết bị danh sách. 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

Như trong Android 13, định dạng ABI là XML.

Các hạt 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.sh

Thao tác này sẽ tạo hạt nhân và trích xuất nội dung đại diện ABI vào thư mục con OUT_DIR (theo mặc định là out_abi) và tương đương với mục tiêu //common:kernel_aarch64_abi_dist của Kleaf (xem phần Tạo hạt nhân và cấu phần phần mềm ABI).

Bản trình bày ABI tham chiếu được lưu trữ trong android/abi_gki_aarch64.xml dưới dạng được xác định bởi biến ABI_DEFINITION trong common/build.config.gki.aarch64.

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 những điểm khác biệt về ABI giữa tệp khi tồn tại và một ABI mới tạo.

Tuỳ chọn --update sẽ ghi đè nội dung đại 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.