OpenHarmony 2.0 Canary 标准系统的编译流程 原创 精华

OpenHarmony 2.0 Canary 标准系统的编译流程

liangkz 2021.09.08

标准系统的编译入口是代码根目录下的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】