一个基于gn和ninja的支持OpenHarmony组件化开发的编译框架

风在云颠

发布于 2021-8-30 11:38

浏览

2收藏

轻量级编译构建组件

简介
目录
说明
使用说明
相关仓

简介

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

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

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

组件

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

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

ninja

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

构建流程如下：

编译构建流程如图1所示，主要包括设置和编译两步：

图 1 编译构建流程 一个基于gn和ninja的支持OpenHarmony组件化开发的编译框架-鸿蒙开发者社区

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相关编译脚本与配置参数
└── toolchain                   # 编译工具链相关，包括：编译器路径、编译选项、链接选项等。1.
2.
3.
4.
5.
6.
7.
8.
9.
10.

说明

使用说明

1.前提条件

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

2.安装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 exit1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.

卸载方法：

python3 -m pip uninstall ohos-build
1.

3.编译命令

1.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.1.
2.
3.
4.
5.
6.
7.
8.

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

2.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.191.
2.
3.
4.
5.
6.
7.

3.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 target1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.

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

4.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.1.
2.
3.
4.
5.
6.
7.
8.

相关仓

编译构建子系统

分类

标签