การสร้างเมล็ด

หน้านี้มีรายละเอียดขั้นตอนการสร้าง เคอร์เนล แบบกำหนดเองสำหรับอุปกรณ์ Android คำแนะนำเหล่านี้จะแนะนำคุณตลอดกระบวนการเลือกซอร์สที่ถูกต้อง สร้างเคอร์เนล และฝังผลลัพธ์ลงในอิมเมจระบบที่สร้างจาก Android Open Source Project (AOSP)

คุณสามารถรับแหล่งเคอร์เนลล่าสุดได้โดยใช้ Repo ; สร้างโดยไม่ต้องกำหนดค่าเพิ่มเติมโดยเรียกใช้ build/build.sh จากรูทของการชำระเงินต้นทางของคุณ

ดาวน์โหลดแหล่งที่มาและเครื่องมือสร้าง

สำหรับเคอร์เนลล่าสุด ให้ใช้ repo เพื่อดาวน์โหลดซอร์ส เชนเครื่องมือ และสร้างสคริปต์ เคอร์เนลบางตัว (เช่น เคอร์เนล Pixel 3) ต้องการแหล่งที่มาจากที่เก็บ git หลายแห่ง ในขณะที่เคอร์เนลอื่น ๆ (เช่น เคอร์เนลทั่วไป) ต้องการเพียงซอร์สเดียว การใช้วิธี repo ทำให้แน่ใจว่ามีการตั้งค่าไดเร็กทอรีต้นทางที่ถูกต้อง

ดาวน์โหลดแหล่งที่มาสำหรับสาขาที่เหมาะสม:

mkdir android-kernel && cd android-kernel
repo init -u https://android.googlesource.com/kernel/manifest -b BRANCH
repo sync

ตารางต่อไปนี้แสดงชื่อ BRANCH สำหรับเมล็ดที่ใช้ได้ด้วยวิธีนี้

อุปกรณ์ เส้นทางไบนารีในทรี AOSP สาขาซื้อคืน
Pixel 7 (เสือดำ)
Pixel 7 Pro (เสือชีต้า)
อุปกรณ์/google/pantah-เคอร์เนล android-gs-pantah-5.10-android13-d1
Pixel 6a (บลูเจย์) อุปกรณ์/google/bluejay-เคอร์เนล android-gs-bluejay-5.10-android13
Pixel 6 (นกขมิ้น)
Pixel 6 Pro (เรเวน)
อุปกรณ์/google/raviole-เคอร์เนล android-gs-raviole-5.10-android13
Pixel 5a (แบบแท่ง) อุปกรณ์/google/barbet-เคอร์เนล android-msm-barbet-4.19-android13
Pixel 5 (ครีบแดง)
Pixel 4a (5G) (หนาม)
อุปกรณ์/google/redbull-เคอร์เนล android-msm-redbull-4.19-android13.dll
Pixel 4a (ปลาแสงอาทิตย์) device/google/sunfish-kernel android-msm-sunfish-4.14-android13
Pixel 4 (ไฟ)
Pixel 4 XL (ปะการัง)
อุปกรณ์/google/coral-kernel android-msm-ปะการัง-4.14-android13
Pixel 3a (ซาร์โก)
Pixel 3a XL (โบนิโต)
อุปกรณ์/google/bonito-kernel android-msm-bonito-4.9-android12L
Pixel 3 (เส้นสีน้ำเงิน)
Pixel 3 XL (ครอสแฮทช์)
อุปกรณ์/google/crosshatch-เคอร์เนล android-msm-crosshatch-4.9-android12.dll
พิกเซล 2 (ตาล)
Pixel 2 XL (ไทเม็น)
อุปกรณ์/google/wahoo-เคอร์เนล android-msm-wahoo-4.4-android10-qpr3.1
พิกเซล (ปลาเซลฟิช)
Pixel XL (มาร์ลิน)
อุปกรณ์/google/marlin-เคอร์เนล android-msm-marlin-3.18-pie-qpr2.dll
ไฮคีย์960 อุปกรณ์/linaro/hikey-เคอร์เนล ไต่เขา-linaro-หุ่นยนต์-4.14
ไต่เขา-linaro-หุ่นยนต์-4.19
สามัญ-android12-5.4
ทั่วไป-android13-5.10
บีเกิ้ลx15 อุปกรณ์/ti/beagle_x15-เคอร์เนล omap-beagle-x15-android-4.14
omap-beagle-x15-android-4.19
เคอร์เนลทั่วไปของ Android ไม่มีข้อมูล สามัญ-android-4.4
สามัญ-android-4.9
สามัญ-android-4.14
สามัญ-android-4.19
ทั่วไป-android-4.19-เสถียร
สามัญ-android11-5.4
สามัญ-android12-5.4
ทั่วไป-android12-5.10
ทั่วไป-android13-5.10
ทั่วไป-android13-5.15
ทั่วไป-android14-5.15
ทั่วไป android-mainline

