当前位置：首页 > news >正文

wsl2平台鸿蒙全仓docker编译环境快速创建方法

news 2026/3/31 10:47:57

文章目录

1 文章适用范围：
2 WSL环境安装
3 镜像迁移非C盘
4 Docker环境准备
- 4.1 docker用户组和用户创建
- 4.2 Docker环境配置
- - 4.2.1 Ubuntu下安装docker工具
  - 4.2.2 鸿蒙Docker环境安装
  - 4.2.3 鸿蒙全仓代码拉取编译
5 鸿蒙全仓代码的更新策略
6 参考文献
7 FAQ
- 7.1 缺头文件xcrusor/xcursor.h
- 7.2 缺头文件Xinerama.h

1 文章适用范围：

鸿蒙全仓代码。 windows wsl2 utunbu20.04以上 x86_64平台。对于鸿蒙独立仓或分支版本比如4.1\5.0等的下载地址请自行查询，repo的版本地址不同，repo init不同。因此本文在更新repo init 内容后，也适用于其它版本。
windows CPU。能正常开启WSL2。
16核，32G内存。wsl2内存16G，虚拟内存4G（建议8G）。低于该配置鸿蒙全仓编译都可能报莫名其妙错误。配置方法请参见第二小节第7步。
硬盘最少1T，建议2T。平时wsl子系统大约占硬盘空间510G（只有1套代码）。
编译在docker环境进行。非docker环境平时可能会出现莫名奇妙错误。docker容器中不建议执行apt-get update之类环境升级，避免依赖变化导致编译失败

2 WSL环境安装

打开设置->安全和更新->开发者选项，选择为“开发人员模式”；
Win + R运行control appwiz.cpl指令,在启用或关闭Windows功能中勾选适用于Linux的Windows子系统和虚拟机平台两项启用，重启（注：没有虚拟机平台的，请升级Windows系统, Win10 版本号为 2004（内部版本19041或更高））

在这里插入图片描述
3. 以管理员身份打开PowerShell并运行：dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart 开启Windows子系统功能；

4. 然后更新一下wsl: wsl --update;
5. 打开Microsoft Store搜索Ubuntu，安装Ubuntu20.04：
在这里插入图片描述
6. 运行sudo dpkg-reconfigure dash, 选择No，将Ubuntu shell由dash修改为bash

7. 子系统ubuntu内存、虚拟内存要求
内存16G，虚拟内存4G。
修改wsl内存和缓存最快接方法：

退出ubuntu
修改下图文件内容（没有就创建）
重新打开ubuntu

