Android 原始碼樹 (AOSP/廠商代碼) 巨大,全量編譯動輒數小時。掌握**模組級增量編譯命令**可將修改驗證縮短至分鐘級。本文基於 MediaTek (MTK) 平台常見 mk 腳本環境 (如 alps/ 目錄結構)。
# 進入源碼根目錄
cd alps
# 載入環境變數 (每次新終端需執行)
source build/envsetup.sh
# 選擇產品 (如 full_k6789v1_64_bsp)
lunch full_k6789v1_64_bsp-userdebug
# 或直接指定
export TARGET_PRODUCT=full_k6789v1_64_bsp
export TARGET_BUILD_VARIANT=userdebug
| 修改範圍 | 增量編譯命令 | 關鍵輸出產物 | 典型源碼路徑 (MTK) |
|---|---|---|---|
| Kernel (內核、驅動、DTS) | ./mk n kernel → ./mk bootimage | boot.img (kernel + ramdisk) | kernel-4.19/, mediatek/kernel/, mediatek/custom/$PROJECT/kernel/ |
| Preloader (預載入器) | ./mk n pl | preloader_*.bin | mediatek/preloader/, mediatek/custom/$PROJECT/preloader/ |
| U-Boot (二級引導) | ./mk uboot | uboot.bin, lk.bin | bootable/bootloader/uboot/, mediatek/custom/$PROJECT/uboot/ |
| System (Framework、App、HAL、Library) | ./mk systemimage | system.img | frameworks/, packages/, hardware/, vendor/, system/ |
| Recovery (恢復模式) | ./mk recoveryimage | recovery.img | bootable/recovery/, mediatek/custom/$PROJECT/recovery/ |
| Factory (工廠模式/測試) | ./mk factoryimage | factory.img | mediatek/custom/$PROJECT/factory/, mediatek/source/factory/ |
| Secro (安全區/加密分區) | ./mk secroimage | secro.img | mediatek/source/secro/, mediatek/custom/$PROJECT/secro/ |
| KP_PROD (關鍵分區產品配置) | ./restproj | 相關配置二進制 | KP_PROD/K233_XX/ |
./mk n kernel:n 表示 new (增量);r 可選,表示 remake (強制重編內核模組)。./mk bootimage:將編譯好的 kernel + ramdisk 打包成 boot.img,**內核修改後必須執行**。./mk systemimage:增量編譯所有 Java/C++ 模組並打包 system.img,依賴 soong/ninja 增量構建,速度極快。./mk -j$(nproc) systemimage (預設通常已啟用最大並行)。# 修改 frameworks/base/... 或 packages/apps/Settings/...
./mk systemimage # 增量編譯 + 打包 system.img
fastboot flash system system.img # 刷入設備 (需解鎖 BL)
# 或 adb remount + adb sync system (已 root、system 可寫)
# 修改 kernel-4.19/drivers/... 或 mediatek/custom/$PROJECT/kernel/dts/
./mk n kernel
./mk bootimage
fastboot flash boot boot.img
# 修改 bootable/bootloader/uboot/... 或 mediatek/custom/$PROJECT/uboot/
./mk uboot
fastboot flash bootloader uboot.bin # 或 lk.bin,視分區名
export USE_CCACHE=1 && ccache -M 50G,C/C++ 編譯緩存,二次編譯提速 3-5 倍。mma (當前目錄模組)、mmma path/to/module (指定模組) — 僅編譯該模組及依賴,**不打包映像**,極快驗證代碼邏輯。mmm frameworks/base/services/core/java/com/android/server/am/ActivityManagerService.java (Make 時代);Soong 時代直接 m ModuleName。out/target/product/$PROJECT/
├── boot.img # kernel + ramdisk
├── system.img # 系統分區
├── recovery.img # 恢復分區
├── preloader_*.bin # 預載入器
├── uboot.bin / lk.bin # U-Boot / Little Kernel
├── factory.img # 工廠分區
├── secro.img # 安全分區
└── obj/ # 中間產物 (.o, .class, .jar, .so)
Android.bp/Android.mk (新增/刪除模組、依賴) 後,建議執行 ./mk systemimage 完整增量,單模組命令可能漏掉依賴更新。fastboot flash partition file.img),刷錯分區會導致磚機。./mk target-files-package → sign_target_files_apks → img_from_target_files 產出正式釋放包。