สร้างเคอร์เนล

จากนั้นสร้างเคอร์เนลด้วยสิ่งนี้:

build/build.sh

เคอร์เนลไบนารี โมดูล และอิมเมจที่เกี่ยวข้องอยู่ในไดเร็กทอรี out/ BRANCH /dist

สร้างด้วย Bazel (Kleaf)

Android 13 แนะนำการสร้างเคอร์เนลด้วย Bazel แทนที่ build/build.sh

หากต้องการสร้างเคอร์เนล GKI สำหรับสถาปัตยกรรม aarch64 ให้ตรวจสอบสาขา Android Common Kernel ที่ไม่เก่ากว่า Android 13 จากนั้นรันคำสั่งต่อไปนี้:

tools/bazel build //common:kernel_aarch64_dist

หากต้องการสร้างการแจกจ่าย ให้เรียกใช้:

tools/bazel run //common:kernel_aarch64_dist -- --dist_dir=$DIST_DIR

หลังจากนั้นเคอร์เนลไบนารี โมดูล และอิมเมจที่เกี่ยวข้องจะอยู่ใน $DIST_DIR หากไม่ได้ระบุ --dist_dir ให้ดูผลลัพธ์ของคำสั่งสำหรับตำแหน่งของสิ่งประดิษฐ์ สำหรับรายละเอียด โปรดดู เอกสารประกอบเกี่ยวกับ AOSP

สร้างโมดูลผู้ขายสำหรับอุปกรณ์เสมือน

Android 11 เปิดตัว GKI ซึ่งแยกเคอร์เนลออกเป็นอิมเมจเคอร์เนลที่ดูแลโดย Google และโมดูลที่ดูแลโดยผู้ขาย ซึ่งสร้างขึ้นแยกกัน

ตัวอย่างนี้แสดงการกำหนดค่าอิมเมจเคอร์เนล:

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

ตัวอย่างนี้แสดงการกำหนดค่าโมดูล (Cuttlefish และ Emulator):

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

ใน Android 12 Cuttlefish และ Goldfish มาบรรจบกัน ดังนั้นพวกมันจึงใช้เคอร์เนลเดียวกัน: virtual_device หากต้องการสร้างโมดูลของเคอร์เนลนั้น ให้ใช้การกำหนดค่าบิลด์นี้:

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

Android 13 แนะนำการสร้างเคอร์เนลด้วย Bazel (Kleaf) แทนที่ build.sh

ในการสร้างโมดูลของ virtual_device ให้รัน:

tools/bazel build //common-modules/virtual-device:virtual_device_x86_64_dist

หากต้องการสร้างการแจกจ่าย ให้เรียกใช้:

tools/bazel run //common-modules/virtual-device:virtual_device_x86_64_dist -- --dist_dir=$DIST_DIR

สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับการสร้างเมล็ด Android ด้วย Bazel โปรดดู Kleaf - สร้างเมล็ด Android ด้วย Bazel

