Çekirdek oluşturma

Bu sayfada, Android cihazlar için özel çekirdek oluşturma süreci ayrıntılı olarak açıklanmıştır. Bu talimatlar, doğru kaynakları seçme, çekirdeği oluşturma ve sonuçları Android Açık Kaynak Projesi'nden (AOSP) oluşturulan bir sistem resmine yerleştirme sürecinde size yol gösterir.

Kaynakları ve derleme araçlarını indirme

Son çekirdekler için kaynakları, araç zincirini ve derleme komut dosyalarını indirmek üzere repo seçeneğini kullanın. Bazı çekirdekler (ör. Pixel 3 çekirdekleri) birden fazla git deposundan kaynak gerektirirken diğerleri (ör. ortak çekirdekler) yalnızca tek bir kaynak gerektirir. repo yaklaşımı, kaynak dizin ayarının doğru olmasını sağlar.

İlgili dalın kaynaklarını indirin:

mkdir android-kernel && cd android-kernel

repo init -u https://android.googlesource.com/kernel/manifest -b BRANCH

repo sync

Önceki "repo init" komutuyla kullanılabilen repo dallarının (BRANCH) listesi için Çekirdek dalları ve derleme sistemleri başlıklı makaleyi inceleyin.

Pixel cihazlar için çekirdekleri indirme ve derleme hakkında ayrıntılı bilgi edinmek isterseniz Pixel Çekirdeklerini Derleme başlıklı makaleyi inceleyin.

Çekirdeği oluşturma

Bazel ile derleme (Kleaf)

Android 13, Bazel ile çekirdek oluşturma özelliğini kullanıma sundu.

aarch64 mimarisi için GKI çekirdeği dağıtımı oluşturmak amacıyla, Android 13 veya daha yeni bir Android Ortak Çekirdek dalına göz atın ve ardından aşağıdaki komutu çalıştırın:

tools/bazel run //common:kernel_aarch64_dist [-- --destdir=$DIST_DIR]

Ardından çekirdek ikili dosyası, modüller ve ilgili resimler $DIST_DIR dizininde bulunur. --destdir belirtilmezse yapıların konumu için komutun çıktısına bakın. Ayrıntılar için AOSP dokümanlarına bakın.

build.sh ile derleme (eski)

Android 12 veya önceki sürümlerdeki dallar VEYA Kleaf içermeyen dallar için:

build/build.sh

Çekirdek ikili dosyası, modüller ve ilgili resim out/BRANCH/dist dizininde bulunur.

Sanal cihaz için tedarikçi modüllerini derleme

Android 13, build.sh yerine Bazel (Kleaf) ile çekirdek oluşturma özelliğini kullanıma sundu.

virtual_device modülleri için bir dağıtım oluşturmak üzere şunları çalıştırın:

tools/bazel run //common-modules/virtual-device:virtual_device_x86_64_dist [-- --destdir=$DIST_DIR]

Bazel ile Android çekirdeği oluşturma hakkında daha fazla bilgi için Kleaf - Bazel ile Android Çekirdeklerini Derleme.

Ayrı mimariler için Kleaf desteği hakkında ayrıntılı bilgi edinmek istiyorsanız Cihazlar ve çekirdekler için Kleaf desteği başlıklı makaleyi inceleyin.

build.sh (eski) ile sanal cihazın tedarikçi modüllerini derleme

Android 12'de Mürekkep Balığı ve Japon Balığı birleştiğinden aynı çekirdeği paylaşırlar: virtual_device. Bu çekirdeğin modüllerini oluşturmak için şu derleme yapılandırmasını kullanın:

BUILD_CONFIG=common-modules/virtual-device/build.config.virtual_device.x86_64 build/build.sh

Android 11, çekirdeği Google tarafından yönetilen bir çekirdek resmine ve ayrı olarak oluşturulan tedarikçi firma tarafından yönetilen modüllere ayıran GKI'yi kullanıma sundu.

Bu örnekte bir çekirdek görüntü yapılandırması gösterilmektedir:

BUILD_CONFIG=common/build.config.gki.x86_64 build/build.sh

Bu örnekte bir modül yapılandırması (Mürekkep Balığı ve Emülatör) gösterilmektedir:

BUILD_CONFIG=common-modules/virtual-device/build.config.cuttlefish.x86_64 build/build.sh

Çekirdeği çalıştırma

Özel olarak oluşturulmuş bir çekirdeği çalıştırmanın birden fazla yolu vardır. Aşağıda, çeşitli geliştirme senaryolarına uygun bilinen yöntemler verilmiştir.

