编译系统介绍
编译构建流程
编译构建系统是一个基于gn和ninja的组件化构建系统,支持按组件配置、裁剪和拼装,按需构建出定制化的产品。编译构建流程如下:
-
编译命令解析:主要包括产品名称、编译类型(debug/release)、是否单组件编译、指定编译器等。
说明: 编译类型debug选项涉及到XTS的测试用例是否参与编译;release选项会移除最后编译生成文件的符号表、调试信息等
-
读取产品配置:读取解决方案厂商的产品配置文件vendor/my_company/my_product.json文件,主要包括开发板、内核类型、内核版本和配置的组件。
-
gn生成ninja文件:根据产品的配置解析结果,按对应的编译工具链将所选组件加入编译,配置全局的编译选项。
-
执行ninja启动编译:组件逐个编译和链接。
gn语法和基础知识请参见官方快速入门。
编译构建适配流程
首先,创建开发板目录,以芯片厂商realtek的“rtl8720“开发板为例,需创建device/realtek/rtl8720目录。编译相关的适配步骤如下:
-
编译工具链和编译选项配置。
构建系统默认使用ohos-clang编译工具链,也支持芯片厂商按开发板自定义配置。开发板编译配置文件编译相关的变量如下:
-
kernel_type: 开发板使用的内核类型,例如:"liteos_a", "liteos_m", "linux"。
-
kernel_version: 开发使用的内核版本,例如:"4.19"。
-
board_cpu: 开发板CPU类型,例如:"cortex-a7", "riscv32"。
-
board_arch: 开发芯片arch, 例如: "armv7-a", "rv32imac"。
-
board_toolchain: 开发板自定义的编译工具链名称,例如:"gcc-arm-none-eabi"。若为空,则使用默认为ohos-clang。
-
board_toolchain_prefix:编译工具链前缀,例如:"gcc-arm-none-eabi"。
-
board_toolchain_type:编译工具链类型,目前支持gcc和clang。例如:"gcc" ,"clang"。
-
board_cflags:开发板配置的c文件编译选项。
-
board_cxx_flags:开发板配置的cpp文件编译选项。
-
board_ld_flags:开发板配置的链接选项。
编译构建会按产品的选择的开发板,加载对应的config.gni,该文件中变量对系统组件全局可见。
以芯片厂商realtek的“rtl8720“开发板为例,device/realtek/rtl8720/liteos_m/config.gni的内容如下:
# Kernel type, e.g. "linux", "liteos_a", "liteos_m". kernel_type = "liteos_m" # Kernel version. kernel_version = "3.0.0" # Board CPU type, e.g. "cortex-a7", "riscv32". board_cpu = "real-m300" # Board arch, e.g. "armv7-a", "rv32imac". board_arch = "" # Toolchain name used for system compiling. # E.g. gcc-arm-none-eabi, arm-linux-harmonyeabi-gcc, ohos-clang, riscv32-unknown-elf. # Note: The default toolchain is "ohos-clang". It's not mandatory if you use the default toochain. board_toolchain = "gcc-arm-none-eabi" # The toolchain path instatlled, it's not mandatory if you have added toolchian path to your ~/.bashrc. board_toolchain_path = rebase_path("//prebuilts/gcc/linux-x86/arm/gcc-arm-none-eabi/bin", root_build_dir) # Compiler prefix. board_toolchain_prefix = "gcc-arm-none-eabi-" # Compiler type, "gcc" or "clang". board_toolchain_type = "gcc" # Board related common compile flags. board_cflags = [] board_cxx_flags = [] board_ld_flags = []
-
-
开发板编译脚本。
新增的开发板,对应目录下需要新增BUILD.gn文件作为开发板编译的总入口。以芯片厂商realtek的rtl8720开发板为例,对应的device/realtek/rtl8720/BUILD.gn为:
group("rtl8720") { ... }
-
编译调试开发板。
-
任意目录执行hb set按提示设置源码路径和要编译的产品。
-
在开发板目录下执行hb build, 即可启动开发板的编译。
-
-
编译调试产品
将开发板和组件信息写入产品配置文件,该配置文件字段说明如下:
- product_name:产品名称,支持自定义,建议与vendor下的三级目录名称一致。
- ohos_version:OpenHarmony版本号,应与实际下载的版本一致。
- device_company:芯片解决方案厂商名称,建议与device的二级目录名称一致。
- board:开发板名称,建议与device的三级级目录名称一致。
- kernel_type:内核类型,应与开发板支持的内核类型匹配。
- kernel_version:内核版本号,应与开发板支持的内核版本匹配。
- subsystem:产品选择的子系统,应为OS支持的子系统,OS支持的子系统请见build/lite/components目录下的各子系统描述文件。
- components:产品选择的某个子系统下的组件,应为某个子系统支持的组件,子系统支持的组件请见build/lite/components/子系统.json文件。
- features:产品配置的某个组件的特性,组件支持的特性请见build/lite/components/子系统.json中对应组件的features字段。
以基于“rtl8720“开发板的wifiiot模组为例,vendor/my_company/wifiiot/config.json如下:
{ "product_name": "wifiiot", # 产品名称 "ohos_version": "OpenHarmony 1.0", # 使用的OS版本 "device_company": "realtek", # 芯片解决方案厂商名称 "board": "rtl8720", # 开发板名称 "kernel_type": "liteos_m", # 选择的内核类型 "kernel_version": "3.0.0", # 选择的内核版本 "subsystems": [ { "subsystem": "kernel", # 选择的子系统 "components": [ { "component": "liteos_m", "features":[] } # 选择的组件和组件特性 ] }, ... { 更多子系统和组件 } ] }