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

系统
打开preloader.py脚本看一下,描述的是如何根据上面的显式参数,以及各种隐式的环境变量参数等,经过判断和组合,一步步生成out/build_configs/目录下的各个配置文件,这些配置文件将作为后继编译步骤的基础参数被使用。

[[424363]]

想了解更多内容,请访问:

51CTO和华为官方合作共建的鸿蒙技术社区

https://harmonyos.51cto.com

标准系统的编译入口是代码根目录下的build.sh,指令是:

./build.sh --product-name Hi3516DV300 --ccache

【1】打开build.sh脚本查看

  1. source_root_dir="${script_path}" 
  2.  
  3. while [[ ! -f "${source_root_dir}/.gn" ]]; do 

这一小段是在build.sh脚本所在目录下找到.gn文件,将其内容添加到当前的编译环境中。

接下来执行tools_checker.py脚本,检查操作系统以及编译依赖工具是否满足需要。

再带参数执行preloader.py脚本:

  1. ${PYTHON3} ${source_root_dir}/build/loader/preloader/preloader.py \ 
  2.  
  3.   --product-name ${product_name} \ 
  4.  
  5.   --source-root-dir ${source_root_dir} \ 
  6.  
  7.   --products-config-dir "productdefine/common/products" \ 
  8.  
  9.   --preloader-output-root-dir "out/build_configs" 

前两个参数分别是产品名字“Hi3516DV300 ”和源代码根目录,第三个参数,是预定义的产品配置表Hi3516DV300.json的存放路径,第四个参数是preloader.py脚本执行的输出目录。

打开preloader.py脚本看一下,描述的是如何根据上面的显式参数,以及各种隐式的环境变量参数等,经过判断和组合,一步步生成out/build_configs/目录下的各个配置文件,这些配置文件将作为后继编译步骤的基础参数被使用。

再接下来就是带参数执行build_standard.sh开始正式编译了

  1. ${source_root_dir}/build/build_scripts/build_${system_type}.sh \ 
  2.  
  3.   --product-name ${product_name} \ 
  4.  
  5.   --device-name ${device_name} \ 
  6.  
  7.   --target-os ${target_os} \ 
  8.  
  9.   --target-cpu ${target_cpu} \ 
  10.  
  11.   ${build_params} 

build_standard.sh执行完了,要么编译成功,要么编译失败。

【2】打开build_standard.sh脚本查看

  1. source ${script_path}/parse_params.sh 
  2.  
  3. system_type="standard" 
  4.  
  5. source ${script_path}/build_common.sh 
  6.  
  7. 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:

  1. 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查看

  1. source ${BUILD_SCRIPT_DIR}/pre_process.sh 
  2.  
  3.    pre_process "$@" 
  4.  
  5.    source ${BUILD_SCRIPT_DIR}/make_main.sh 
  6.  
  7.    do_make "$@" 
  8.  
  9.    source ${BUILD_SCRIPT_DIR}/post_process.sh 
  10.  
  11.    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文件

  1. prepare to save build log 
  2.  
  3. LOG_FILE=${TARGET_OUT_DIR}/build.log 
  4.  
  5. log_prepare $LOG_FILE 
  6.  
  7. log "$@" 

这里生成out/ohos-arm-release/build.log文件,这个文件第一句话就是log "$@"打印出来的执行参数:

  1. 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命令:

  1. source ${BUILD_SCRIPT_DIR}/get_gn_parameters.sh 
  2.  
  3.  get_gn_parameters 
  4.  
  5.  
  6.  
  7.  if [ "${SKIP_GN_PARSE}"x = falsex ]; then 
  8.  
  9.      ${BUILD_TOOLS_DIR}/gn gen ${TARGET_OUT_DIR} \ 
  10.  
  11.          --args="target_os=\"${TARGET_OS}\" target_cpu=\"${TARGET_ARCH}\" is_debug=false \ 
  12.  
  13.          product_name=\"${PRODUCT_NAME}\" \ 
  14.  
  15.          is_component_build=true \ 
  16.  
  17.          ${GN_ARGS} ${TEST_BUILD_PARA_STRING}  ${IS_ASAN} \ 
  18.  
  19.          release_test_suite=${RELEASE_TEST_SUITE}" 2>&1 | tee -a $log 
  20.  
  21.  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/ 目录下的所有内容,详情请自行跟踪和分析一下。

  1. build_loader_script = rebase_path("//build/loader/load.py"
  2.  
  3. load_result = exec_script(build_loader_script, arguments, "string"

【5.3】接下来收集ninja的编译参数,并运行ninja开始编译,根据编译规则生成中间文件和最终的烧录镜像文件,编译过程也全部记录在log中。

  1.   ninja_build_args="--source-root-dir ${BASE_HOME} --root-build-dir ${TARGET_OUT_DIR} \ 
  2.  
  3.             --build-target-name ${BUILD_TARGET_NAME}" 
  4.  
  5.     if [ "${TARGET_PLATFORM}" != "" ];then 
  6.  
  7.         ninja_build_args="$ninja_build_args --target-platform ${TARGET_PLATFORM}" 
  8.  
  9.     fi 
  10.  
  11.     real_build_target=$(python ${BASE_HOME}/build/scripts/build_target_handler.py $ninja_build_args) 
  12.  
  13. ${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

想了解更多内容,请访问:

51CTO和华为官方合作共建的鸿蒙技术社区

https://harmonyos.51cto.com

 

责任编辑:jianghua 来源: 鸿蒙社区
相关推荐

2021-06-28 09:38:50

鸿蒙HarmonyOS应用

2021-07-02 14:16:04

鸿蒙HarmonyOS应用

2021-07-19 15:34:05

鸿蒙HarmonyOS应用

2023-02-01 16:28:30

Linux内核鸿蒙

2021-08-06 15:09:22

鸿蒙HarmonyOS应用

2022-04-02 20:45:04

Hi3516开发板操作系统鸿蒙

2022-10-12 15:14:08

开机动画鸿蒙

2022-09-15 14:56:12

GDB调试鸿蒙

2021-10-09 10:12:39

鸿蒙HarmonyOS应用

2021-11-08 07:19:45

鸿蒙HarmonyOS应用

2023-12-29 08:45:40

Python3.8鸿蒙解释器

2022-06-10 14:37:24

鸿蒙操作系统

2022-09-07 15:08:58

操作系统鸿蒙

2022-09-13 16:10:15

鸿蒙操作系统

2022-09-16 15:01:37

操作系统技术鸿蒙

2022-09-06 15:46:52

speexdsp鸿蒙

2022-09-14 15:28:19

操作系统鸿蒙

2022-09-15 15:21:22

操作系统鸿蒙

2023-06-27 15:12:46

C++三方库移植

2021-08-13 10:09:36

鸿蒙HarmonyOS应用
点赞
收藏

51CTO技术栈公众号