Android görüntü derlemesine yerleştirme

Image.lz4-dtb dosyasını AOSP ağacındaki ilgili çekirdek ikili dosyasına kopyalayın ve önyükleme görüntüsünü yeniden oluşturun.

Alternatif olarak, make bootimage (veya önyükleme resmi oluşturan başka bir make komut satırı) kullanırken TARGET_PREBUILT_KERNEL değişkenini tanımlayabilirsiniz. Bu değişken, device/common/populate-new-device.sh üzerinden ayarlandığı için tüm cihazlar tarafından desteklenir. Örneğin:

export TARGET_PREBUILT_KERNEL=DIST_DIR/Image.lz4-dtb

Fastboot ile çekirdekleri flaşlama ve önyükleme

En son cihazların çoğunda, önyükleme görüntüsünü oluşturma ve önyükleme yapma sürecini kolaylaştırmak için bir önyükleme yükleyici uzantısı bulunur.

Çekirdek yazılımını yüklemeden başlatmak için:

adb reboot bootloader
fastboot boot Image.lz4-dtb

Bu yöntem kullanıldığında çekirdek aslında yüklenmez ve yeniden başlatma sırasında devam etmez.

Mürekkep Balığı'nda çekirdekleri çalıştırma

Mürekkepbalığı cihazlarında istediğiniz mimaride çekirdek çalıştırabilirsiniz.

Cuttlefish cihazını belirli bir çekirdek yapıları kümesiyle başlatmak için cvd create komutunu, parametre olarak hedef çekirdek yapılarını kullanarak çalıştırın. Aşağıdaki örnek komut, common-android14-6.1 çekirdek manifestinden bir arm64 hedefi için çekirdek yapılarını kullanır.

cvd create \
    -kernel_path=/$PATH/$TO/common-android14-6.1/out/android14-6.1/dist/Image \
    -initramfs_path=/$PATH/$TO/common-android14-6.1/out/android14-6.1/dist/initramfs.img

Daha fazla bilgi için Cuttlefish'te çekirdek geliştirme başlıklı makaleyi inceleyin.

Çekirdek derlemesini özelleştirme

Kleaf derlemeleri için çekirdek derlemelerini özelleştirmek isterseniz Kleaf dokümanlarına bakın.

build.sh ile çekirdek derlemesini özelleştirme (eski)

build/build.sh için derleme süreci ve sonucu, ortam değişkenlerinden etkilenebilir. Bunların çoğu isteğe bağlıdır ve her çekirdek dalında uygun bir varsayılan yapılandırma olmalıdır. En sık kullanılanlar burada listelenmiştir. Tam (ve güncel) liste için build/build.sh bölümüne bakın.

Yerel derlemeler için özel çekirdek yapılandırması

Android 14 ve sonraki sürümlerde, çekirdek yapılandırmalarını özelleştirmek için defconfig parçalarını kullanabilirsiniz. Defconfig parçalarıyla ilgili Kleaf belgelerine bakın.

Derleme yapılandırmaları içeren yerel derlemeler için özel çekirdek yapılandırması (eski)

Android 13 ve önceki sürümlerde aşağıdakileri görebilirsiniz.

Bir çekirdek yapılandırma seçeneğini düzenli olarak değiştirmeniz gerekiyorsa (ör. bir özellik üzerinde çalışırken) veya bir seçeneğin geliştirme amacıyla ayarlanması gerekiyorsa derleme yapılandırmasını yerel olarak değiştirerek ya da kopyalayarak bu esnekliğe ulaşabilirsiniz.

POST_DEFCONFIG_CMDS değişkenini, normal make defconfig adımı tamamlandıktan hemen sonra değerlendirilen bir ifadeye ayarlayın. build.config dosyaları derleme ortamına kaynak olarak alındığından, build.config'te tanımlanan işlevler, defconfig sonrası komutların bir parçası olarak çağrılabilir.

Bunun yaygın bir örneği, geliştirme sırasında çapraz noktalı çekirdekler için bağlantı zamanı optimizasyonunu (LTO) devre dışı bırakmaktır. LTO, yayınlanan çekirdekler için yararlı olsa da derleme Yerel build.config'e eklenen aşağıdaki snippet, build/build.sh kullanıldığında LTO'yu kalıcı olarak devre dışı bırakır.

