鸿蒙南向开发实战：Docker编译环境

蜀道山QAQ

于 2024-05-07 20:28:35 发布

阅读量1k

点赞数 12

分类专栏： OpenHarmony 鸿蒙南向开发鸿蒙文章标签： harmonyos 华为鸿蒙系统前端 android docker

本文链接：https://blog.csdn.net/shudaoshanQAQ/article/details/138544449

版权

鸿蒙同时被 3 个专栏收录

634 篇文章 40 订阅

订阅专栏

OpenHarmony

201 篇文章 1 订阅

订阅专栏

鸿蒙南向开发

126 篇文章 0 订阅

订阅专栏

Docker环境介绍

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

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

表1 Docker镜像介绍

系统类型	运行平台	Docker镜像仓库	标签
标准系统（独立Docker环境）	Ubuntu/Windows	swr.cn-south-1.myhuaweicloud.com/openharmony-docker/docker_oh_standard	3.2
小型系统（独立Docker环境）	Ubuntu/Windows	swr.cn-south-1.myhuaweicloud.com/openharmony-docker/docker_oh_small	3.2
轻量系统（独立Docker环境）	Ubuntu/Windows	swr.cn-south-1.myhuaweicloud.com/openharmony-docker/docker_oh_mini	3.2
轻量和小型系统（HPM Docker环境）	Ubuntu/Windows	swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker	0.0.3

环境准备

在使用Docker环境前，需要准备源码和一些基本工具，以Ubuntu为例，您需要执行以下步骤：

安装Docker
- 在Ubuntu中，可以使用下面的命令来安装Docker：
```
sudo apt install docker.ioCopy to clipboardErrorCopied
```
- 其他系统的Docker安装请参考Docker指导。
获取OpenHarmony源码

请参考获取源码。

说明：
HPM Docker环境无需单独获取源码。
获取使用权限

为了能够使用Docker，请使用具备root权限的用户，或已被授予Docker使用权限的用户进行后续操作。在Ubuntu系统中，通常可以通过在命令前加sudo来获取root权限。在Windows系统中，您可能需要在管理员模式下运行cmd或PowerShell。

独立Docker环境

Docker镜像是包含了运行环境和应用程序的轻量级、可执行的软件包，OpenHarmony的Docker镜像托管在HuaweiCloud SWR上。开发者可以通过该镜像在很大程度上简化编译前的环境配置。这一部分将引导您如何在Docker环境中配置和使用OpenHarmony，下文将介绍具体使用步骤。

搭建Docker环境（轻量系统和小型系统）

获取Docker镜像

获取小型系统镜像的命令为：

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

获取轻量系统镜像的命令为：

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

进入Docker构建环境

在获取了镜像之后，您需要创建一个新的Docker容器，并进入该容器中。进入OpenHarmony源码根目录执行如下命令，从而进入Docker构建环境。

Ubuntu系统

# 进入小型系统Docker构建环境
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/docker_oh_small:3.2

# 进入轻量系统Docker构建环境
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/docker_oh_mini:3.2

Windows系统（假设源码目录为D:\OpenHarmony）：

# 进入小型系统Docker构建环境
docker run -it -v D:\OpenHarmony:/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/docker_oh_small:3.2

# 进入轻量系统Docker构建环境
docker run -it -v D:\OpenHarmony:/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/docker_oh_mini:3.2

说明：
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/docker_oh_small:3.2 这个命令的含义是，创建并运行一个新的OpenHarmony的Docker容器，这个容器运行在交互模式下，并且将当前目录映射到容器的/home/openharmony目录。

编译源码（轻量系统和小型系统）

启动编译脚本

执行docker run命令进入Docker容器后（此时位于/home/openharmony路径下），您可以通过如下编译脚本启动轻量系统类设备（参考内存≥128KiB）和小型系统类设备（参考内存≥1MiB）的编译。
```
python3 build.py -p {product_name}@{company}
```
其中，{product_name}为当前版本支持的平台，{company}为{product_name}对应的公司名。

举个例子，如果您要编译的产品为hisilicon下的ipcamera_hispark_taurus，您可以输入以下命令来启动编译：
```
python3 build.py -p ipcamera_hispark_taurus@hisilicon
```
同样，如果您要编译的产品是ohemu下的qemu_small_system_demo，那么您可以输入以下命令来启动编译：
```
python3 build.py -p qemu_small_system_demo@ohemu
```
查看编译结果

在编译结束后，编译所生成的文件都会被存放在out/{device_name}/目录下，结果镜像输出在out/{device_name}/packages/phone/images/目录下。

说明：
如需退出Docker，执行exit命令即可。这个命令会停止当前的Docker容器，并返回到您的操作系统。

搭建Docker环境（标准系统）

获取Docker镜像

在搭建标准系统的Docker环境前，我们也需要先获取对应的Docker镜像。具体的命令如下：
```
docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/docker_oh_standard:3.2
```
进入Docker构建环境

与之前的步骤相同，我们需要创建一个新的Docker容器，并进入该容器中。进入openharmony源码根目录执行如下命令，从而进入Docker构建环境。
- Ubuntu系统
```
docker run -it -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/docker_oh_standard:3.2
```
- Windows系统（假设源码目录为D:\OpenHarmony）
```
docker run -it -v D:\OpenHarmony:/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/docker_oh_standard:3.2
```

编译源码（标准系统）

启动编译脚本

执行docker run命令进入Docker容器后（此时位于/home/openharmony路径下），您可以通过如下编译脚本启动标准系统类设备（参考内存≥128MB）的编译。
```
./build.sh --product-name {product_name} --ccache
```
{product_name}为当前版本支持的平台。例如，您要编译的产品是rk3568，那么您可以输入以下命令来启动编译：
```
./build.sh --product-name rk3568 --ccache
```
查看编译结果
编译所生成的文件都归档在out/{device_name}/目录下，结果镜像输出在out/{device_name}/packages/phone/images/目录下。

说明：
如需退出Docker，执行exit命令即可。这个命令会停止当前的Docker容器，并返回到您的操作系统。

基于HPM的Docker环境

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

搭建Docker环境

初始化安装模板

在任意工作目录中执行以下命令
```
hpm init -t @ohos/docker_dist
```
修改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}

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

如果你是一名有经验的资深Android移动开发、Java开发、前端开发、对鸿蒙感兴趣以及转行人员，可以直接领取这份资料

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

HarmonOS基础技能

HarmonOS就业必备技能
HarmonOS多媒体技术

鸿蒙NaPi组件进阶

HarmonOS高级技能

初识HarmonOS内核
实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料