由于OpenHarmony工程需要在Linux环境下进行编译,此章节将指导厂商搭建OpenHarmony的编译环境、获取OpenHarmony源码,并且创建厂商工作目录完成厂商芯片的编译框架适配。
搭建编译环境
开展移植前请参考开发环境准备完成环境搭建工作。
获取源码
获取操作
请参考获取源码完成源码下载并进行编译。
说明: 本文档仅适用于OpenHarmony LTS 3.0.1及之前版本,所以请获取对应版本的源码。
目录介绍
OpenHarmony源码重要目录介绍见表1 OpenHarmony重要目录,其中device和vendor目录为芯片厂商和终端模组厂商工作区域(在搭建编译框架部分详细介绍)。
表1 OpenHarmony重要目录
目录 | 用途 |
---|---|
build | 编译框架所在目录。 |
kernel/liteos_m | 内核所在的目录,其中arch目录描述支撑的内核架构。 |
device | 芯片厂商适配目录,其中“config.gni”描述当前芯片使用的arch,工具链,编译链接选项等。 |
vendor | 终端模组厂商适配目录,其中“config.json”描述需要集成的OpenHarmony子系统列表。 |
utils | file,kv等相关的适配。 |
搭建编译框架
厂商开展移植工作时,需要在工程中按照公司名、芯片型号、开发板型号等创建工作目录,并且将所创目录加入到OpenHarmony的编译框架中,使厂商的工作目录能够参与编译,开发者可参照以下步骤进行操作。
-
新增芯片厂商。 基于某款芯片进行OpenHarmony的适配,需要在device目录下创建芯片厂商目录,目录内文件描述内核类型,编译工具链,编译链接选项,内核配置选项等。
创建目录规则:“device/{芯片厂商}/{芯片开发板}”。
例:“device/MyDeviceCompany/MyBoard”
device ├── hisilicon # hisilicon芯片相关目录,创建目录时可供参考 ├── MyDeviceCompany # MyDeviceCompany 芯片厂商 │ └── MyBoard # MyBoard 芯片型号 │ ├── BUILD.gn │ ├── liteos_m │ │ └── config.gni # 芯片工具链,编译链接选项 │ └── target_config.h # 内核配置选项 └── qemu # qemu相关
编译脚本:将“device/MyDeviceCompany/MyBoard”下的文件添加到OpenHarmony编译框架中。
路径:“device/MyDeviceCompany/MyBoard/BUILD.gn”
group("MyBoard") { #将此BUILD.gn文件加入解析 print("MyDeviceCompany MyBoard is under developing.") }
开发板编译配置:包括内核类型、工具链类型以及编译参数等内容(详见表2“config.gni”主要配置项)。
路径:“device/MyDevi