OpenHarmony——轻量级编译构建组件

jiecho

发布于 2021-7-21 16:02

浏览

2收藏

轻量级编译构建组件

简介

一个基于gn和ninja的支持OpenHarmony组件化开发的编译框架，主要提供以下功能：

构建产品。
独立构建芯片厂商组件。
独立构建单个组件。

在开发编译构建前，应了解如下基本概念：

组件

可复用的软件单元，它可包含源码、配置文件、资源文件和编译脚本等。
gn

Generate ninja的缩写，一种元构建系统，用于产生ninja文件。
ninja

ninja是一个专注于速度的小型构建系统。

构建流程如下：

编译构建流程如图1所示，主要包括设置和编译两步： OpenHarmony——轻量级编译构建组件-鸿蒙开发者社区

图 1 编译构建流程

hb set: 设置OpenHarmony源码目录和要编译的产品。
hb build: 编译产品、开发板或者组件。解决方案编译实现如下：
- 读取开发板配置：主要包括开发板使用的编译工具链、编译链接命令和选项等。
- 调用gn: 调用gn gen命令，读取产品配置(主要包括开发板、内核、选择的组件等)生成解决方案out目录和ninja文件。
- 调用ninja：调用ninja -C out/company/product启动编译。
- 系统镜像打包：将组件编译产物打包，制作文件系统镜像。

build/lite                      # 编译构建主目录
├── components                  # 组件描述文件。
├── hb                          # hb pip安装包源码。
├── make_rootfs                 # 文件系统制作脚本。
├── config                      # 编译相关的配置项
│   ├── component               # 组件相关的模板定义。包括：静态库、动态库、扩展组件、模拟器库等
│   ├── kernel                  # 内核的编译配置参数
│   └── subsystem               # 子系统模板
├── ndk                         # Native API相关编译脚本与配置参数
├── product                     # 产品全量配置表，包括：配置单元、子系统列表、编译器等。
└── toolchain                   # 编译工具链相关，包括：编译器路径、编译选项、链接选项等。

说明

使用说明

前提条件
- Linux服务器，Ubuntu16.04及以上64位系统版本。
- Python 3.7.4及以上。
- OpenHarmony源码build_lite仓下载成功。

安装hb

在源码根目录下执行：

python3 -m pip install --user build/lite

执行hb -h有相关帮助信息，有打印信息即表示安装成功：

usage: hb

OHOS build system

positional arguments:
  {build,set,env,clean}
    build               Build source code
    set                 OHOS build settings
    env                 Show OHOS build env
    clean               Clean output

optional arguments:
  -h, --help            show this help message and exit

卸载方法：
```
python3 -m pip uninstall ohos-build
```

编译命令

hb set

hb set -h
usage: hb set [-h] [-root [ROOT_PATH]] [-p]

optional arguments:
  -h, --help            Show this help message and exit.
  -root [ROOT_PATH], --root_path [ROOT_PATH]
                        Set OHOS root path.
  -p, --product         Set OHOS board and kernel.

hb set 后无参数，进入默认设置流程
hb set -root [ROOT_PATH] 直接设置代码根目录
hb set -p --product 设置要编译的产品

hb env

查看当前设置信息

hb env
[OHOS INFO] root path: xxx
[OHOS INFO] board: hispark_taurus
[OHOS INFO] kernel: liteos
[OHOS INFO] product: ipcamera
[OHOS INFO] product path: xxx/vendor/hisilicon/ipcamera
[OHOS INFO] device path: xxx/device/hisilicon/hispark_taurus/sdk_linux_4.19

hb build

hb build -h
usage: hb build [-h] [-b BUILD_TYPE] [-c COMPILER] [-t [TEST [TEST ...]]]
                [--dmverity] [-p PRODUCT] [-f] [-n]
                [component [component ...]]

positional arguments:
  component             Name of the component.

optional arguments:
  -h, --help            Show this help message and exit.
  -b BUILD_TYPE, --build_type BUILD_TYPE
                        Release or debug version.
  -c COMPILER, --compiler COMPILER
                        Specify compiler.
  -t [TEST [TEST ...]], --test [TEST [TEST ...]]
                        Compile test suit.
  --dmverity            Enable dmverity.
  -p PRODUCT, --product PRODUCT
                        Build a specified product with
                        {product_name}@{company}, eg: ipcamera@hisilcon.
  -f, --full            Full code compilation.
  -T [TARGET [TARGET ...]], --target [TARGET [TARGET ...]]
                        Compile single target

hb build后无参数，会按照设置好的代码路径、产品进行编译，编译选项使用与之前保持一致。
hb build component：基于设置好的产品对应的单板、内核，单独编译组件（e.g.：hb build kv_store)。
hb build -p PRODUCT：免set编译产品，该命令可以跳过set步骤，直接编译产品。
在device/device_company/board下单独执行hb build会进入内核选择界面，选择完成后会根据当前路径的单板、选择的内核编译出仅包含内核、驱动的镜像。

hb clean

清除out目录对应产品的编译产物，仅剩下args.gn、build.log。清除指定路径可输入路径参数：hb clean xxx/out/xxx，否则将清除hb set的产品对应out路径
```
hb clean
usage: hb clean [-h] [out_path]

positional arguments:
  out_path    Clean a specified path.

optional arguments:
  -h, --help  Show this help message and exit.
```