Kể từ năm 2026, để phù hợp với mô hình phát triển ổn định của nhánh chính và đảm bảo tính ổn định của nền tảng cho hệ sinh thái, chúng tôi sẽ xuất bản mã nguồn lên AOSP vào quý 2 và quý 4. Để tạo và đóng góp cho AOSP, bạn nên sử dụng android-latest-release thay vì aosp-main. Nhánh tệp kê khai android-latest-release sẽ luôn tham chiếu đến bản phát hành gần đây nhất được chuyển đến AOSP. Để biết thêm thông tin, hãy xem bài viết Các thay đổi đối với AOSP.

Định cấu hình các tính năng của hạt nhân dưới dạng mô-đun GKI

Trang này trình bày cách định cấu hình một tính năng mới của kernel dưới dạng mô-đun GKI hoặc định cấu hình một tính năng hiện có của kernel tích hợp dưới dạng mô-đun GKI.

Định cấu hình một tính năng mới dưới dạng mô-đun GKI

Đối với tính năng mới, hãy chỉnh sửa gki_defconfig và đặt mục cấu hình của tính năng kernel bắt buộc từ n thành m (=m). Đặt chế độ cài đặt này trong cả arch/arm64/configs/gki_defconfig và arch/x86/configs/gki_defconfig.
Thêm các tệp KO (.ko) được tạo cho tính năng này vào phần _COMMON_GKI_MODULES_LIST của tệp sau. Thêm các tệp theo thứ tự đã sắp xếp. Nếu bạn không chắc chắn về tất cả các tệp được tạo, thì quá trình xây dựng sẽ không thành công và liệt kê tất cả các tệp KO cần thiết để thêm vào danh sách.
- Trong android17-6.18 trở lên, hãy thêm các mục vào common/bazel/modules_private.bzl.
- Trong android16-6.12 trở xuống, hãy thêm các mục vào common/modules.bzl.
Đối với Android 14, hãy thêm cùng một tập hợp tệp KO từ bước 2, được sắp xếp theo thứ tự tăng dần để tìm kiếm nhị phân trong thời gian chạy, vào common/android/gki_{ARCH}_protected_modules để chỉ định mô-đun là mô-đun GKI được bảo vệ.
Đối với Android 14 và 15, hãy cập nhật danh sách các mục xuất để danh sách này bao gồm các mục xuất mới được thêm vào common/android/abi_gki_protected_exports_ARCHITECTURE. Ví dụ: để cập nhật danh sách, hãy chạy tools/bazel run //common:kernel_aarch64_abi_update_protected_exports cho aarch64.
Đảm bảo các tệp KO mới được thêm từ bước 2 được sao chép vào out/<androidX-Y.Z>/dist/system_dlkm.img và out/androidX-Y.Z/dist/system_dlkm_staging_archive.tar.gz của kernel. Bạn có thể sử dụng các mô-đun trong kho lưu trữ system_dlkm_staging_archive.tar.gz làm dữ liệu đầu vào để tạo system_dlkm.img trong bản dựng nền tảng.
Gửi các thay đổi của bạn để xem xét. Mô-đun GKI là một tính năng nhân hệ điều hành chỉ dành cho Android, vì vậy, bạn không cần gửi các bản vá chuyển đổi mô-đun lên nguồn gốc. Tuy nhiên, bạn phải tuân theo các nguyên tắc khác để gửi bản vá Android Common Kernel (ACK).

Định cấu hình một tính năng tích hợp của kernel dưới dạng mô-đun GKI

