编译构建指导

编译环境

OpenHarmony开发需要预先配置编译环境，各类环境的配置分别如下

1.基于Ubuntu环境开发编译

OpenHarmony的源码获取请参考源码获取。 编译环境的配置请参考环境配置。

2.docker环境编译

OpenHarmony为开发者提供了两种Docker环境，分别为独立Docker环境、基于HPM的Docker环境。开发者下载源码后，可以开始搭建OpenHarmony提供的Docker环境。详情请参考Docker指导。

3.基于WSL环境开发编译

此配置以windows10下配置ubuntu20.04为例，为所有与 OpenHarmony编译产品时必要的前置操作。

一、电脑首次设置

1. 打开设置->安全和更新->开发者选项，选择为“开发人员模式”。
2. Win + R运行control appwiz.cpl指令，在启用或关闭Windows功能中勾选适用于Linux的Windows子系统和虚拟机平台两项启用，重启。
3. 以管理员身份打开PowerShell并运行：dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart，开启Windows子系统功能。

二、环境配置

1. windows官方商店下载安装ubuntu20.04并配置root用户密码。
2. wsl文件映射在\wsl路径下，通过\wsl\Ubuntu-20.04打开文件所在位置，右键此电脑添加网络映射驱动。
3. windows命令窗口查看当前wsl版本： wsl -l -v ，升级为2：wsl --set-version Ubuntu-20.04 2 （这里的ubuntu版本根据具体使用版本而定）。
4. 执行：ls -l /bin/sh，如果为dash环境则需要修改为bash。
5. 获取源码请参考源码获取。

编译执行

在搭建好编译环境并且获取源码后，开始进入编译执行阶段。编译之前先执行预编译命令。

编译执行可分hb编译和脚本编译，脚本编译中轻设备与富设备的编译所使用的脚本不同。

1.hb编译

hb的安装以及编译执行请参考hb构建指导。

2.富设备

富设备的编译调用build.sh脚本，其各个形态的编译命令请参考编译命令。

3.轻设备

轻设备的编译调用build.py脚本，其各个形态的编译命令请参考编译命令。