一、腳本整體定位

該腳本是瑞芯微RK3576平臺基于Android 15的自動化構建腳本，整合了UBoot、Kernel（含驅動）、Android系統、OTA包、update.img固件等全流程構建邏輯，是平臺固件編譯的核心入口。開發者掌握該腳本，能精準控制編譯流程、定位編譯失敗點、定制化構建策略（如僅編譯內核/UBoot、調整編譯參數），是RK3576 Android開發調試的核心抓手。

二、腳本核心知識點拆解

1.腳本基礎框架（Shell腳本核心）

?腳本頭聲明：#!/bin/bash聲明腳本使用Bash解釋器執行，是Linux Shell腳本的標準開頭。

?用法函數（usage）：定義腳本參數說明，當傳入非法參數或執行-h/--help（隱式）時打印用法并退出，提升腳本易用性。

?知識點：Shell函數定義、echo輸出格式化、exit退出碼（exit 1表示異常退出）。

2.變量初始化（構建參數預設）

腳本開頭定義了一系列布爾型/字符型變量，作為構建開關和參數容器：

變量名	作用
BUILD_UBOOT	UBoot編譯開關（默認false）
BUILD_KERNEL_WITH_CLANG	內核是否用Clang編譯（默認false）
BUILD_KERNEL	內核編譯開關（默認false）
BUILD_ANDROID	Android系統編譯開關（默認false）
BUILD_UPDATE_IMG	update.img固件打包開關（默認false）
BUILD_OTA	OTA升級包編譯開關（默認false）
BUILD_PACKING	編譯產物歸檔開關（默認false）
KERNEL_DTS	內核設備樹文件名（默認空，后續從環境變量讀?。?/span>
BUILD_JOBS	編譯并行任務數（默認16，控制make -j的并發數）

?知識點：Shell變量賦值、布爾型變量的Shell表達（true/false為字符串，非原生布爾）。

3.命令行參數解析（getopts）

whilegetopts"UCKABpouvV"argdo case$argin    U) BUILD_UBOOT=true;;    C) BUILD_KERNEL=true; BUILD_KERNEL_WITH_CLANG=true;;   # ... 其他參數處理    ?) usage ;;# 非法參數調用usage esacdone

?核心知識點：getopts是Shell內置的參數解析工具，支持短參數（如-U、-K）解析：

?UCKABpouvV中，帶:的字符（如v）表示參數后需跟值（如-v userdebug）；

?case分支匹配參數，實現“參數→變量”的映射；

?非法參數觸發usage函數，保證參數合法性。

4.環境前置檢查與初始化

（1）編譯環境校驗

if[ -z"$TARGET_RELEASE"];then echo"Please lunch your product first! e.g." echo"source build/envsetup.sh" echo"lunch rk3588_u-trunk_staging-userdebug"  (return1 2>/dev/null) ||exit1fi

?知識點：

?[ -z "$VAR" ]檢查變量是否為空；

?TARGET_RELEASE是Android編譯環境的核心變量，需通過lunch命令初始化，腳本強制要求先執行source build/envsetup.sh && lunch，避免環境缺失導致編譯失敗；

?(return 1 2>/dev/null) || exit 1兼容腳本“source執行”和“直接執行”兩種場景（source執行時return，直接執行時exit）。

（2）編譯工具鏈配置

?知識點：

?export設置環境變量，作用于當前Shell及子進程；

?Android編譯對JDK/Clang版本強依賴，腳本固化路徑避免版本錯誤；

?ANDROID_BUILD_TOP是Android源碼頂層路徑，由envsetup.sh定義。

（3）Android編譯變量讀取

BUILD_NUMBER=`get_build_var BUILD_NUMBER`UBOOT_DEFCONFIG=`get_build_var PRODUCT_UBOOT_CONFIG`KERNEL_DEFCONFIG=`get_build_var PRODUCT_KERNEL_CONFIG`

?知識點：

?get_build_var是Android編譯系統的工具函數，用于讀取Android.mk/BoardConfig.mk中定義的變量；

?腳本通過該方式動態獲取產品配置（如UBoot默認配置、內核defconfig），而非硬編碼，適配多產品/多版本。

5.分模塊編譯邏輯

（1）UBoot編譯

if["$BUILD_UBOOT"=true] ;then cdu-boot && make clean && make mrproper && make distclean && make$UBOOT_DEFCONFIG&& ./make.sh &&cd- if[ $? -eq 0 ];then   echo"Build uboot ok!" else   echo"Build uboot failed!"   exit1 fifi

