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

คู่มือนี้จะแสดงวิธีการทีละขั้นตอนเกี่ยวกับวิธีดาวน์โหลด คอมไพล์ และแฟลชเคอร์เนล Pixel ที่กําหนดเองสําหรับการพัฒนา GKI ทำให้ตอนนี้คุณสามารถอัปเดตเคอร์เนลแยกจากบิลด์ของแพลตฟอร์ม Android ขั้นตอนเหล่านี้ใช้ได้กับอุปกรณ์ Pixel 6 ขึ้นไปเท่านั้น เนื่องจาก Pixel 5 และอุปกรณ์รุ่นก่อนหน้าต้องอัปเดตโมดูลเคอร์เนลในพาร์ติชัน vendor ซึ่งจะขึ้นอยู่กับบิลด์ของแพลตฟอร์ม Android สำหรับอุปกรณ์เหล่านั้น ตารางสาขาเคอร์เนล Pixel ที่ GKI รองรับประกอบด้วยสาขาไฟล์ Manifest ของที่เก็บเคอร์เนลสำหรับอุปกรณ์ Pixel ที่รองรับ GKI แต่ละรุ่น โปรดดูที่ส่วนเคอร์เนลของ Pixel รุ่นเดิมสำหรับสาขาของไฟล์ Manifest ของเคอร์เนลของ Pixel 5 และรุ่นก่อนหน้า

สาขาเคอร์เนลของ Pixel ที่รองรับ GKI

นอกจากเคอร์เนลที่โรงงานรองรับแล้ว อุปกรณ์ Pixel 6 และ 6 Pro ยังรองรับการพัฒนา GKI เฉพาะในสาขาเคอร์เนล Android Common ที่รวมอยู่ในตารางแพลตฟอร์มและชุดค่าผสมเคอร์เนล Android ของ Pixel 6/6 Pro ที่รองรับเท่านั้น เนื่องจาก UAPI ของผู้ให้บริการมีความแตกต่างระหว่าง HAL และไดรเวอร์เคอร์เนลของแพลตฟอร์ม Android ตารางจึงแสดงชุดค่าผสมบิลด์ที่รองรับ

การรองรับแพลตฟอร์ม Pixel 6/6 Pro สำหรับ Android และการผสมผสานเคอร์เนล

เตรียมอุปกรณ์ Pixel ของคุณให้พร้อม

โฟลว์ชาร์ตต่อไปนี้อธิบายขั้นตอนการอัปเดตเคอร์เนลในอุปกรณ์ Pixel 6 ขึ้นไป

แฟลชอุปกรณ์โดยใช้ flash.android.com

1. ไปที่ flash.android.com
2. เลือกบิลด์ Android ตามชุดค่าผสมแพลตฟอร์มและเคอร์เนล Android ที่รองรับ
3. เลือกตัวเลือกต่อไปนี้
   • ล้างข้อมูลอุปกรณ์
   • บังคับใช้พาร์ติชันทั้งหมดของ Flash
   • ปิดใช้การยืนยัน
4. กดปุ่มติดตั้งบิลด์เพื่อแฟลชอุปกรณ์

ดาวน์โหลดและคอมไพล์เคอร์เนล

ซิงค์ที่เก็บเคอร์เนล

เรียกใช้คำสั่งต่อไปนี้เพื่อดาวน์โหลดซอร์สโค้ดเคอร์เนล โปรดดูตารางชุดค่าผสมที่รองรับสำหรับ Pixel 6/6 Pro และ Kernel สำหรับ Pixel KERNEL_MANIFEST_BRANCH

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

repo sync -c --no-tags

อัปเดต RAMdisk ของผู้ให้บริการ

อัปเดตไฟล์ vendor_ramdisk-DEVICE.img ในที่เก็บข้อมูลเคอร์เนลให้ตรงกับบิลด์แพลตฟอร์ม Android ที่แฟลชในอุปกรณ์ มีตัวเลือกอยู่ 2-3 อย่างที่คุณติดตามได้

ตัวเลือกที่ 1) ดึงอิมเมจ RAM ของผู้ให้บริการจากอิมเมจเริ่มต้นของ Pixel

