文档开发者中心
我的

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帮助信息:

image.png​

hb罗列出当前的产品信息:

image.png​

当hb -h 和hb set能够完成上述工作时,我们的基础软件安装基本完成。如果基于已支持的开发板进行开发,那么基础环境基本搭建完毕,如果有新加入一个SOC的诉求,还需要继续往下阅读。

目前HMOS的组织是按照DEVICE+VENDOR的模式。DEVICE代表模组或者芯片厂商,存放的是芯片模组相关的代码;VENDOR代表最终的产品商,存放的是产品相关的业务代码。任何一个项目都应该是以一个产品的方式最终体现,哪怕是开发板。因此对于我们而言,务必完成创建DEVICE以及PRODUCT。

2.创建一个新的device

DEVICE必须包含一个config.gni文件以及BUILD.gn两个文件,其中config.gni文件配置当前芯片模组的全局性配置,包括编译链接选项、编译工具链、CPU类型等;BUILD.gn主要控制芯片模组相关的内容,哪些需要参与编译。一个具体的创建如下所示:

image.png​
image.png​

注意点:

  • 如果你的编译工具链不在系统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的哪些子系统/组件参与到产品化中。简单的案例如下:

image.png​
image.png​

当我们做完这些之后,通过hb set命令看到我们新增加的产品了。

image.png​

特别需要注意的(构建系统会根据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用于增加需要的编译选项:

image.png​

目前构建系统还不允许单独的增加宏定义。宏定义相关可以在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

每一位开发者都是我们要汇聚的星星之火

一起创造万物互联时代的无限可能

点赞
收藏
回复
1
分享
举报
浏览2632 编辑于2021-07-22 07:54未知归属地
全部评论
最多点赞
最新发布
最早发布
好文章写的真不错、学习收藏了
1楼回复于2021-11-12 11:48 未知归属地
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

玩转HarmonyOS开发板
01

基于HarmonyOS和小熊派BearPi-HM Nano的护花使者

02

基于Neptune开发板的键盘蓝牙模块DIY指南

03

HarmonyOS开发板和华为云IoT服务联动

04

HarmonyOS调试指南

05

HarmonyOS编译环境搭建

了解社区公约,与您携手共创和谐专业的开发者社区。