Halaman ini menjelaskan cara mem-build representasi ABI kernel Android dan menjalankan pemantauan ABI. Kebijakan ini berlaku untuk Android 14 dan yang lebih baru. Untuk versi yang lebih rendah, lihat Versi kernel yang lebih lama.
Lihat juga dokumentasi referensi untuk Kleaf: Mendukung pemantauan ABI (GKI) dan Mendukung pemantauan ABI (Perangkat).
Membangun kernel dan representasi ABI-nya
Setelah mendownload sumber GKI, jalankan perintah berikut untuk mem-build kernel GKI dan artefak ABI:
tools/bazel run //common:kernel_aarch64_abi_distPerintah ini mem-build representasi ABI saat ini dan menyalinnya ke
out_abi/kernel_aarch64/dist/abi.stg bersama dengan kernel dan modul yang di-build.
Anda dapat menentukan argumen tambahan untuk alat ABI di akhir perintah
setelah --. Misalnya, untuk mengubah tujuan ABI dan membuat artefak, Anda
dapat menggunakan opsi --dist_dir:
tools/bazel run //common:kernel_aarch64_abi_dist -- --dist_dir=out/distMenganalisis perbedaan ABI antara build dan representasi referensi
Target //common:kernel_aarch64_abi_dist, yang dijalankan dalam perintah di atas,
akan menganalisis dan melaporkan perbedaan ABI yang ditemukan antara representasi build dan
referensi yang terletak di common/android/abi_gki_aarch64.stg (ditentukan dalam
BUILD.bazel).
Perbedaan ini dicetak di akhir build, seperti yang ditunjukkan dalam
contoh berikut:
INFO: From [stg] Comparing Kernel ABI @//common:kernel_aarch64_abi_diff:
INFO: ABI DIFFERENCES HAVE BEEN DETECTED!
Laporan yang dicetak berasal dari artefak build yang terletak di
out_abi/kernel_aarch64/dist/abi_stgdiff/abi.report.short bersama dengan laporan dalam
format lain.
Otomatisasi harus menggunakan kode keluar perintah build, yang bukan nol jika perbedaan ditemukan.
Perhatikan bahwa cabang fase pengembangan, termasuk android-mainline, tidak memiliki representasi ABI referensi.
Tanpanya, //common:kernel_aarch64_abi_dist tidak akan mendeteksi perbedaan apa pun.
Mengupdate representasi ABI referensi
Setiap perubahan yang memengaruhi ABI kernel, seperti
update daftar simbol,
harus tercermin dalam representasi ABI referensi
(common/android/abi_gki_aarch64.stg, yang ditentukan dalam
BUILD.bazel).
Untuk melakukannya, Anda perlu menjalankan perintah berikut:
tools/bazel run //common:kernel_aarch64_abi_updatePerintah ini melakukan semua hal dalam langkah
Menganalisis perbedaan ABI dan juga memperbarui
representasi referensi dalam sumber. ABI yang telah diupdate kemudian dapat diupload dalam
commit yang sama dengan perubahan tersebut. Sertakan perbedaan ABI dari
laporan di $DIST_DIR/abi.report.short dalam pesan commit.
Pemantauan ABI dan target perangkat
Pemantauan ABI hanya perlu dikonfigurasi untuk target build kernel inti. Konfigurasi
build campuran (yang menentukan base_kernel) yang dikompilasi langsung dengan
kernel GKI hanya perlu menambahkan dukungan untuk melacak daftar
simbol perangkat.
Definisi ABI harus diperbarui menggunakan build GKI.
Lihat juga dokumentasi referensi untuk Kleaf: Mendukung pemantauan ABI (Perangkat).
Versi kernel yang lebih lama
Android 13
Petunjuk build sebagian besar sama dengan
Android 14, kecuali format ABI adalah XML dan
representasi ABI referensi adalah common/android/abi_gki_aarch64.xml.
Android 13 dan yang lebih lama
Seperti di Android 13, format ABI-nya adalah XML.
Kernel lama menggunakan build.sh, bukan Kleaf. Untuk pemantauan ABI, Anda harus menggunakan build_abi.sh, yang menerima variabel lingkungan yang sama untuk menyesuaikan build sebagai build.sh. Contoh:
BUILD_CONFIG=common/build.config.gki.aarch64 build/build_abi.shTindakan ini akan mem-build kernel dan mengekstrak representasi ABI ke subdirektori OUT_DIR
(yang merupakan out_abi secara default) dan setara dengan
target //common:kernel_aarch64_abi_dist Kleaf (lihat
Mem-build kernel dan artefak ABI).
Representasi ABI referensi disimpan di android/abi_gki_aarch64.xml seperti
yang ditentukan oleh variabel ABI_DEFINITION di common/build.config.gki.aarch64.
Jika Anda perlu mengupdate representasi ABI kernel, cara yang paling mudah adalah
menggunakan opsi --update dan --print-report:
BUILD_CONFIG=common/build.config.gki.aarch64 build/build_abi.sh --update --print-report--print-report mencetak perbedaan ABI antara file yang ada dan ABI yang baru dibuat.
Opsi --update akan menimpa representasi ABI referensi. Kode tersebut juga melakukan pembaruan daftar simbol saat menggunakan BUILD_CONFIG untuk perangkat dengan KMI_SYMBOL_LIST yang telah dikonfigurasi.