1. ดาวน์โหลดอิมเมจเริ่มต้นที่รองรับสำหรับอุปกรณ์จาก https://developers.google.com/android/images

2. ดึงข้อมูล vendor_boot.img:

   • คำสั่งต่อไปนี้ใช้ Pixel 6 Pro AP1A.240505.004 เป็นตัวอย่าง แทนที่ชื่อ ZIPfile ด้วยชื่อไฟล์ของอิมเมจเริ่มต้นที่คุณดาวน์โหลด

     unzip raven-ap1a.240505.004-factory-9d783215.zip
   

     cd raven-ap1a.240505.004
   

     unzip image-raven-ap1a.240505.004.zip vendor_boot.img
   

3. คลายการแพคข้อมูล vendor_boot.img เพื่อรับ RAM ของผู้ให้บริการ

     KERNEL_REPO_ROOT/tools/mkbootimg/unpack_bootimg.py --boot_img vendor_boot.img \
         --out vendor_boot_out
   

4. คัดลอกไฟล์ vendor-ramdisk-by-name/ramdisk_ ที่แยกไว้ไปยังที่เก็บเคอร์เนลของ Pixel

   อุปกรณ์	DEVICE_RAMDISK_PATH
   Pixel 6 (ออริโอล) Pixel 6 Pro (นกกาเหว่า)	prebuilts/boot-artifacts/ramdisks/vendor_ramdisk-oriole.img
   Pixel 6a (บลูเจย์)	ส่วนตัว/devices/google/bluejay/vendor_ramdisk-bluejay.img

     cp vendor_boot_out/vendor-ramdisk-by-name/ramdisk_ \
         KERNEL_REPO_ROOT/DEVICE_RAMDISK_PATH
   

ตัวเลือกที่ 2) คัดลอก vendor_ramdisk จากที่เก็บของแพลตฟอร์ม Android ที่สร้างขึ้นในเครื่อง

cp ANDROID_ROOT/out/target/product/DEVICE/vendor_ramdisk-debug.img \
   KERNEL_REPO_ROOT/DEVICE_RAMDISK_PATH/vendor_ramdisk-DEVICE.img

คอมไพล์เคอร์เนล (Kleaf)

ใน Android 13 ระบบได้แทนที่สคริปต์ build.sh ด้วยระบบการสร้างเคอร์เนลใหม่ที่มีชื่อว่า Kleaf สำหรับอุปกรณ์ที่ใช้ android13-5.15 ขึ้นไป ควรสร้างเคอร์เนลโดยใช้ Kleaf

สำหรับ Pixel 6 และ 6 Pro ที่มีเคอร์เนล android14 ขึ้นไป ให้เรียกใช้คำสั่งต่อไปนี้สำหรับการสร้าง Kleaf

tools/bazel run --config=fast --config=stamp //private/google-modules/soc/gs:slider_dist

สำหรับ Pixel 6 และ 6 Pro ที่มีเคอร์เนล android13-5.15 ให้เรียกใช้คำสั่งของบิลด์ Kleaf ดังนี้

tools/bazel run --lto=thin //gs/google-modules/soc-modules:slider_dist

สำหรับเคอร์เนลอื่นๆ ทั้งหมดของ Pixel ให้เรียกใช้สคริปต์ build_DEVICE.sh ที่พบที่ KERNEL_REPO_ROOT ในกรณีส่วนใหญ่ DEVICE ต้องเป็นชื่อโค้ดที่ตรงกับชื่อโค้ดที่ใช้ในคอลัมน์เส้นทางไบนารีในแผนผัง AOSP ของสาขาเคอร์เนลของ Pixel ที่รองรับ GKI ซึ่งอาจเป็นชื่อรหัสของอุปกรณ์ 1 เครื่อง เช่น "akita" (Pixel 8a) หรือชื่อรหัสที่แสดงถึงกลุ่มอุปกรณ์ที่เกี่ยวข้องซึ่งใช้เคอร์เนลเดียวกัน เช่น "caimito" ซึ่งหมายถึง Pixel 9 (tokay), Pixel 9 Pro (caiman) และ Pixel 9 Pro XL (komodo) สำหรับ android14 และรุ่นก่อนหน้า ให้ใช้ build_slider.sh สำหรับ Pixel 6 และ Pixel 6 Pro และใช้ build_cloudripper.sh สำหรับ Pixel 7 และ Pixel 7 Pro