?核心知識點：

?make clean/mrproper/distclean：UBoot編譯清理，逐步清理臨時文件/配置/編譯產物，保證編譯環境干凈；

?make $UBOOT_DEFCONFIG：加載UBoot默認配置（如rk3576_defconfig）；

?./make.sh：瑞芯微定制的UBoot編譯腳本（替代原生make）；

?$? -eq 0：檢查上一條命令的退出碼（0為成功，非0為失?。?，失敗則立即退出腳本，避免無效編譯。

（2）Kernel編譯（含驅動）

①編譯器適配（Clang/GCC）

if["$BUILD_KERNEL_WITH_CLANG"=true] ;then if["$KERNEL_ARCH"="arm64"];then    ADDON_ARGS="CROSS_COMPILE=aarch64-linux-gnu- LLVM=1 LLVM_IAS=1" else    ADDON_ARGS="CC=clang LD=ld.lld" fifi

?知識點：

?ARM64架構內核用Clang編譯時，需指定LLVM=1 LLVM_IAS=1（啟用LLVM匯編器）；

?32位ARM架構直接指定CC=clang LD=ld.lld；

?ADDON_ARGS整合編譯參數，后續傳遞給make，實現參數復用。

②內核主編譯

cd$LOCAL_KERNEL_PATH&& make clean && make$ADDON_ARGSARCH=$KERNEL_ARCH$KERNEL_DEFCONFIG&& make$ADDON_ARGSARCH=$KERNEL_ARCH$KERNEL_DTS.img -j$BUILD_JOBS&&cd-

?知識點：

?$LOCAL_KERNEL_PATH：內核源碼路徑（如kernel-5.10），由PRODUCT_KERNEL_VERSION動態獲??；

?$KERNEL_DTS.img：編譯指定設備樹的內核鏡像（RK平臺內核鏡像與DTS綁定）；

?-j$BUILD_JOBS：并行編譯，默認16線程，可通過-J參數調整，平衡編譯速度與系統負載。

③外設驅動編譯（WiFi/攝像頭）

?WiFi驅動：編譯external/wifi_driver路徑下的驅動，生成.ko文件并剝離調試信息（llvm-strip --strip-debug）；

?攝像頭驅動：編譯hardware/rockchip/rvcam/drivers路徑下的驅動，拷貝到預編譯目錄；

?知識點：內核模塊（.ko）編譯需指定M=$PWD（模塊源碼路徑），依賴內核源碼的編譯環境；llvm-strip剝離調試信息減小文件體積。

（3）Android系統編譯

if["$BUILD_ANDROID"=true] ;then if["$BUILD_OTA"=true] ;then   # OTA包編譯邏輯：make → make dist → mkimage_ab.sh/mkimage.sh else   # 普通編譯：make installclean → make -j$BUILD_JOBS fifi

?核心知識點：

?make installclean：清理out目錄下的臨時產物，保留配置，避免編譯緩存導致的問題；

?make dist：生成OTA包所需的target_files.zip（包含系統分區鏡像）；

?mkimage_ab.sh/mkimage.sh：瑞芯微定制的鏡像打包腳本，區分AB分區（無縫更新）和非AB分區；

?每一步編譯后檢查$?，失敗則退出，保證編譯鏈路的可靠性。

（4）固件打包（update.img/OTA）

① update.img打包

