HarmonyOS编译环境搭建
1.基础软件包安装
HMOS 的L0必须的三个环境工具为GN+NINJA+PYTHON。这三个工具在各个平台下应该都可以获取,因此正常情况下可以在WINDOWS/MACOS/LINUX中完成HMOS的编译工作,至于烧录,可以使用DevEco Device Tool。
以下情况必须注意:
- 如果使用ubuntu(虚拟机或者docker),最好选择18.04及其以上版本
- 务必确认系统下存在llvm/xxx/clang,并将llvm/xxx加入到系统的path中;如果你的工具链不是clang,可以创建一个clang文件(目前验证的内容任意即可)。macos的同学务必注意的是必须将llvm/xxx放在PATH的最前面,因为macos系统默认带有clang。
- 务必将GN/NINJA加入到系统PATH中
如果你使用的是官方的开发板,那么到此为止即可。以下文档指导你新加入一个SOC和对应的工具链。务必确保最后自己的hb工具能够运行正常,b帮助信息:
hb罗列出当前的产品信息:
当hb -h 和hb set能够完成上述工作时,我们的基础软件安装基本完成。如果基于已支持的开发板进行开发,那么基础环境基本搭建完毕,如果有新加入一个SOC的诉求,还需要继续往下阅读。
目前HMOS的组织是按照DEVICE+VENDOR的模式。DEVICE代表模组或者芯片厂商,存放的是芯片模组相关的代码;VENDOR代表最终的产品商,存放的是产品相关的业务代码。任何一个项目都应该是以一个产品的方式最终体现,哪怕是开发板。因此对于我们而言,务必完成创建DEVICE以及PRODUCT。
2.创建一个新的device
DEVICE必须包含一个config.gni文件以及BUILD.gn两个文件,其中config.gni文件配置当前芯片模组的全局性配置,包括编译链接选项、编译工具链、CPU类型等;BUILD.gn主要控制芯片模组相关的内容,哪些需要参与编译。一个具体的创建如下所示:
注意点:
- 如果你的编译工具链不在系统PATH中,务必确保配置board_toochain_path,否则置空即可
- 务必正确设置board_cpu,kernel部分会根据该值来决定加入哪个arch部分的代码;如果是新增的CPU,则需要在liteos_m/kernel/src/BUILD.gn中增加相关内容
3.创建一个新的product
PRODUCT必须包含两个关键要素:config.json和BUILD.gn。config.json主要是用来配置HMOS的哪些子系统/组件参与到产品化中。简单的案例如下:
当我们做完这些之后,通过hb set命令看到我们新增加的产品了。
特别需要注意的(构建系统会根据config.json中的配置去device下匹配对应的芯片模组SDK):
- product的BUILD.gn必须存在一个和产品名一致的target目标,构建系统会自动将该target加入到构建
- product的config.json中指定的device_company=AAA必须和device下对应的device/AAA目录一致
- product的config.json中指定的board=BBB必须和device下对应device/AAA/BBB目录一致
- product的config.json中指定的kernel_type=CCC必须和device/AAA/BBB下的config.gni中的kernel_type一致
- product的config.json中指定的kernel_version=CCC必须和device/AAA/BBB下的config.gni中的kernel_version一致
4.编译
对于开发者而言,关注的是头文件PATH/CFLAH/LDFLAG等内容
4.1增加全局INCLUDE/CFLAG/LDFLAG
全局的INCLUDE/CFLAG/LDFLAG内容需要在具体芯片的config.gni文件中。其中board_cflags用于增加需要的编译选项:
目前构建系统还不允许单独的增加宏定义。宏定义相关可以在board_cflags中使用-Dxxx来处理即可。
此时我们就可以使用hb build -f命令进行编译了,不过此时的编译还是会报错的,主要是arch相关的头文件路径我们并没有添加到include_dirs中。这些都是需要新做一个SOC需要完成的事情。
4.2增加参与编译的文件
对于SOC也好,产品也好,我们自然有自己的文件需要参与编译。对于L0设备而言,有两种方式可以使用:source_set或者static_library。source_set会将我们的源文件编译成.o文件,会参与到最后的工程链接;static_library会将原文件编译打包为静态库,需要我们手动的完成链接;source_set或者static_library的使用方法可以使用gn help source_set/static_library获取。工程的内容可以参考bearpi工程。
5.声明
文中所述能力HarmonyOS及其开源版本OpenHarmony都具备,考虑到开发者拿不到HarmonyOS版本,文章中所展示的图片、链接等内容,都是以开发者可访问的 OpenHarmony版本为例。若需要访问HarmonyOS内容,请以商业合作的形式加入我们。
HarmonyOS开发之旅
▼▼▼玩转开发板开源社区链接▼▼▼
https://gitee.com/openharmony-sig/vendor_oh_fun
▼▼▼扫码注册华为账号,开启HarmonyOS开发之旅,获取最新学习资源。▼▼▼

▼▼▼PC端下载DevEco Studio▼▼▼
▼▼▼体验全场景分布式开发乐趣▼▼▼
https://device.harmonyos.com/cn/ide#download
欢迎广大伙伴和开发者朋友加入HarmonyOS
每一位开发者都是我们要汇聚的星星之火
一起创造万物互联时代的无限可能
- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要发帖子
基于HarmonyOS和小熊派BearPi-HM Nano的护花使者
基于Neptune开发板的键盘蓝牙模块DIY指南
HarmonyOS开发板和华为云IoT服务联动
HarmonyOS调试指南
HarmonyOS编译环境搭建






































苏公安网备 32011402010933号