สำหรับรายละเอียดเกี่ยวกับการรองรับ Kleaf สำหรับแต่ละสถาปัตยกรรม โปรดดู ที่การรองรับ Kleaf สำหรับอุปกรณ์และเคอร์เนล

Kleaf รองรับอุปกรณ์และเคอร์เนล

ตารางต่อไปนี้แสดงรายการการสนับสนุน Kleaf สำหรับเคอร์เนลอุปกรณ์แต่ละรายการ สำหรับอุปกรณ์ที่ไม่อยู่ในรายการ โปรดติดต่อผู้ผลิตอุปกรณ์

อุปกรณ์ สาขาซื้อคืน การสนับสนุน Kleaf รองรับ build/build.sh
เคอร์เนลทั่วไปของ Android
db845c
อุปกรณ์เสมือน (x86_64, arm64)
อุปกรณ์เสมือน (i686, แขน)
ร็อคปี4
สามัญ-android-4.4
สามัญ-android-4.9
สามัญ-android-4.14
สามัญ-android-4.19
ทั่วไป-android-4.19-เสถียร
สามัญ-android11-5.4
สามัญ-android12-5.4
ทั่วไป-android12-5.10
เคอร์เนลทั่วไปของ Android ทั่วไป-android13-5.10
ทั่วไป-android13-5.15
✅(เป็นทางการ) 1
เคอร์เนลทั่วไปของ Android ทั่วไป-android14-5.15
ทั่วไป android-mainline
db845c ทั่วไป-android13-5.10
db845c ทั่วไป-android13-5.15 ✅(เป็นทางการ) 1
db845c ทั่วไป-android14-5.15
ทั่วไป android-mainline
อุปกรณ์เสมือน (x86_64, arm64) ทั่วไป-android13-5.10
ทั่วไป-android13-5.15
✅(เป็นทางการ) 1 ⚠️ (ไม่มีการบำรุงรักษา) 2
อุปกรณ์เสมือน (x86_64, arm64) ทั่วไป-android14-5.15
ทั่วไป android-mainline
อุปกรณ์เสมือน (i686, แขน) ทั่วไป-android13-5.10
ทั่วไป-android13-5.15
อุปกรณ์เสมือน (i686, แขน) ทั่วไป-android14-5.15
ทั่วไป android-mainline
ร็อคปี4 ทั่วไป-android13-5.10
ทั่วไป-android13-5.15
ร็อคปี4 ทั่วไป-android14-5.15
ทั่วไป android-mainline
ไฮคีย์960 ไต่เขา-linaro-หุ่นยนต์-4.14
ไต่เขา-linaro-หุ่นยนต์-4.19
สามัญ-android12-5.4
ทั่วไป-android13-5.10
โมดูล fips140 ทั่วไป-android12-5.10
ทั่วไป-android13-5.10
ทั่วไป-android13-5.15
โมดูล fips140 ทั่วไป-android14-5.15
ทั่วไป android-mainline

1 "เป็นทางการ" หมายความว่านี่เป็นวิธีอย่างเป็นทางการในการสร้างเคอร์เนล แม้ว่าวิธีอื่นอาจใช้ในการสร้างเคอร์เนลได้เช่นกัน

2 "ไม่ได้รับการบำรุงรักษา" หมายความว่าการสร้างเคอร์เนลด้วยวิธีนี้ควรใช้งานได้ แต่วิธีการสร้างไม่ได้รับการทดสอบอย่างต่อเนื่อง มันอาจจะหยุดสร้างในอนาคต ใช้วิธีสร้างแบบ "ทางการ" แทน

เรียกใช้เคอร์เนล

มีหลายวิธีในการเรียกใช้เคอร์เนลที่สร้างขึ้นเอง ต่อไปนี้เป็นวิธีที่ทราบกันดีว่าเหมาะสำหรับสถานการณ์การพัฒนาต่างๆ

การฝังลงในการสร้างอิมเมจของ Android