提醒：windows重启生效。wsl的swap(虚拟内存）够用即可，多了，会造成windsow非常卡顿，影响工作（血泪教训）
8.安装wsl验证
安装WSL之后，查看一下版本。
wsl -l -v
如果版本是1, 执行： wsl --set-version Ubuntu-20.04 2

3 镜像迁移非C盘

安装完Ubuntu之后，因为默认Ubuntu安装在C盘，需要把它迁移到D盘。
具体步骤：

导出： D盘创建一个目录WSL, 目录名自己可以取，wsl --export Ubuntu-20.04 d:\WSL\Ubuntu20.04.tar
注销：wsl --unregister Ubuntu-20.04
导入：wsl --import Ubuntu-20.04 d:\WSL d:\WSL\Ubuntu20.04.tar --version 2

4 Docker环境准备

4.1 docker用户组和用户创建

普通用户可能会在使用docker命令时提示没有权限，需要把普通用户加入docker组才可以，命令如下：
sudo groupadd docker # 创建docker用户组
sudo usermod -aG docker $USER # 将当前用户加入docker用户组

4.2 Docker环境配置

4.2.1 Ubuntu下安装docker工具

sudo curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo service docker start
sudo service docker status

说明：无法直接下载安装脚本时，请点这里下载。
在这里插入图片描述

4.2.2 鸿蒙Docker环境安装

理论上支持在任意目录执行。但考虑到第二步情况，建议在home下新建目录执行。

下载鸿蒙编译环境的image

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

创建docker实例（名字为ohos）

docker run --name ohos -itd -v $(pwd):/home/openharmony swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker:1.0.0

注意：

执行“exit”后实例会自动结束。这里参数“-itd”中的d不能省略。
警告：严禁直接拷贝本指令在任意目录执行。该启动指令默认是把当前目录映射到容器中的/home/openharmony目录。建议安装在/home/openharmony，方便记忆。可以把$(pwd)替换为自定义目录。

启动实例

docker start ohos

进入实例

docker exec -it ohos bash

4.2.3 鸿蒙全仓代码拉取编译

进入docker编译环境的docker实例
方法上参考上面。
因为编译时可能要用到X11的头文件，这里docker环境中还需要执行下面的命令：
apt install libxcursor-dev libxrandr-dev libxinerama-dev
配置git用户信息：
git config --global user.email "XXX@YYY.com"
git config --global user.name "XXX"
参考下面的《鸿蒙Docker编译环境》下载代码和预编译相关工具

repo init -u https://gitee.com/openharmony/manifest.git -b master --no-repo-verify
repo sync -c  
repo forall -c 'git lfs pull' 
bash build/prebuilts_download.sh 
./build.sh --product-name ohos-sdk
./build.sh --product-name rk3568 --ccache

参考下面的《鸿蒙Docker编译环境》编译sdk和其他部分的全量编译

./build.sh --product-name ohos-sdk     # sdk编译 
./build.sh --product-name rk3568 –ccache   # 32位全编 
./build.sh --product-name rk3568 --fast-rebuild # 32位快速编译
./build.sh --product-name Hi3516DV300    # Hi3516DV300编译

扩展编译命令：

单独快速编译arkui模块：./build.sh --product-name rk3568 --build-target ace_engine --fast-rebuild
单独快速编译form_fwk模块：./build.sh --product-name rk3568 --build-target form_fwk --fast-rebuild
单独快速编译ability_dmsfwk模块：./build.sh --product-name rk3568 --build-target dmsfwk --fast-rebuild
单独快速编译资源仓库： ./build.sh --product-name rk3568 --build-target system_resources --fast-rebuild
单独快速编译doc仓库：`./build.sh --product-name rk3568 --build-target docs --fast-rebuild

其它编译
编译测试用例：

./build.sh --export-para PYCACHE_ENABLE:true --product-name rk3568 --ccache --build-target make_test # 所有test
./build.sh --product-name rk3568 --build-target ace_engine_test --fast-rebuild ace_engine # 测试用例编译
./build.sh --product-name rk3568 --build-target form_fwk_test # form_fwk仓库tdd编译。编译顺序：先编sdk和rk3568，然后执行本命令。
./build.sh --export-para PYCACHE_ENABLE:true --product-name rk3568 --ccache --build-target BundleMgrClientSystemTest # 具体模块用例生成
./build.sh product_name=rk3568 suite=acts system_size=standard target_subsystem=appexecfwk # 编译xts用例

编译失败解决：

删除out, rm -rf out
同步代码。确保更新无失败。若某个仓库失败，则单独repo xxxx下载。注意网络繁忙问题，尽量选不拥堵时刻下载
更新工具链：./build/prebuilts_download.sh
更新二进制：repo forall -c "git lfs pull"

5 鸿蒙全仓代码的更新策略

在wsl2中，以下行为可能导致32位全编译失败：

直接在鸿蒙代码根目录下同步最新代码
删除out目录，再更新最新代码
单独仓库的代码更新请使用repo。不要直接使用git。单独仓是没有分支概念，git无法更新。码云的鸿蒙代码是用repo管理的。
说明：
上述做法SDK编译一般是成功，但32位全编译大概率会失败。在排除了电脑配置、网络之后，不清楚原因。如果直接删除鸿蒙根目录下所有文件夹/文件，不包括隐藏文件夹/文件，则大概率会SDK、32位全编译成功。
更新最新代码的前三步（同步代码、拉取二进制、预编译），建议同步跟踪。SDK编译、32位全编，形成多个shell指令，在相对空闲时间段（比如晚上）执行。

6 参考文献

[文献1] OpenHarmony-标准设备系统代码操作梳理-CSDN博客

[文献2] 鸿蒙Docker编译环境
https://docs.openharmony.cn/pages/v3.1/zh-cn/device-dev/get-code/gettools-acquire.md/

[文献3] 蓝区开发环境指导
https://gitee.com/liuyuxiang-bear/git-operation/blob/master/%E8%93%9D%E5%8C%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E6%8C%87%E5%AF%BC.md
[文献4] Openharmony代码编译缺少头文件问题，https://blog.csdn.net/weixin_32669219/article/details/131182393

7 FAQ

7.1 缺头文件xcrusor/xcursor.h

Openharmony代码编译缺少头文件问题，漏安装组件libxcursor-dev等第三方包
现象：
在这里插入图片描述
解决方法：
1） apt-get install libxcursor-dev
2）其它遗漏请参考参考文献4处理

7.2 缺头文件Xinerama.h

Ubuntu-头文件缺失fatal error: ‘X11/extensions/Xinerama.h‘ file not found
现象：
在这里插入图片描述
解决方法：apt-get install libxinerama-dev