Halaman ini menjelaskan skema pembuatan versi untuk Image Kernel Generik (GKI). Generic Kernel Image (GKI) memiliki ID unik yang disebut rilis kernel. Rilis kernel terdiri dari versi antarmuka modul kernel (KMI) dan sublevel. Rilis kernel khusus untuk image yang dirilis, sedangkan versi KMI mewakili antarmuka tempat rilis dibuat. Versi KMI dapat mendukung beberapa rilis kernel. Rilis kernel hanya terikat dengan satu versi KMI. Jika antarmuka modul kernel harus diubah, pembuatan KMI akan diiterasi untuk mencerminkan perubahan dalam versi KMI.
Ringkasan persyaratan
Tabel berikut merangkum istilah penting yang digunakan di halaman ini dan untuk update GKI.
| Nama | Simbol | Contoh | Deskripsi |
|---|---|---|---|
| Rilis kernel | w.x.y-zzz-k-suffix | 5.4.42-android12-0-foo | ID unik untuk rilis GKI. Ini adalah nilai
yang ditampilkan oleh uname. |
| Versi KMI | w.x-zzz-k | 5.4-android12-0 | Menjelaskan antarmuka modul kernel (KMI) antara GKI dan modul kernel yang dapat dimuat secara dinamis (DLKM). |
| Subtingkat | y | 42 | Menjelaskan urutan rilis rilis kernel dalam versi KMI yang sama. |
Tabel berikut mencantumkan istilah terkait lainnya sebagai referensi.
| Nama | Simbol | Contoh | Deskripsi |
|---|---|---|---|
| w.x.y | w.x.y | 5.4.42 |
Untuk mengetahui detailnya, lihat Makefile Kernel Linux (telusuri "KERNELRELEASE"). w.x.y digunakan secara langsung di seluruh dokumen ini. Hal ini juga sering disebut sebagai nomor versi tiga bagian. Istilah yang digunakan di VINTF, kernel version, mungkin menyebabkan kebingungan dengan istilah lain, terutama w. Variabel ini disebut sebagai kernel_version_tuple di libkver. Tuple ini tidak boleh dikurangi oleh update apa pun, termasuk OTA atau mainline. |
| Cabang kernel | zzz-w.x | android12-5.4 | Istilah ini digunakan dalam Jenis cabang kernel umum. |
| Versi | w | 5 | Istilah ini tidak digunakan dalam dokumen ini. Variabel ini disebut sebagai version di libkver. |
| Level patch | x | 4 | Istilah ini tidak digunakan dalam dokumen ini. Variabel ini disebut sebagai patch_level di libkver. |
| Rilis Android | zzz | android12 |
Ini adalah nomor rilis Android (dessert) yang terkait dengan kernel.
Saat membandingkan kolom Nomor rilis Android tidak boleh dikurangi oleh update apa pun, termasuk OTA atau mainline. |
| Pembuatan KMI | k | 0 |
Ini adalah angka tambahan yang ditambahkan untuk menangani peristiwa yang tidak mungkin. Jika perbaikan bug keamanan memerlukan perubahan pada KMI dalam rilis Android yang sama, pembuatan KMI akan ditingkatkan. Nomor pembuatan KMI dimulai dengan 0. |
Desain pembuatan versi
Rilis kernel
Definisi
Untuk perangkat yang dilengkapi dengan GKI, rilis kernel ditentukan sebagai berikut:
KernelRelease :=
Version.PatchLevel.SubLevel-AndroidRelease-KmiGeneration-suffix
w .x .y -zzz -k -something
Untuk informasi selengkapnya, lihat Menentukan rilis kernel dari perangkat.
Berikut adalah contoh rilis kernel.
5.4.42-android12-0-00544-ged21d463f856
Deskripsi
Rilis {i>kernel<i} adalah ID unik dari rilis GKI. Jika dua biner GKI memiliki rilis kernel yang sama, keduanya harus identik byte demi byte.
Rilis kernel terdiri dari versi KMI, sublevel, dan akhiran. Untuk tujuan dokumen ini, akhiran setelah pembuatan KMI akan diabaikan.
Versi KMI
Definisi
Versi KMI ditentukan sebagai berikut:
KmiVersion :=
Version.PatchLevel-AndroidRelease-KmiGeneration
w .x -zzz -k
Perhatikan bahwa sublevel, y, bukan bagian dari versi KMI. Untuk contoh
di Rilis kernel, versi KMI adalah:
5.4-android12-0
Deskripsi
Versi KMI menjelaskan antarmuka modul kernel (KMI) antara GKI dan modul kernel yang dapat dimuat secara dinamis (DLKM).
Jika dua rilis kernel memiliki versi KMI yang sama, keduanya akan mengimplementasikan antarmuka modul kernel yang sama. DLKM yang kompatibel dengan satu juga kompatibel dengan yang lain.
Versi KMI tidak boleh dikurangi oleh update OTA apa pun.
Sublevel
Sublevel, y, menjelaskan urutan rilis rilis kernel dalam
versi KMI yang sama.
Untuk dua rilis kernel yang memiliki versi KMI yang sama, tetapi memiliki sublevel Y1 dan Y2:
- Jika Y1 kurang dari atau sama dengan Y2, perangkat yang menjalankan Y1 dapat menerima update ke Y2.
- Jika Y1 lebih besar dari Y2, perangkat yang menjalankan Y1 tidak dapat diupdate ke Y2.
Artinya, jika versi KMI tidak berubah, sublevel tidak boleh diturunkan oleh update OTA apa pun.
Menentukan rilis kernel dari perangkat
Rilis kernel lengkap dapat ditemukan dengan menjalankan uname -r, atau
uname(2)
dengan cuplikan kode berikut:
std::string get_kernel_release() {
struct utsname buf;
return uname(&buf) == 0 ? buf.release : "";
}
Contoh output-nya adalah:
5.4.42-android12-0-00544-ged21d463f856
Untuk tujuan dokumen ini, apa pun setelah pembuatan KMI akan diabaikan
saat mengekstrak informasi kernel. Secara lebih formal, output uname -r
diurai dengan ekspresi reguler
berikut (dengan asumsi zzz selalu diawali dengan "android"):
^(?P<w>\d+)[.](?P<x>\d+)[.](?P<y>\d+)-(?P<z>android\d+)-(?P<k>\d+).*$
Informasi yang diabaikan dapat mencakup informasi seperti nomor build ci.android.com, jumlah patch di atas kernel dasar pengukuran, dan hash SHA dari commit git.
libkver
Library, libkver, menyediakan antarmuka C++ untuk mengurai rilis kernel atau
string versi KMI. Untuk mengetahui daftar API yang diekspos libkver, lihat
packages/modules/Gki/libkver/include/kver.
Pemeriksaan VINTF
Untuk Android 11 atau yang lebih lama, bagian rilis Android dari versi KMI ditentukan secara manual dalam manifes perangkat oleh produsen perangkat. Untuk mengetahui detailnya, lihat Aturan pencocokan kernel VINTF.
Dari Android S, bagian rilis Android pada versi KMI dapat diekstrak dari kernel dan dimasukkan ke dalam manifes perangkat pada waktu build.
Karena persyaratan konfigurasi kernel umumnya tidak berubah, tidak perlu
mengenkode k dalam matriks kompatibilitas. Namun, jika persyaratan konfigurasi kernel perlu diubah, pastikan
hal berikut:
- Persyaratan yang sesuai dari matriks kompatibilitas akan dihapus.
- Uji VTS tambahan ditambahkan untuk memeriksa persyaratan baru bersyarat pada pembuatan KMI.
Versi image booting di metadata OTA
Meskipun image booting diupdate melalui update OTA, image tersebut harus
digabungkan dalam format payload OTA, payload.bin. Payload OTA mengenkode
kolom version untuk setiap partisi. Saat menangani payload OTA,
update_engine akan membandingkan kolom ini untuk memastikan partisi tidak didowngrade.
Untuk menghindari kebingungan, kolom version untuk partisi booting dalam metadata
OTA disebut boot image version.
Karena ramdisk selalu dibuat dari awal, penggunaan stempel waktu ramdisk sudah cukup untuk menjelaskan seluruh image booting. Anda tidak perlu mengenkode rilis kernel dalam versi boot image, kecuali jika Anda menggabungkan boot image lama ke biner kernel baru di masa mendatang.
Sebelum update OTA, klien OTA akan memeriksa versi image booting dengan cara yang sama seperti partisi lainnya.