ตัวอย่างเช่น หากต้องการสร้างเคอร์เนลสำหรับ Pixel 6 บน Branch ของ android-gs-raviole-5.10-android14 คุณจะต้องเรียกใช้คำสั่งต่อไปนี้

build_slider.sh

โดยค่าเริ่มต้น สคริปต์ build_DEVICE.sh จะใช้เคอร์เนล GKI ที่สร้างไว้ล่วงหน้าเพื่อเร่งกระบวนการสร้าง หากคุณต้องการแก้ไขเคอร์เนลหลัก ให้กำหนดตัวแปรสภาพแวดล้อม BUILD_AOSP_KERNEL=1 เพื่อสร้างเคอร์เนลจากแหล่งที่มาในเครื่องแทน

ดูรายละเอียดเพิ่มเติมเกี่ยวกับระบบบิลด์เคอร์เนลและวิธีปรับแต่งบิลด์ได้ที่ Kleaf - การสร้างเคอร์เนล Android ด้วย Bazel

แฟลชอิมเมจเคอร์เนล

หมายเหตุ: หากคุณยังไม่ได้ปิดใช้การยืนยัน คุณต้องดำเนินการก่อนที่จะแฟลชเคอร์เนลที่กำหนดเอง คำสั่งที่ใช้ดำเนินการมีดังนี้

fastboot oem disable-verification

คำเตือน: หากคุณแฟลชเคอร์เนลที่กำหนดเองที่ด้านบนของเวอร์ชันแพลตฟอร์ม คุณอาจต้องล้างข้อมูลอุปกรณ์หากมีการดาวน์เกรดระดับแพตช์ความปลอดภัย (SPL) ที่เกี่ยวข้องกับเคอร์เนลใหม่ ขั้นตอนนี้จะลบข้อมูลส่วนตัวของคุณทั้งหมด และอย่าลืมสำรองข้อมูลของคุณ ก่อนล้างข้อมูล

fastboot -w

หากต้องการแฟลชอิมเมจเคอร์เนล ให้เรียกใช้คำสั่ง fastboot flash สำหรับพาร์ติชันเคอร์เนลแต่ละรายการที่ระบุไว้สำหรับอุปกรณ์ สำหรับพาร์ติชันแบบไดนามิก คุณต้องรีบูตเป็นโหมด fastbootd ก่อนที่จะกะพริบ

คำสั่งแฟลชสำหรับ Pixel 6 ใน android-mainline มีดังนี้

fastboot flash boot        out/slider/dist/boot.img
fastboot flash dtbo        out/slider/dist/dtbo.img
fastboot flash vendor_boot out/slider/dist/vendor_boot.img
fastboot reboot fastboot
fastboot flash vendor_dlkm out/slider/dist/vendor_dlkm.img

คุณจะดูอิมเมจเคอร์เนลได้ใน DIST_DIR

หมายเหตุ: หากมีดองเกิลซีเรียลและต้องการเปิดใช้บันทึกซีเรียล คำสั่งจะเป็นดังนี้

fastboot oem uart enable
fastboot oem uart config 3000000

ตัวอย่างคำสั่งสำหรับเชื่อมต่อจากโฮสต์

screen -fn /dev/ttyUSB* 3000000

คืนค่าอิมเมจเริ่มต้น

หากต้องการคืนค่าอุปกรณ์กลับเป็นอิมเมจเริ่มต้น คุณสามารถใช้ flash.android.com

เคอร์เนล Pixel รุ่นเดิม

ตารางสาขาเคอร์เนล Pixel รุ่นเดิมมีไว้เพื่อเป็นข้อมูลอ้างอิงสำหรับสาขาที่เก็บเคอร์เนลของอุปกรณ์ Pixel 5 และรุ่นก่อนหน้า อุปกรณ์เหล่านี้ไม่รองรับ GKI

สาขาเคอร์เนล Pixel รุ่นเดิม