1# 编译构建 2 3## 编译环境搭建 4 5首先请搭建OpenHarmony基础环境，相关操作请参考[快速入门环境搭建章节](../quick-start/quickstart-overview.md)。用户态和LiteOS-A的内核态编译均使用llvm编译器编译，安装方法在搭建基础环境中已提供。若选择移植linux内核，请执行如下命令安装gcc-arm-linux-gnueabi交叉编译工具链，用于编译linux内核态镜像： 6 7 8``` 9sudo apt-get install gcc-arm-linux-gnueabi 10``` 11 12 13## 编译构建系统介绍 14 15编译构建流程、编译脚本编写、目录规则、独立编译单个组件、独立编译芯片解决方案等介绍请见[编译构建子系统介绍](../subsystems/subsys-build-all.md)。 16 17 18## 新建芯片解决方案 19 20了解编译框架和搭建完编译环境后，请参考如下步骤新建芯片解决方案： 21 221. 新建目录 23 芯片解决方案的目录规则为：device/{芯片解决方案厂商}/{开发板}。以海思的hispark_taurus开发板为例，在代码根目录执行如下命令建立目录： 24 25 26 ``` 27 mkdir -p device/hisilicon/hispark_taurus 28 ``` 29 30 芯片解决方案目录树的规则如下： 31 32 33 ``` 34 device 35 └── company # 芯片解决方案厂商 36 └── board # 开发板名称 37 ├── BUILD.gn # 编译脚本 38 ├── hals # OS南向接口适配 39 ├── linux # 可选，linux内核版本 40 │ └── config.gni # linux版本编译配置 41 └── liteos_a # 可选，liteos内核版本 42 └── config.gni # liteos_a版本编译配置 43 ``` 44 45 以hispark_taurus移植linux内核为例，目录树应该如下： 46 47 48 ``` 49 device 50 └── hisilicon 51 └── hispark_taurus 52 ├── BUILD.gn 53 ├── hals 54 ├── ...... 55 └── linux 56 └── config.gni 57 ``` 58 59 目录树建立后开发板相关的源码放到hispark_taurus目录下。 60 612. 配置开发板编译选项 62 步骤1中的config.gni可配置开发板相关的编译选项，编译构建框架将会遵照该配置文件中的参数编译所有用户态OS组件。其中关键的字段说明如下： 63 64 65 ``` 66 kernel_type: 开发板使用的内核类型，例如：“liteos_a”, “liteos_m”, “linux”。 67 kernel_version: 开发板使用的内核版本，例如：“4.19”。 68 board_cpu: 开发板CPU类型，例如：“cortex-a7”, “riscv32”。 69 board_arch: 开发板芯片arch, 例如： “armv7-a”, “rv32imac”。 70 board_toolchain: 开发板自定义的编译工具链名称，例如：“gcc-arm-none-eabi”。若为空，则使用默认为ohos-clang。 71 board_toolchain_prefix：编译工具链前缀，例如：“gcc-arm-none-eabi”。 72 board_toolchain_type： 编译工具链类型，目前支持gcc和clang。例如：“gcc” ，“clang”。 73 board_cflags： 开发板配置的c文件编译选项。 74 board_cxx_flags： 开发板配置的cpp文件编译选项。 75 board_ld_flags： 开发板配置的链接选项。 76 ``` 77 78 还以海思的hispark_taurus开发板为例，对应的device/hisilicon/hispark_taurus/config.gni内容如下： 79 80 ``` 81 # Board CPU type, e.g. "cortex-a7", "riscv32". 82 board_cpu = "cortex-a7" 83 84 # Toolchain name used for system compiling. 85 # E.g. gcc-arm-none-eabi, arm-linux-harmonyeabi-gcc, ohos-clang, riscv32-unknown-elf. 86 # Note: The default toolchain is "ohos-clang". It's not mandatory if you use the default toochain. 87 board_toolchain = "mips-linux-gnu-gcc" 88 89 # The toolchain path installed, it's not mandatory if you have added toolchain path to your ~/.bashrc. 90 board_toolchain_path = 91 rebase_path("//prebuilts/gcc/linux-x86/arm/arm-linux-ohoseabi-gcc/bin", 92 root_build_dir) 93 94 # Compiler prefix. 95 board_toolchain_prefix = "arm-linux-ohoseabi-" 96 97 # Compiler type, "gcc" or "clang". 98 board_toolchain_type = "gcc" 99 100 # Board related common compile flags. 101 board_cflags = [ 102 ] 103 board_cxx_flags = [ 104 ] 105 board_ld_flags = [] 106 107 # Board related headfiles search path. 108 board_include_dirs = [] 109 board_include_dirs += [ rebase_path( 110 "//prebuilts/gcc/linux-x86/arm/arm-linux-ohoseabi-gcc/target/usr/include", 111 root_build_dir) ] 112 113 # Board adapter dir for OHOS components. 114 board_adapter_dir = "" 115 116 # Sysroot path. 117 board_configed_sysroot = "" 118 119 # Board storage type, it used for file system generation. 120 storage_type = "emmc" 121 ``` 122 1233. 编写开发板编译脚本 124 步骤1中的BUILD.gn为新增的开发板的编译入口，主要用于编译开发板相关的代码，主要为设备侧驱动、设备侧接口适配(媒体，图形等)和开发板的SDK等等。 125 126 海思的hispark_taurus开发板的device/hisilicon/hispark_taurus/BUILD.gn可写成： 127 128 129 ``` 130 # group名称建议与开发板名称一致 131 group("hispark_taurus") { 132 deps = [ "//kernel/linux/patches:linux_kernel" ] # 拉起内核编译 133 deps += [ 134 ...... # 开发板其他编译单元 135 ] 136 } 137 ``` 138 1394. 编译调试 140 在开发板目录下执行hb set和hb build即可启动芯片解决方案的编译，编译框架会以开发板下的BUILD.gn为入口启动编译。 141