获取工具

Docker方式获取编译环境

OpenHarmony为开发者提供了两种Docker环境，以帮助开发者快速完成复杂的开发环境准备工作。两种Docker环境及适用场景如下：

• 基于HPM的Docker环境：适用于使用HPM工具进行发行版编译的场景。

• 独立Docker环境：适用于直接基于Ubuntu、Windows操作系统平台进行版本编译的场景。

  独立Docker环境目前容器化构建选项支持情况如下：

  表 1 Docker镜像介绍

  Docker镜像仓库	标签	说明
  swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker	0.0.3	已经预安装OpenHarmony版本的编译环境，支持Hi3861/Hi3516/Hi3518三种平台的版本构建。

基于HPM的Docker环境

docker_dist是一个HPM系统中的模板组件，能够帮助用户快速初始化HPM工程，利用docker镜像来快速编译OpenHarmony发行版，在很大程度上简化了编译前的环境配置。开发者在配置好Ubuntu和hpm-cli开发环境后，可以通过以下步骤来使用我们提供的Docker环境。

搭建Docker环境

1. 初始化安装模板。在任意工作目录中执行以下命令。

   hpm init -t @ohos/docker_dist

2. 修改publishAs。

   因为获取到的是模板类型的包，要把包的类型改为需要的类型。 在当前目录下打开bundle.json文件，把"publishAs"字段的值由"template"改为"distribution"。

3. 选择解决方案。设置解决方案发行版的环境变量。

   • Linux环境

1. ip_camera_hi3516dv300:

   export solution=@ohos/ip_camera_hi3516dv300 

   ip_camera_hi3518ev300:

   export solution=@ohos/ip_camera_hi3518ev300 

   wifiiot:

   export solution=@ohos/wifi_iot 

   • Windows环境

   使用cmd设置：

   set solution=发行版名称 

编译源码

执行编译，以ip_camera_hi3518ev300为例。自动安装docker只能在Ubuntu环境下执行，如果其他环境，需要用户自行安装docker，然后拉取镜像，执行编译。

• 自动安装docker（Ubuntu环境）

  以下命令可以帮助用户自动安装docker, 拉取镜像，并且在容器中开始运行对应解决方案的拉取和编译。

  hpm run docker 

  执行成功结果如下：

  ......
  ohos ipcamera_hi3518 build success!
  @ohos/ip_camera_hi3518ev300: distribution building completed.

• 自行安装docker（非Ubuntu环境）

  自行安装docker相关操作如下：

  # 拉取镜像 
  docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker:0.0.2
  # linux环境下的编译 
  hpm run distWithDocker 
  # windows下的编译，需要配置gitbash 
  hpm config set shellPath "gitbash路径"
  hpm run distWithDocker

独立Docker环境

OpenHarmony的Docker镜像托管在HuaweiCloud SWR上。开发者可以通过该镜像在很大程度上简化编译前的环境配置。开发者在配置好开发环境后，通过以下步骤来使用Docker环境。本Docker支持Ubuntu/Windows平台，下文将以Ubuntu系统为例进行使用介绍。

搭建Docker环境-轻量系统类设备（参考内存≥128KB）和小型系统类设备（参考内存≥1MB）

方式一：从HuaweiCloud SWR上直接获取Docker镜像进行构建：

1. 获取Docker镜像。

   docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker:0.0.3

2. 进入OpenHarmony代码根目录执行如下命令，从而进入Docker构建环境。

   docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker:0.0.3

方式二：通过Dockerfile 构建本地Docker镜像进行构建

1. 获取Dockerfile脚本文件，用来构建本地Docker镜像。

   git clone https://gitee.com/openharmony/docs.git

2. 进入Dockerfile代码目录路径执行Docker镜像构建命令。

   cd docs/docker
   ./build.sh

3. 进入OpenHarmony代码根目录执行如下命令，从而进入Docker构建环境。

   docker run -it -v $(pwd):/home/openharmony openharmony-docker:0.0.3

编译源码-轻量系统类设备（参考内存≥128KB）和小型系统类设备（参考内存≥1MB）

通过如下编译脚本启动轻量系统类设备（参考内存≥128KB）和小型系统类设备（参考内存≥1MB）的编译。下文以Hi3516平台为例说明具体编译步骤。

1. 在源码的根目录执行如下命令安装hb。

   python3 -m pip install --user build/lite

2. 设置编译路径，选择当前路径。

   hb set
    .

   图 1 设置编译界面

1.  说明： 当前开发板平台和编译界面的对应关系如下：

   • Hi3861：wifiiot_hispark_pegasus@hisilicon
   • Hi3516：ipcamera_hispark_taurus@hisilicon
   • Hi3518：ipcamera_hispark_aries@hisilicon

2. 选择ipcamera_hispark_taurus@hisilicon并回车。

3. 执行编译。

   hb build -f

4. 查看编译结果。

   编译结果文件生成在out/hispark_taurus/ipcamera_hispark_taurus目录下。

5.  

获取设备开发工具（HUAWEI DevEco Device Tool）

HUAWEI DevEco Device Tool是OpenHarmony面向智能设备开发者提供的一站式集成开发环境，支持OpenHarmony的组件按需定制，支持代码编辑、编译、烧录、调试等功能，支持C/C++语言，以插件的形式部署在Visual Studio Code上。具体可参见获取工具和工具使用指南。

获取应用开发工具（HUAWEI DevEco Studio）

HUAWEI DevEco Studio（以下简称DevEco Studio）是面向华为终端全场景多设备的一站式集成开发环境（IDE），为开发者提供工程模板创建、开发、编译、调试、发布等E2E的OpenHarmony应用开发服务。通过使用DevEco Studio，开发者可以更高效的开发具备OpenHarmony分布式能力的应用，进而提升创新效率。具体可参见获取工具和工具使用指南。