if["$BUILD_UPDATE_IMG"=true] ;then cp-f$IMAGE_PATH/*$PACK_TOOL_DIR/rockdev/Image/ if[[$TARGET_PRODUCT=~"PX30"]];then   cd$PACK_TOOL_DIR/rockdev && ./mkupdate.sh px30 Image # ... 其他平臺適配 fi mv$PACK_TOOL_DIR/rockdev/update.img$IMAGE_PATH/ -ffi

?知識點：

?PACK_TOOL_DIR=RKTools/linux/Linux_Pack_Firmware：瑞芯微官方打包工具路徑；

?mkupdate.sh：根據平臺（PX30/RK356x/RK3576）調用不同的打包邏輯，生成可用于量產的update.img；

?正則匹配[[ $TARGET_PRODUCT =~ "PX30" ]]：適配多產品平臺，提升腳本通用性。

② OTA包打包

?非AB分區：make dist生成target_files.zip →mkimage.sh ota生成OTA.zip；

?AB分區：make dist→mkimage_ab.sh ota生成AB格式OTA包；

?知識點：Android OTA包依賴target_files.zip，包含分區鏡像、升級腳本等，是系統空中升級的核心文件。

（5）編譯產物歸檔（BUILD_PACKING）

if["$BUILD_PACKING"=true] ;then mkdir-p$STUB_PATH/IMAGES/ cp$IMAGE_PATH/*$STUB_PATH/IMAGES/ # 生成補丁/提交清單/編譯命令日志  .repo/repo/repo forall -c"$PROJECT_TOP/device/rockchip/common/gen_patches_body.sh" cpout/commit_id.xml$STUB_PATH/manifest_${DATE}.xmlfi

?知識點：

?STUB_PATH：按“產品_版本_時間”命名歸檔路徑，便于版本追溯；

?repo forall：遍歷所有Git倉庫，執行補丁生成腳本，記錄代碼修改；

?歸檔內容包含鏡像文件、編譯日志、內核配置、Git提交清單，用于版本管理和問題復現。

6.輔助邏輯（路徑/時間/日志）

?路徑格式化：STUB_PATH="$(echo $STUB_PATH | tr '[]' '[]')"將路徑轉為大寫，統一命名規范；

?時間戳：DATE=$(date +%Y%m%d.%H%M)生成時間戳，用于歸檔路徑和版本標識；

?日志輸出：大量echo "-------------------KERNEL_VERSION:$KERNEL_VERSION"輸出關鍵參數，便于編譯過程調試。

三、腳本整體流程圖

四、掌握該腳本對開發調試的意義

1.精準控制編譯流程，提升開發效率

?開發階段無需全量編譯：調試UBoot時僅執行./build.sh -U，調試內核時執行./build.sh -K，調試Android時執行./build.sh -A，避免全量編譯耗時（RK3576全量編譯需1-2小時）；

?自定義編譯參數：通過-J調整并發數（如低配機器執行./build.sh -A -J 8），通過-v指定編譯版本（./build.sh -A -v user），適配不同調試場景。

2.快速定位編譯失敗點

?腳本每一步編譯后檢查$?并輸出日志，失敗時直接退出并打印原因（如“Build kernel failed!”）；

?開發者可根據日志定位失敗模塊：

?UBoot失?。簷z查UBOOT_DEFCONFIG是否正確、u-boot/make.sh是否有語法錯誤；

?Kernel失?。簷z查KERNEL_DTS是否存在、Clang版本是否匹配、驅動編譯依賴；

?Android失?。簷z查lunch命令是否正確、Android源碼是否完整。

3.定制化適配產品需求

?新增產品/版本：修改PRODUCT_KERNEL_DTS/PRODUCT_UBOOT_CONFIG等變量，或在參數解析分支中新增產品適配邏輯；

?定制固件打包：修改BUILD_PACKING邏輯，添加自定義歸檔內容（如新增模塊的編譯產物）；

?適配新編譯工具：調整Clang/JDK路徑，兼容新版編譯鏈（如升級Clang版本時修改clang-r530567為新路徑）。

4.理解RK平臺編譯體系，掌握量產固件制作

?腳本整合了瑞芯微定制工具（[mkupdate.sh](mkupdate.sh)、[pack_resource.sh](pack_resource.sh)）和Android原生編譯邏輯，是RK平臺“源碼→量產固件”的完整鏈路；

?掌握腳本后，可自主制作OTA包、update.img量產固件，適配工廠燒錄/用戶升級場景；

?歸檔邏輯（BUILD_PACKING）便于版本管理，調試時可追溯“某版本固件的編譯參數/代碼提交/內核配置”，快速復現線上問題。

5.適配AB分區/OTA升級等高級特性

?腳本區分AB分區（BOARD_USES_AB_IMAGE）和非AB分區的編譯邏輯，開發者可通過腳本理解Android 15無縫更新（AB OTA）的實現方式；

?掌握OTA包生成流程，可定制升級腳本（如添加分區校驗、預安裝腳本），滿足產品升級需求。

總結

該腳本是RK3576 Android 15平臺的“編譯總控中心”，涵蓋了從環境初始化到固件量產的全流程。開發者掌握其邏輯，不僅能高效調試各模塊（UBoot/Kernel/Android），還能定制化適配產品需求，是RK3576平臺開發調試的核心技能。同時，腳本的模塊化設計、參數解析、錯誤處理等Shell編程技巧，也為嵌入式Linux/Android開發提供了通用參考。

審核編輯 黃宇