[OpenHarmony6.0][Docker][环境]OHOS6 编译环境构建指南
T. 已测试目录
| 主机类型 | 主机版本 | Docker镜像版本 | 结果 |
|---|---|---|---|
| WSL2 | Ubuntu22.04 | Ubuntu20.04 | PASS |
| WSL2 | Ubuntu22.04 | Ubuntu18.04 | PASS |
| 服务器 | Ubuntu24.04 | Ubuntu20.04 | PASS |
R. 软硬件要求：
- 硬件：
| 设备 | 容量 | 备注 |
|---|---|---|
| 硬盘 | >500G | 多版本系统测试，必须固态，否则编译卡死 |
| 硬盘 | >300G | 单系统开发，必须固态，否则编译卡死 |
| 内存 | >25G | 物理机 |
| 内存 | >32G | WSL2 |
- 软件：
安装好Docker的Linux发行版。
如果你使用的是WSL2，请不要将源码存放在NTFS文件系统的目录中！！
应该把WSL2进行迁移之后，下载源码到Linux的EXT4文件系统的目录下！用户目录之类的都可以！
WSL2迁移可以参考：[WSL][教程]WSL2系统迁移到其他盘以及其他电脑教程
0. 制作过程
如果你想知道这个镜像是如何制作的，请看下面的教程，如果你只想拿到镜像。那就往下看就好了
链接：[OpenHarmony5.0][Docker][教程]OpenHarmony5.0编译环境基于WSL2封装Docker镜像教程
1. 获取源码
源码下载请参考：OHOS_5.0中的[源码下载]章节，建议使用repo下载。
拉取源码之前，请先按照拉取源码前提条件安装需要的依赖工具。
并且，创建如下的目录层级：[Home/OHOS6/OpenHarmony]，在OpenHarmony文件夹中执行repo的init，用repo拉取源码
6.0 请使用tag方式拉取，最新的源码有问题编译不过。
拉取完成之后应该如下目录
2. 获取镜像
获取镜像有两种方式：
-
Docker Hub及其镜像站获取。（本篇）
不需要源码的话直接往下面看就可以了。下面是构建源码的链接：
Gitee Dockerfile源码：openharmony_5.x_docker_env Issue和PR请在Gitee上提交~
Github Dockerfile源码：openharmony_5.x_docker_env
如果有用，辛苦麻烦给个Star喽~
3. 拉取镜像
Docker的安装请参照其他教程，较为简单，这里不再赘述
sudo docker pull taxuevernon/openharmony_5.x_docker_env:5.0
6.0 可以直接用5.0的环境编译。
如果你的网络环境拉取不下来，**请自己找国内镜像源替代。**具体如何替代自行查阅。
看一下镜像
4. 运行容器
启动的时候要顺便把源码通过Volume映射到Ubuntu里面
下面的
-v内容一定要特别注意！！！你的映射必须要到源码的上一级目录，把源码再加一层文件夹，也就是说你要映射为如下结构！！！
OHOS6/（应该映射的是这一层，也就是`-v`参数后面写的东西，映射到Docker里也应该是这个层级）├── OpenHarmony （源码真正存放的目录）├── openharmony_prebuilts （如果你是repo同步源码，这个东西后面才会有）
sudo docker run --name openharmony_5.x_docker_env -ti -v /mnt/OhosDisk/OHOS6:/home/taxue/ -p 10022:22 taxuevernon/openharmony_5.x_docker_env:5.0 /bin/bash
5. 安装hb构建工具
先进入源码目录：
cd /home/taxue/OpenHarmony
再安装：
python3 -m pip install --user build/hb
PATH我已经提前写好，不用更新。
6. 准备编译
先进入源码根目录
cd /home/taxue/OpenHarmony
6.1 clean
执行一次clean
hb clean
6.2 预编译工具
需要为你的下载的源码重新过一下编译工具
bash build/prebuilts_download.sh
一般npm每次都要重新安装的
6.3 拉取最新源码（选做）
如果你在获取源码的时候就是使用的repo，那么你可以跳过本节。一般来说不需要执行
拉取最新代码
repo sync -c
6.4 开始编译
参考链接：编译
6.4.1 脚本方式编译
6.0两个都可以使用，后者会新一点
sudo dpkg-reconfigure dash # 选择no
./build.sh -p rk3568
6.4.2 hb方式编译
源码根目录执行
hb set
之后按照你自己的板子进行选择
然后就可以进行编译了
hb build -f # 全量编译
hb build # 增量编译
6.5 编译结果
F. 参考
[OpenHarmony5.0][Docker][教程]OpenHarmony5.0编译环境基于WSL2封装Docker镜像教程