文章目录
- 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