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

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

news 来源：原创 2024/9/29 15:22:04

文章目录

  • 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环境安装

  1. 打开设置->安全和更新->开发者选项，选择为“开发人员模式”；
    在这里插入图片描述
  2. 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下新建目录执行。

  1. 下载鸿蒙编译环境的image
docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/openharmony-docker:1.0.0
  1. 创建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)替换为自定义目录。
  1. 启动实例
docker start ohos
  1. 进入实例
docker exec -it ohos bash

4.2.3 鸿蒙全仓代码拉取编译

  1. 进入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"
  2. 参考下面的《鸿蒙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
  1. 参考下面的《鸿蒙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

相关文章：

  • Spring自定义标签体系和应用
  • 嵌入式软件stm32面试
  • 如何减少sql出现问题
  • MacOS设备远程登录配置结合内网穿透实现异地ssh远程连接
  • k8s及etcd的每日自动备份及故障时的还原脚本
  • windows环境下，怎么查看本机的IP、MAC地址和端口占用情况
  • day64 图论 图论理论基础 深搜 广搜 98. 所有可达路径
  • Java学习 - MySQL视图的练习 实例
  • R语言——数据与运算
  • gitlab仓库中用git bash生成不是默认路径的ssh秘钥
  • TS-RadiMation测试软件如何在序列测试中发挥作用？
  • 【机械键盘调整灯光】腹灵MK870说明书（个人备用）
  • 操作系统期末快速复习（概念）
  • windows系统停止更新办法
  • Matlab基础语法：变量和数据类型，基本运算，矩阵和向量，常用函数，脚本文件
  • 分享的文章《人生如棋》
  • CentOS7 安装JDK
  • spring boot 整合mybatis 无法输出sql的问题
  • SpringBoot几种定时任务的实现方式
  • TypeScript迭代器
  • vue脚手架vue-cli
  • 回流、重绘及其优化
  • 面试题：给你个id，去拿到name，多叉树遍历
  • 入门到放弃node系列之Hello Word篇
  • 实习面试笔记
  • 实战｜智能家居行业移动应用性能分析
  • 使用 @font-face
  • 移动互联网+智能运营体系搭建=你家有金矿啊！
  • #我与Java虚拟机的故事#连载08：书读百遍其义自见
  • $HTTP_POST_VARS['']和$_POST['']的区别
  • (09)Hive——CTE 公共表达式
  • （23）mysql中mysqldump备份数据库
  • （C语言）fread与fwrite详解
  • （超简单）构建高可用网络应用：使用Nginx进行负载均衡与健康检查
  • （附源码）spring boot球鞋文化交流论坛 毕业设计 141436
  • （附源码）ssm高校运动会管理系统 毕业设计 020419
  • (附源码)计算机毕业设计ssm本地美食推荐平台
  • （原创）可支持最大高度的NestedScrollView
  • （转）c++ std::pair 与 std::make
  • .FileZilla的使用和主动模式被动模式介绍
  • .gitattributes 文件
  • .net core 6 使用注解自动注入实例，无需构造注入 autowrite4net
  • .NET MVC之AOP
  • .NET 将混合了多个不同平台（Windows Mac Linux）的文件 目录的路径格式化成同一个平台下的路径
  • .NET/C# 使用 ConditionalWeakTable 附加字段（CLR 版本的附加属性，也可用用来当作弱引用字典 WeakDictionary）
  • .NET/C# 使用反射调用含 ref 或 out 参数的方法
  • .Net程序帮助文档制作
  • .NET单元测试使用AutoFixture按需填充的方法总结
  • @Transaction注解失效的几种场景（附有示例代码）
  • [ Algorithm ] N次方算法 N Square 动态规划解决
  • [ JavaScript ] JSON方法
  • [Algorithm][动态规划][两个数组的DP][正则表达式匹配][交错字符串][两个字符串的最小ASCII删除和][最长重复子数组]详细讲解
  • [C#学习笔记]LINQ
  • [C/C++]数据结构 栈和队列()
  • [C++] 从零实现一个ping服务