Android 內核編譯刷機無法啟動：Nexus 5 需指定 zImage-dtb

問題現象

按官方流程下載、編譯 Android 內核（Nexus 5 / msm 平台），編譯無錯誤。配置 TARGET_PREBUILT_KERNEL 變量指向 zImage，執行 make bootimage 打包刷入真機，手機無法啟動。疑似 zImage 未被正確打包進 boot.img。

根因分析

Nexus 5 (hammerhead) 採用 Device Tree Blob (DTB) 附加模式，內核映像必須包含設備樹二進制數據。編譯系統生成的真正可啟動映像是 zImage-dtb（即 zImage + dtb 拼接），而非單獨的 zImage。

解決方案

修改編譯配置，指向正確的內核映像文件：

# 錯誤配置
TARGET_PREBUILT_KERNEL := $(KERNEL_OUT)/arch/arm/boot/zImage

# 正確配置（Nexus 5 專用）
TARGET_PREBUILT_KERNEL := $(KERNEL_OUT)/arch/arm/boot/zImage-dtb

重新執行 make bootimage 即可生成可啟動的 boot.img。

背景知識補充

• zImage：壓縮後的內核映像，不含設備樹。
• dtb (Device Tree Blob)：描述硬件拓撲的數據結構，ARM 架構啟動必需。
• zImage-dtb / Image.gz-dtb：內核構建系統自動拼接生成的組合映像，格式為 zImage + dtb，Bootloader 解析時自動分離。
• 不同設備策略不同：
  - 部分舊設備用 zImage + 獨立 dtb 分區。
  - 現代多數設備（如 Nexus 5、Pixel 系列）採用拼接模式。

驗證步驟

1. 編譯後檢查 $(KERNEL_OUT)/arch/arm/boot/ 目錄下是否存在 zImage-dtb。
2. 解包 boot.img（用 unpackbootimg 工具）確認內核載荷大小與 zImage-dtb 一致。
3. 刷入 fastboot flash boot boot.img 觀察啟動日誌（adb logcat / dmesg）。

避坑指南

• 始終參考設備對應的 BoardConfig.mk 確認 TARGET_PREBUILT_KERNEL 應指向的文件名。
• 若自行構建內核（非預構建），設置 TARGET_KERNEL_SOURCE 等變量，構建系統會自動處理 DTB 拼接。
• 刷機前備份原廠 boot.img，以便回滾。

一行配置錯誤導致無法啟動，凸顯了理解 Android 啟動流程與設備樹機制的重要性。