คัดลอก Image.lz4-dtb ไปยังตำแหน่งไบนารีของเคอร์เนลที่เกี่ยวข้องภายในทรี AOSP และสร้างอิมเมจสำหรับบูตใหม่

อีกทางหนึ่ง กำหนดตัวแปร TARGET_PREBUILT_KERNEL ขณะใช้ make bootimage (หรือบรรทัดคำสั่ง make อื่นๆ ที่สร้าง boot image) ตัวแปรนี้รองรับโดยอุปกรณ์ทั้งหมดเมื่อตั้งค่าผ่าน device/common/populate-new-device.sh ตัวอย่างเช่น:

export TARGET_PREBUILT_KERNEL=DIST_DIR/Image.lz4-dtb

เคอร์เนลที่กะพริบและบูตด้วย fastboot

อุปกรณ์ล่าสุดมีส่วนขยาย bootloader เพื่อปรับปรุงกระบวนการสร้างและบูตอิมเมจสำหรับบูต

ในการบู๊ตเคอร์เนลโดยไม่กระพริบ:

adb reboot bootloader
fastboot boot Image.lz4-dtb

เมื่อใช้วิธีนี้ เคอร์เนลจะไม่ถูกแฟลช และจะไม่คงอยู่ตลอดการรีบูต

ปรับแต่งการสร้างเคอร์เนล

หากต้องการปรับแต่งการสร้างเคอร์เนลสำหรับรุ่น Kleaf โปรดดู ที่เอกสารประกอบ ของ Kleaf

สำหรับ build/build.sh กระบวนการสร้างและผลลัพธ์สามารถได้รับอิทธิพลจากตัวแปรสภาพแวดล้อม ส่วนใหญ่เป็นทางเลือกและแต่ละสาขาของเคอร์เนลควรมาพร้อมกับการกำหนดค่าเริ่มต้นที่เหมาะสม รายการที่ใช้บ่อยที่สุดแสดงไว้ที่นี่ สำหรับรายการที่สมบูรณ์ (และเป็นปัจจุบัน) โปรดดูที่ build/build.sh

ตัวแปรสภาพแวดล้อม คำอธิบาย ตัวอย่าง
BUILD_CONFIG สร้างไฟล์คอนฟิกจากตำแหน่งที่คุณเริ่มต้นสภาพแวดล้อมบิลด์ ต้องกำหนดตำแหน่งที่สัมพันธ์กับไดเร็กทอรีรูทของ Repo เริ่มต้นเป็น build.config
จำเป็นสำหรับเมล็ดทั่วไป
BUILD_CONFIG=common/build.config.gki.aarch64
CC แทนที่คอมไพเลอร์ที่จะใช้ ถอยกลับไปสู่คอมไพเลอร์เริ่มต้นที่กำหนดโดย build.config CC=clang
DIST_DIR ไดเร็กทอรีเอาต์พุตพื้นฐานสำหรับการกระจายเคอร์เนล DIST_DIR=/path/to/my/dist
OUT_DIR ไดเร็กทอรีเอาต์พุตพื้นฐานสำหรับการสร้างเคอร์เนล OUT_DIR=/path/to/my/out
SKIP_DEFCONFIG ข้าม make defconfig SKIP_DEFCONFIG=1
SKIP_MRPROPER ข้าม make mrproper SKIP_MRPROPER=1

การกำหนดค่าเคอร์เนลแบบกำหนดเองสำหรับบิลด์ในเครื่อง

หากคุณจำเป็นต้องเปลี่ยนตัวเลือกการกำหนดค่าเคอร์เนลเป็นประจำ เช่น เมื่อทำงานกับคุณลักษณะ หรือหากคุณต้องการตั้งค่าตัวเลือกเพื่อวัตถุประสงค์ในการพัฒนา คุณสามารถบรรลุความยืดหยุ่นดังกล่าวได้โดยการบำรุงรักษาการปรับเปลี่ยนในเครื่องหรือคัดลอกการกำหนดค่าบิลด์