Đối với một tính năng tích hợp hiện có của kernel, hãy chỉnh sửa gki_defconfig và đặt mục cấu hình của tính năng kernel bắt buộc từ y thành m (=m). Đặt chế độ cài đặt này trong cả arch/arm64/configs/gki_defconfig và arch/x86/configs/gki_defconfig.
Thêm các tệp KO (.ko) được tạo cho tính năng này vào phần _COMMON_GKI_MODULES_LIST của tệp sau. Thêm các tệp theo thứ tự đã sắp xếp. Nếu bạn không chắc chắn về tất cả các tệp được tạo, thì quá trình xây dựng sẽ không thành công và liệt kê tất cả các tệp KO cần thiết để thêm vào danh sách.
- Trong android17-6.18 trở lên, hãy thêm các mục vào common/bazel/modules_private.bzl.
- Trong android16-6.12 trở xuống, hãy thêm các mục vào `common/modules.bzl.
Đối với Android 14, hãy thêm cùng một tập hợp tệp KO từ bước 2, được sắp xếp theo thứ tự tăng dần để tìm kiếm nhị phân trong thời gian chạy, vào common/android/gki_{ARCH}_protected_modules để chỉ định mô-đun là mô-đun GKI được bảo vệ.
Đối với Android 14 và 15, hãy cập nhật danh sách các mục xuất được bảo vệ để bao gồm các mục xuất từ mô-đun mới được thêm vào common/android/abi_gki_protected_exports_{ARCH} bằng tools/bazel run //common:kernel_aarch64_abi_update_protected_exports cho aarch64.
Đảm bảo các tệp KO mô-đun mới được chuyển đổi từ bước 2 được sao chép vào kernel's out/<androidX-Y.Z>/dist/system_dlkm.img và out/androidX-Y.Z/dist/system_dlkm_staging_archive.tar.gz. Bạn có thể sử dụng các mô-đun trong kho lưu trữ system_dlkm_staging_archive.tar.gz làm dữ liệu đầu vào để tạo system_dlkm.img trong bản dựng nền tảng.
Gửi các thay đổi của bạn để xem xét. Mô-đun GKI là một tính năng nhân hệ điều hành chỉ dành cho Android, vì vậy, bạn không cần gửi các bản vá chuyển đổi mô-đun lên nguồn gốc. Tuy nhiên, bạn phải tuân theo các nguyên tắc khác để gửi bản vá Android Common Kernel (ACK).

Chuyển đổi mô-đun GKI được bảo vệ thành mô-đun không được bảo vệ

Đối với Android 15 trở lên, hãy thêm mô-đun đang được chuyển đổi từ mô-đun được bảo vệ thành mô-đun không được bảo vệ vào danh sách _COMMON_UNPROTECTED_MODULES_LIST trong tệp sau:
- Trong android17-6.18 trở lên, hãy thêm các mục vào common/bazel/modules_private.bzl.
- Trong android16-6.12 trở xuống, hãy thêm các mục vào common/modules.bzl.
Đối với Android 14, hãy xoá mô-đun đang được chuyển đổi từ mô-đun được bảo vệ thành mô-đun không được bảo vệ khỏi danh sách các mô-đun được bảo vệ tại common/android/gki_protected_modules.
Đối với Android 14 và 15, hãy cập nhật danh sách các mục xuất được bảo vệ để loại trừ các mục xuất từ mô-đun không được bảo vệ mới được chuyển đổi trong common/android/abi_gki_protected_exports_{ARCH} bằng tools/bazel run //common:kernel_aarch64_abi_update_protected_exports cho aarch64.
Gửi các thay đổi của bạn để xem xét. Mô-đun GKI là một tính năng nhân hệ điều hành chỉ dành cho Android, vì vậy, bạn không cần gửi các bản vá chuyển đổi mô-đun lên nguồn gốc. Tuy nhiên, bạn phải tuân theo các nguyên tắc khác để gửi bản vá Android Common Kernel (ACK).

Hướng dẫn nhanh về cách giải quyết lỗi vi phạm ký hiệu mô-đun GKI

Khi các mô-đun chưa ký vi phạm quy tắc bảo vệ ký hiệu hiện có đối với các mô-đun GKI, bạn có thể gặp phải 2 loại lỗi trong quá trình tải mô-đun, dẫn đến lỗi.

1. Mô-đun chưa ký sử dụng ký hiệu được bảo vệ

Lỗi:

module: Protected symbol: some_kernel_function (err -13)

Nguyên nhân:

Tệp module.ko là một mô-đun nhà cung cấp chưa ký và cố gắng phân giải ký hiệu được xuất của mô-đun GKI some_kernel_function trong quá trình tải mà không được liệt kê trong danh sách ký hiệu của nhà cung cấp.

Cách giải quyết:

Nếu module.ko không phải là mô-đun GKI được bảo vệ, thì việc cập nhật danh sách ký hiệu sẽ giải quyết lỗi bằng cách đưa some_kernel_function vào danh sách ký hiệu của nhà cung cấp. Ngoài ra, hãy sử dụng phiên bản GKI của module.ko.

2. Mô-đun chưa ký xuất ký hiệu được bảo vệ