编译原理

编译构建指导：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
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	清除已编译结果。全量编译前使用，确保系统会全新编译目标文件。

编译执行步骤

系统类型	文档地址
轻量系统