ตั้งค่าตัวแปร POST_DEFCONFIG_CMDS เป็นคำสั่งที่ได้รับการประเมินทันทีหลังจากขั้นตอน make defconfig ตามปกติเสร็จสิ้น เนื่องจากไฟล์ build.config มาจากสภาพแวดล้อมของ build ฟังก์ชันที่กำหนดใน build.config สามารถถูกเรียกเป็นส่วนหนึ่งของคำสั่ง post-defconfig

ตัวอย่างทั่วไปคือการปิดใช้งานการเพิ่มประสิทธิภาพเวลาลิงก์ (LTO) สำหรับเมล็ดครอสแฮทช์ระหว่างการพัฒนา แม้ว่า LTO จะเป็นประโยชน์สำหรับเคอร์เนลที่เผยแพร่ แต่ค่าโสหุ้ยในขณะสร้างอาจมีนัยสำคัญ ข้อมูลโค้ดต่อไปนี้ที่เพิ่มไปยัง build.config ในเครื่องจะปิดใช้งาน LTO อย่างต่อเนื่องเมื่อใช้ build/build.sh

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)
}

การระบุเวอร์ชันของเคอร์เนล

คุณสามารถระบุเวอร์ชันที่ถูกต้องในการสร้างได้จากสองแหล่ง: แผนผัง AOSP และอิมเมจระบบ

เวอร์ชันเคอร์เนลจากทรี AOSP

ต้นไม้ AOSP มีเวอร์ชันเคอร์เนลที่สร้างไว้ล่วงหน้า บันทึก git เปิดเผยเวอร์ชันที่ถูกต้องซึ่งเป็นส่วนหนึ่งของข้อความยืนยัน:

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

ถ้าเวอร์ชันเคอร์เนลไม่อยู่ในบันทึก git ให้ดาวน์โหลดจากอิมเมจระบบตามที่อธิบายด้านล่าง

เวอร์ชันเคอร์เนลจากอิมเมจระบบ

หากต้องการตรวจสอบเวอร์ชันเคอร์เนลที่ใช้ในอิมเมจระบบ ให้รันคำสั่งต่อไปนี้กับไฟล์เคอร์เนล:

file kernel

สำหรับไฟล์ Image.lz4-dtb ให้รัน:

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

สร้างอิมเมจสำหรับบูต

เป็นไปได้ที่จะสร้างอิมเมจสำหรับบูตโดยใช้สภาพแวดล้อมการสร้างเคอร์เนล ในการทำเช่นนี้ คุณต้องมีไบนารี ramdisk ซึ่งคุณสามารถหาได้จากการดาวน์โหลดอิมเมจสำหรับบูต GKI และแกะมันออก อิมเมจสำหรับบูต GKI ใดๆ จากรุ่น Android ที่เกี่ยวข้องจะใช้งานได้

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

โฟลเดอร์เป้าหมายคือไดเร็กทอรีระดับบนสุดของเคอร์เนลทรี (ไดเร็กทอรีการทำงานปัจจุบัน)

หากคุณกำลังพัฒนาด้วย AOSP master คุณสามารถดาวน์โหลด ramdisk-recovery.img build artifact จาก aosp_arm64 build บน ci.android.com และใช้เป็นไบนารี ramdisk ของคุณ

เมื่อคุณมีไบนารี ramdisk และคัดลอกไปยัง gki-ramdisk.lz4 ในไดเร็กทอรีรากของบิลด์เคอร์เนล คุณสามารถสร้างอิมเมจสำหรับบูตโดยดำเนินการ:

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 ให้แทนที่ Image ด้วย bzImage และ aarch64 ด้วย x86_64 :

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

ไฟล์นั้นอยู่ในไดเร็กทอรีสิ่งประดิษฐ์ $KERNEL_ROOT/out/$KERNEL_VERSION/dist

อิมเมจสำหรับบูตอยู่ที่ out/<kernel branch>/dist/boot.img