标准系统的编译入口是代码根目录下的build.sh,指令是:
./build.sh --product-name Hi3516DV300 --ccache
【1】打开build.sh脚本查看
- source_root_dir="${script_path}"
- while [[ ! -f "${source_root_dir}/.gn" ]]; do
这一小段是在build.sh脚本所在目录下找到.gn文件,将其内容添加到当前的编译环境中。
接下来执行tools_checker.py脚本,检查操作系统以及编译依赖工具是否满足需要。
再带参数执行preloader.py脚本:
- ${PYTHON3} ${source_root_dir}/build/loader/preloader/preloader.py \
- --product-name ${product_name} \
- --source-root-dir ${source_root_dir} \
- --products-config-dir "productdefine/common/products" \
- --preloader-output-root-dir "out/build_configs"
前两个参数分别是产品名字“Hi3516DV300 ”和源代码根目录,第三个参数,是预定义的产品配置表Hi3516DV300.json的存放路径,第四个参数是preloader.py脚本执行的输出目录。
打开preloader.py脚本看一下,描述的是如何根据上面的显式参数,以及各种隐式的环境变量参数等,经过判断和组合,一步步生成out/build_configs/目录下的各个配置文件,这些配置文件将作为后继编译步骤的基础参数被使用。
再接下来就是带参数执行build_standard.sh开始正式编译了
- ${source_root_dir}/build/build_scripts/build_${system_type}.sh \
- --product-name ${product_name} \
- --device-name ${device_name} \
- --target-os ${target_os} \
- --target-cpu ${target_cpu} \
- ${build_params}
build_standard.sh执行完了,要么编译成功,要么编译失败。
【2】打开build_standard.sh脚本查看
- source ${script_path}/parse_params.sh
- system_type="standard"
- source ${script_path}/build_common.sh
- do_make_ohos
分别是用parse_params.sh分析参数,将build_common.sh引入并执行其中的do_make_ohos()函数。
【3】打开build_common.sh查看do_make_ohos()
也只做了一件事,为build_ohos.sh收集一组参数,最后执行build_ohos.sh:
- build_ohos_cmd: build/build_scripts/build_ohos.sh product_name=Hi3516DV300 target_os=ohos target_cpu=arm gn_args=is_standard_system=true build_target=images
【4】打开build_ohos.sh查看
- source ${BUILD_SCRIPT_DIR}/pre_process.sh
- pre_process "$@"
- source ${BUILD_SCRIPT_DIR}/make_main.sh
- do_make "$@"
- source ${BUILD_SCRIPT_DIR}/post_process.sh
- post_process "$@"
分三步走:
【4.1】引入//build/core/build_scripts/pre_process.sh并执行pre_process(),主要是参数的分析和处理。
【4.2】引入//build/core/build_scripts/make_main.sh并执行do_make(),这里才是真正的编译主体,包括了生成build.log、gn、ninja等具体的编译步骤。
【4.3】引入//build/core/build_scripts/post_process.sh并执行post_process(),这是完成编译后的收尾处理,或者操作“CTRL+C”中断编译的后期处理,包括了计算编译时间,更新pycache/ccache状态,统计并打印编译数据等。
【5】打开make_main.sh查看,也可分为三步:
【5.1】生成build.log文件
- # prepare to save build log
- LOG_FILE=${TARGET_OUT_DIR}/build.log
- log_prepare $LOG_FILE
- log "$@"
这里生成out/ohos-arm-release/build.log文件,这个文件第一句话就是log "$@"打印出来的执行参数:
- product_name=Hi3516DV300 target_os=ohos target_cpu=arm gn_args=is_standard_system=true build_target=images
在此之前,所有脚本的执行信息,都是echo到终端上显示而已,并不会记录到这个log中。
【5.2】接下来引入get_gn_parameters.sh并执行get_gn_parameters()来收集一组参数,并执行gn gen命令:
- source ${BUILD_SCRIPT_DIR}/get_gn_parameters.sh
- get_gn_parameters
- if [ "${SKIP_GN_PARSE}"x = falsex ]; then
- ${BUILD_TOOLS_DIR}/gn gen ${TARGET_OUT_DIR} \
- --args="target_os=\"${TARGET_OS}\" target_cpu=\"${TARGET_ARCH}\" is_debug=false \
- product_name=\"${PRODUCT_NAME}\" \
- is_component_build=true \
- ${GN_ARGS} ${TEST_BUILD_PARA_STRING} ${IS_ASAN} \
- release_test_suite=${RELEASE_TEST_SUITE}" 2>&1 | tee -a $log
- fi
执行gn gen命令,将会按.gn文件的root = "//build/core/gn" 参数,将//build/core/gn/BUILD.gn文件作为编译入口,从此开始进入相关依赖关系的递归查找和执行BUILD.gn,最终在out目录相应的地方生成ninja文件。
//build/core/gn/BUILD.gn 引入load.py并执行它,做了非常多的重要工作,生成//out/ohos-arm-release/build_configs/ 目录下的所有内容,详情请自行跟踪和分析一下。
- build_loader_script = rebase_path("//build/loader/load.py")
- load_result = exec_script(build_loader_script, arguments, "string")
【5.3】接下来收集ninja的编译参数,并运行ninja开始编译,根据编译规则生成中间文件和最终的烧录镜像文件,编译过程也全部记录在log中。
- ninja_build_args="--source-root-dir ${BASE_HOME} --root-build-dir ${TARGET_OUT_DIR} \
- --build-target-name ${BUILD_TARGET_NAME}"
- if [ "${TARGET_PLATFORM}" != "" ];then
- ninja_build_args="$ninja_build_args --target-platform ${TARGET_PLATFORM}"
- fi
- real_build_target=$(python ${BASE_HOME}/build/scripts/build_target_handler.py $ninja_build_args)
- ${BUILD_TOOLS_DIR}/ninja -d keepdepfile -C ${TARGET_OUT_DIR} ${real_build_target} ${NINJA_ARGS} 2>&1 | tee -a $log
Ninja执行完毕,编译也就完成了,执行【4.3】//build/core/build_scripts/post_process.sh完成编译的后期处理。
【附件是经过处理的部分编译的log】
https://harmonyos.51cto.com/resource/1204