鸿蒙系统编译
编译原理
编译构建指导：https://docs.openharmony.cn/pages/v4.0/zh-cn/device-dev/subsystems/subsys-build-all.md，文档介绍了鸿蒙系统编译原理和基本规则。阅读这部分文档，在开发初期，编译和阅读部分配置代码时能基本明白其意义和作用。
OpenHarmony编译系统是以GN和Ninja构建为基座，对构建和配置粒度进行部件化抽象、对内建模块进行功能增强、对业务模块进行功能扩展的系统，该系统提供以下基本功能：
- 以部件为最小粒度拼装产品和独立编译。
- 支持轻量、小型、标准三种系统的解决方案级版本构建，以及用于支撑应用开发者使用IDE开发的SDK开发套件的构建。
- 支持芯片解决方案厂商的灵活定制和独立编译。
更详细原理介绍，请自行阅读上面链接文档。基础编译工具gn和Ninja相关的非官方资料：
GCC、CMake、CMakelist、Make、Makefile、Ninja啥关系？一图讲透！
鸿蒙源码构建工具Gn 与 Ninja 的介绍及使用入门
GN语言和操作
鸿蒙构建系统——gn官方FAQ翻译，以及gn官方文档分享
gn、Ninja是google发展出来的，看相关的原始文档，需要访问google网站，以上文档应用同仁的总结，帮助理解gn、Ninja，以及理解和make、makefile的区别。gn、Ninja是发展出的一套新的编译工具，如make、makefile、cmake等。
| 网站 | 链接 |
|---|---|
| gn项目官网 | https://gn.googlesource.com/gn/ |
| Ninja项目 | https://gitee.com/mirrors/ninja |
| Ninja官网 | https://ninja-build.org/ |
编译方式
概述
通读openharmony网站编译相关文档，鸿蒙系统有三种编译方式
| 命令 | 实现方式 |
|---|---|
| hb | OpenHarmony的命令行工具，用来执行编译命令 |
| build脚本 | build.py调用gn、ninja、gcc，编译轻量、小型系统；build.sh后期迭代版本加入，可编译全类型版本 |
| hpm | 调用任意编译命令，具体有项目编译构建脚本决定，如make、build、hb等。 |
系统的具体编译方式，具体参照项目提供的文档，有些客制化系统，可能会使用项目自身配置的编译方式。
注意： 在使用以下编译方式时，基于搭建好的编译环境，如docker、虚拟机等，不需要再安装编译工具，直接执行编译命令即可。
hb编译
ohos-build
hb是python包ohos-build中的命令，ohos-build包官网：https://pypi.org/project/ohos-build/
hb是基于gn和Ninja的编译框架，用于编译鸿蒙系统组件。
hb安装
python3 -m pip install --user ohos-build
文档中出现的python3 -m pip install --user build/hb应该是笔误。除了从官网安装hb命令，有些鸿蒙系统（轻量、小型、标准都是鸿蒙系统）源码中的build/lite目录下包含hb源码，可以使用命令
python3 -m pip install --user build/lite
安装源码目录的hb。如果编译出现错误，或许可以尝试直接使用源码中的hb安装包，通过以上命令安装。hb是鸿蒙系统基本的命令行工具，源码目录位于鸿蒙系统根目录下build/lite/hb，ohos-build也可以下载到hb源码。
hb安装异常处理：https://docs.openharmony.cn/pages/v4.0/zh-cn/device-dev/quick-start/quickstart-pkg-common-hberr.md
编译使用
常用命令
| 命令 | 说明 |
|---|---|
| hb set | 选择要编译的产品。hb set -h查看命令选项。 |
| hb build | 执行编译，可以使用hb build -h查看详细的编译命令选项，如hb build -f(强制编译) |
| hb clean | 清除已编译结果。全量编译前使用，确保系统会全新编译目标文件。 |
编译执行步骤
若搭建编译环境使用docker、虚拟机镜像等已配好的环境，则不需要再安装命令，按照系统文档直接执行编译命令即可。如果系统没有说明的编译方式，具体项目的编译方式可能不支持，在已配好的环境也可能执行不成功，如有些轻量型项目不使用gn命令，编译脚本直接调用ninja，此种情况使用hb编译会出错。
build脚本
build脚本有两种build.sh和build.py。
build.py
编译源码（轻量系统和小型系统）（链接打开后，滚动条向下拉），在项目根目录包含build.py脚本，build.py通过脚本调用gn、ninja、gcc对系统机型编译。具体编译参照项目编译文档，如案例：护花使者。
build.sh
使用build.sh脚本编译源码：
684
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