POST_DEFCONFIG_CMDS="check_defconfig && update_debug_config"
function update_debug_config() {
    ${KERNEL_DIR}/scripts/config --file ${OUT_DIR}/.config \
         -d LTO \
         -d LTO_CLANG \
         -d CFI \
         -d CFI_PERMISSIVE \
         -d CFI_CLANG
    (cd ${OUT_DIR} && \
     make O=${OUT_DIR} $archsubarch CC=${CC} CROSS_COMPILE=${CROSS_COMPILE} olddefconfig)
}

Çekirdek sürümlerini belirleme

Derlenecek doğru sürümü iki kaynaktan belirleyebilirsiniz: AOSP ağacı ve sistem görüntüsü.

AOSP ağacındaki çekirdek sürümü

AOSP ağacı, önceden derlenmiş çekirdek sürümlerini içerir. git günlüğünde, doğru sürüm, kaydetme mesajının bir parçası olarak gösterilir:

cd $AOSP/device/VENDOR/NAME
git log --max-count=1

Çekirdek sürümü git günlüklerinde listelenmiyorsa aşağıda açıklandığı gibi sistem görüntüsünden alın.

Sistem görüntüsünden çekirdek sürümü

Bir sistem görüntüsünde kullanılan çekirdek sürümünü belirlemek için çekirdek dosyasında aşağıdaki komutu çalıştırın:

file kernel

Image.lz4-dtb dosyaları için:

grep -a 'Linux version' Image.lz4-dtb

Başlatma görüntüsü oluşturma

Çekirdek derleme ortamını kullanarak önyükleme görüntüsü oluşturabilirsiniz.

init_boot içeren cihazlar için önyükleme resmi oluşturma

init_boot bölümü olan cihazlarda, önyükleme görüntüsü çekirdekle birlikte oluşturulur. initramfs resmi, önyükleme resmine yerleştirilmemiştir.

Örneğin, Kleaf ile GKI önyükleme görüntüsünü aşağıdakilerle oluşturabilirsiniz:

tools/bazel run //common:kernel_aarch64_dist [-- --destdir=$DIST_DIR]

build/build.sh (eski) ile GKI önyükleme görüntüsünü şu şekilde oluşturabilirsiniz:

BUILD_CONFIG=common/build.config.gki.aarch64 build/build.sh

GKI önyükleme görüntüsü $DIST_DIR konumundadır.

init_boot (eski) olmayan cihazlar için önyükleme resmi oluşturma

init_boot bölümü olmayan cihazlarda bir ramdisk ikilisine ihtiyacınız vardır. Bu ikiliyi, GKI önyükleme görüntüsünü indirerek ve açarak elde edebilirsiniz. İlişkili Android sürümünden herhangi bir GKI önyükleme resmi kullanılabilir.

tools/mkbootimg/unpack_bootimg.py --boot_img=boot-5.4-gz.img
mv $KERNEL_ROOT/out/ramdisk gki-ramdisk.lz4

Hedef klasör, çekirdek ağacının üst düzey dizinidir (mevcut çalışma dizini).

En son AOSP sürüm dalını kullanıyorsanız bunun yerine ci.android.com adresindeki bir aosp_arm64 derlemesinden ramdisk-recovery.img derleme yapısını indirebilir ve ramdisk ikili dosyanız olarak kullanabilirsiniz.

Bir ramdisk ikili dosyanız olduğunda ve bu dosyayı çekirdek derlemesinin kök dizininde gki-ramdisk.lz4 konumuna kopyaladığınızda aşağıdaki komutu yürüterek bir önyükleme görüntüsü oluşturabilirsiniz:

BUILD_BOOT_IMG=1 SKIP_VENDOR_BOOT=1 KERNEL_BINARY=Image GKI_RAMDISK_PREBUILT_BINARY=gki-ramdisk.lz4 BUILD_CONFIG=common/build.config.gki.aarch64 build/build.sh

x86 tabanlı mimariyle çalışıyorsanız Image ifadesini bzImage ile, aarch64 ifadesini ise x86_64 ile değiştirin:

BUILD_BOOT_IMG=1 SKIP_VENDOR_BOOT=1 KERNEL_BINARY=bzImage GKI_RAMDISK_PREBUILT_BINARY=gki-ramdisk.lz4 BUILD_CONFIG=common/build.config.gki.x86_64 build/build.sh

Bu dosya, $KERNEL_ROOT/out/$KERNEL_VERSION/dist yapı dizininde bulunur.

Önyükleme resmi out/<kernel branch>/dist/boot.img adresindedir.