# Docker编译环境
- [Docker环境介绍](#section107932281315)
- [环境准备](#section7337134183512)
- [独立Docker环境](#section2858536103611)
- [搭建Docker环境-轻量系统类设备(参考内存≥128KB)和小型系统类设备(参考内存≥1MB)](#section319412277287)
- [编译源码-轻量系统类设备(参考内存≥128KB)和小型系统类设备(参考内存≥1MB)](#section631485163615)
- [搭建Docker环境-标准系统类设备(参考内存≥128MB)](#section13585262391)
- [编译源码-标准系统类设备(参考内存≥128MB)](#section193711513406)
- [基于HPM的Docker环境](#section485713518337)
- [搭建Docker环境](#section3295842510)
- [获取及编译源码](#section69141039143518)
## Docker环境介绍
OpenHarmony为开发者提供了两种Docker环境,以帮助开发者快速完成复杂的开发环境准备工作。两种Docker环境及适用场景如下:
- 独立Docker环境:适用于直接基于Ubuntu、Windows操作系统平台进行版本编译的场景。
- 基于HPM的Docker环境:适用于使用HPM工具进行发行版编译的场景。
**表 1** Docker镜像介绍
Docker环境
|
系统类型
|
运行平台
|
Docker镜像仓库
|
标签
|
独立 Docker环境
|
轻量和小型系统
|
Ubuntu/Windows
|
swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker
|
0.0.5
|
标准系统
|
Ubuntu
|
swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard
|
0.0.5
|
HPM Docker环境
|
轻量和小型系统
|
Ubuntu/Windows
|
swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker
|
0.0.3
|
## 环境准备
在使用docker环境前需要先完成以下操作:
1. 安装Docker,Docker安装请参考[官方指导](https://docs.docker.com/engine/install/)。
2. 获取OpenHarmony源码,请参考[获取源码](sourcecode-acquire.md)。
>![](../public_sys-resources/icon-note.gif) **说明:**
>HPM Docker环境无需单独获取源码。
## 独立Docker环境
OpenHarmony的Docker镜像托管在[HuaweiCloud SWR](https://console.huaweicloud.com/swr/?region=cn-south-1#/app/warehouse/warehouseMangeDetail/goldensir/openharmony-docker/openharmony-docker?type=ownImage)上。开发者可以通过该镜像在很大程度上简化编译前的环境配置。下文将介绍具体使用步骤。
### 搭建Docker环境-轻量系统类设备(参考内存≥128KB)和小型系统类设备(参考内存≥1MB)
**方式一:从HuaweiCloud SWR上直接获取Docker镜像进行构建:**
1. 获取Docker镜像。
```
docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker:0.0.5
```
2. 进入OpenHarmony代码根目录执行如下命令,从而进入Docker构建环境。
ubuntu下执行:
```
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker:0.0.5
```
windows下执行(假设源码目录为D:\\OpenHarmony):
```
docker run -it -v D:\OpenHarmony:/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker:0.0.5
```
**方式二:通过Dockerfile 构建本地Docker镜像进行构建**
1. 获取Dockerfile脚本文件,用来构建本地Docker镜像。
```
git clone https://gitee.com/openharmony/docs.git
```
2. 进入Dockerfile代码目录路径执行Docker镜像构建命令。
```
cd docs/docker
./build.sh
```
3. 进入OpenHarmony代码根目录执行如下命令,从而进入Docker构建环境。
ubuntu下执行:
```
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker:0.0.5
```
windows下执行(假设源码目录为D:\\OpenHarmony):
```
docker run -it -v D:\OpenHarmony:/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker:0.0.5
```
### 编译源码-轻量系统类设备(参考内存≥128KB)和小型系统类设备(参考内存≥1MB)
通过如下编译脚本启动轻量系统类设备(参考内存≥128KB)和小型系统类设备(参考内存≥1MB)的编译。下文以Hi3516平台为例说明具体编译步骤。
设置编译路径,选择当前路径。
```
hb set
.
```
**图 1** 设置编译界面
![](figure/设置编译界面.png "设置编译界面")
>![](../public_sys-resources/icon-note.gif) **说明:**
>当前开发板平台和编译界面的对应关系如下:
>- Hi3861:wifiiot\_hispark\_pegasus@hisilicon
>- Hi3516:ipcamera\_hispark\_taurus@hisilicon
>- Hi3518:ipcamera\_hispark\_aries@hisilicon
1. 选择ipcamera\_hispark\_taurus@hisilicon并回车。
2. 执行编译。
```
hb build -f
```
3. 查看编译结果。
编译结果文件生成在out/hispark\_taurus/ipcamera\_hispark\_taurus目录下。
### 搭建Docker环境-标准系统类设备(参考内存≥128MB)
**方式一:从HuaweiCloud SWR上直接获取Docker镜像进行构建:**
1. 获取Docker镜像。
```
docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.5
```
2. 进入OpenHarmony代码根目录执行如下命令,从而进入Docker构建环境。
```
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker-standard:0.0.5
```
**方式二:通过Dockerfile 构建本地Docker镜像进行构建**
1. 获取Dockerfile脚本文件,用来构建本地Docker镜像。
```
git clone https://gitee.com/openharmony/docs.git
```
2. 进入Dockerfile代码目录路径执行Docker镜像构建命令。
```
cd docs/docker/standard
./build.sh
```
3. 进入OpenHarmony代码根目录执行如下命令,从而进入Docker构建环境。
```
docker run -it -v $(pwd):/home/openharmony openharmony-docker-standard:0.0.5
```
### 编译源码-标准系统类设备(参考内存≥128MB)
通过如下编译脚本启动标准系统类设备(参考内存≥128MB)的编译。
```
./build.sh --product-name {product_name}
```
\{product\_name\}为当前版本支持的平台。比如:Hi3516DV300等。
编译所生成的文件都归档在out/{device_name}/目录下,结果镜像输出在 out/{device_name}/packages/phone/images/ 目录下。
>![](../public_sys-resources/icon-note.gif) **说明:**
>退出Docker执行exit命令即可。
## 基于HPM的Docker环境
docker\_dist是一个[HPM](https://hpm.harmonyos.com/)系统中的模板组件,能够帮助用户快速初始化HPM工程,利用docker镜像来快速编译OpenHarmony发行版,在很大程度上简化了编译前的环境配置。开发者在配置好Ubuntu和[hpm-cli](../bundles/bundles-guide-prepare.md)开发环境后,可以通过以下步骤来使用我们提供的Docker环境。
### 搭建Docker环境
1. 初始化安装模板。在任意工作目录中执行以下命令。
```
hpm init -t @ohos/docker_dist
```
2. 修改publishAs。
因为获取到的是模板类型的包,要把包的类型改为需要的类型。 在当前目录下打开bundle.json文件,把"publishAs"字段的值由"template"改为"distribution"。
### 获取及编译源码
执行编译。自动安装docker只能在Ubuntu环境下执行,如果其他环境,需要用户自行安装docker,然后拉取镜像,执行编译。
- **自动安装docker(Ubuntu环境)**
以下命令可以帮助用户自动安装docker, 拉取镜像,并且在容器中开始运行对应解决方案的拉取和编译。
**方式一:**
命令后接参数指定解决方案,格式如下:
```
hpm run docker solution={product}
```
\{product\}为需编译的解决方案,如:@ohos/hispark\_taurus、@ohos/hispark\_aries、@ohos/hispark\_pegasus。
**方式二:**
设置环境变量来选择解决方案,再执行编译命令。
1. 选择解决方案。
```
export solution={product}
```
\{product\}为需编译的解决方案,如:@ohos/hispark\_taurus、@ohos/hispark\_aries、@ohos/hispark\_pegasus。
2. 获取源码及执行编译。
```
hpm run docker
```
以上两种方式以@ohos/hispark\_taurus为例,执行成功结果如下:
```
......
ohos ipcamera_hispark_taurus build success!
@ohos/hispark_taurus: distribution building completed.
```
- **自行安装docker(非Ubuntu环境)**
自行安装docker相关操作如下:
```
# 拉取镜像
docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker:0.0.3# linux环境下的编译
hpm run distWithDocker solution={product}
# windows下的编译,需要配置gitbash
hpm config set shellPath "gitbash路径"
hpm run distWithDocker solution={product}
```