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

已于 2024-07-04 10:28:32 修改
阅读量981 收藏 20
点赞数 16
分类专栏： linux 文章标签： OpenHarmony 环境 wsl
于 2024-06-17 10:42:29 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/lhb_0531/article/details/139736661
版权

文章目录

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盘，在后续开发过程中鸿蒙全仓代码总容量会超过500G，因此需要把它迁移到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 鸿蒙全仓代码的更新策略

建议：删除鸿蒙根目录下所有文件夹/文件，重新走代码同步流程。更新周期建议10天一次。每次耗时预计12小时。
在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

钱塘江渔夫
关注
专栏目录
使用docker搭建鸿蒙开发环境
海阔天空
08-20 1026
第一步下载docker https://docs.docker.com/engine/install/ windows 版本https://desktop.docker.com/win/stable/amd64/Docker%20Desktop%20Installer.exe 第二步安装docker 安装docker desktop之后，需要依赖wsl2.0. 升级wsl kernal到2.0https://wslstorestorage.blob.core.windows.net/wslblo.
WSL2 及 docker开发环境搭建
qq_41816308的博客
07-08 680
wsl2 及 docker开发环境搭建
鸿蒙系统开发之编译指南（官网开发文档+docker环境方式）
zhoubiaodi的博客
10-10 2619
开发指南文档最新链接
2024年鸿蒙最新面向开发人员的WSL：安装Android SDK_wsl2 安装 android sdk(1)，app中内嵌h5页面是怎么实现的
2401_84872028的博客
05-10 625
您可能知道 Android 开发需要安装 JDK 和 Gradle。让我们完成这件事。如果需要，您可以安装 OpenJDK 11，对我而言，两者都没有遇到任何问题。
在本地windows中利用wsl2部署docker应用
最新发布
m0_62177801的博客
06-30 3100
如何将应用部署到docker中
鸿蒙环境准备windows篇（四）wsl
pjie131_的博客
04-08 430
wsl下运行ubuntu
Windows10安装WSL2 Ubuntu20.04并设置docker环境的方法
09-29
在本文中，我们将详细探讨如何在Windows 10上安装WSL2（Windows Subsystem for Linux 2）以及Ubuntu 20.04，并进一步设置Docker环境。这对于开发者来说是一个非常实用的过程，因为它允许在Windows环境下运行原生的...
wsl-update-x64(docker需要环境更新程序).zip
03-13
标题中的“wsl-update-x64(docker需要环境更新程序).zip”指的是针对Windows Subsystem for Linux (WSL) 的一个特定更新程序，这个更新可能是为了优化Docker在WSL环境下的运行。Docker是一个开源的应用容器引擎，它...
wsl2安装教程 wsl2下交叉编译软件的安装、踩坑过程 以及拿vscode连接wsl2
06-04
wsl2下交叉编译软件的安装、踩坑过程 以及拿vscode连接wsl2 代码写的是一个简单的C语言程序，每个0.60006秒输出一次hello wrold 参考了很多网上大家的做法，因此也把自己的踩坑过程放在网上，供大家参考。
OpenHarmony鸿蒙docker编译环境搭建
w5678912345的专栏
05-18 2421
OpenHarmony docker环境的搭建
2024年HarmonyOS鸿蒙最全安装dockercompose，你值得拥有_小米安装 docker compose(6)，2024年最新记得把每一次面试当做经验积累
2401_84853335的博客
05-14 372
多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新**
安装dockercompose，你值得拥有
m0_56144365的博客
07-14 273
01 源码分析 源码阅读，最核心有三点：技术基础+强烈的求知欲+耐心。 1.1 设计模式（45设计模式：介绍+优缺点+应用实例+源代码+解决问题） 1.2 Spring复习大纲：依赖注入Ioc+Beans+注解+数据访问+AOP+MVC等 1.3 Spring全家桶笔记：Spring+Spring Boot+Spring Cloud+Spring MVC 面试题（含解析）+学习书籍+学习思维脑图 02 分布式架构 近几年目前分布式最主流的技术： 2.1 大规模分布式存储系统：原理解析与架构实战（
2024年鸿蒙最新Docker 在 openSUSE 下的安装、使用_docker 拉取 opensuse(1)，2024年最新软件开发面试技巧
2401_84862025的博客
05-15 474
上述命令不会卸载 images、containers、volumes, 或者用户创建在主机的配置文件。可以将 Docker Bub 存储的 image 拉取到本地，执行。用户创建在主机的配置文件需手动删除。命名的用户组，添加用户到这个用户组。docker 会创建一个以。
1 利用docker构建编译环境
dongzengwu的专栏
07-01 838
利用docker构建编辑环境是最快捷建立openhomony代码编译环境。 建立步骤参考华为官网，现摘录如下： 1）独立Docker环境 HarmonyOS的Docker镜像托管在HuaweiCloud SWR上。开发者可以通过该镜像在很大程度上简化编译前的环境配置。开发者在配置好开发环境后，通过以下步骤来使用Docker环境。本Docker支持Ubuntu/Windows平台，下文将以Ubuntu系统为例进行使用介绍。 搭建Docker环境-轻量系统类设备（参考内存≥128KB）和小型系统类设
OpenHarmony 实战开发——南向统一编译的docker镜像来了
m0_70748458的博客
05-09 629
本文为OpenHarmony的Docker编译环境使用指导。OpenHarmony的Docker镜像托管在上，开发者可以通过该镜像在很大程度上简化编译前的环境配置。Docker镜像仓库标签说明1.0.0已经预安装OpenHarmony版本的编译环境。
【异常错误】WSL2设置为全核cpu和全部内存
MOL
10-05 5404
今天偶尔发现 WSL占用的内存是真实内存的一半（通过htop命令查看即可）# 限制最大使用cpu个数,如果不设置，默认是使用全部的核心。swap=20G # 限制最大使用虚拟内存。memory=65536MB # 限制最大使用内存。并运行进入用户文件夹,
扩展WSL2虚拟硬盘的大小
张登雨的博客
03-05 1273
扩展wsl2的大小
使用docker安装mindspore1.3.0
weixin_45666880的博客
08-08 452
运行： docker run -it -v /dev/shm:/dev/shm --runtime=nvidia --privileged=true swr.cn-south-1.myhuaweicloud.com/mindspore/mindspore-gpu:1.3.0 /bin/bash。使用docker安装mindspore1.3还需要限制cuda版本？1.3只提供了cuda11.1版本，想装cuda10的可以用1.5。...
如何给WSL 2扩容硬盘（即扩展虚拟大小）？
地理信息系统、摄影测量与遥感、人工智能
02-20 6701
WSL 2 会自动调整这些 VHD 文件的大小以满足存储需求。 默认情况下，WSL 2 默认安装只会给到1T的硬盘空间，老版本甚至只有512G（ WSL 版本 0.58.0之前），更老的版本只有256G，如何给WSL 2扩容硬盘？
wsl2 docker 交叉编译
07-14
### 回答1： WSL2和Docker都是开发者常用的工具，用于在Windows操作系统上进行开发和容器化部署。而在WSL2中使用Docker时，可能需要进行交叉编译，以便在WSL2环境下构建和运行适用于不同操作系统的程序。下面是关于WSL2和Docker交叉编译的一些重要信息： 1. WSL2是一种提供在Windows操作系统上运行Linux发行版的功能强大的子系统。它提供了更好的Linux内核兼容性和更高的性能。 2. Docker是一种用于将应用程序打包为独立的容器并进行部署的开源平台。它能够在不同的操作系统上运行，如Linux、Windows和Mac。 3. 在WSL2中使用Docker进行交叉编译时，可以通过设置适当的环境变量来指定编译目标操作系统。例如，可以使用`export GOOS=linux`来指定编译目标为Linux操作系统。 4. 此外，还可以使用Docker的多阶段构建功能来进行交叉编译。通过在Dockerfile中定义多个构建阶段，并在不同的阶段中设置不同的编译环境和目标操作系统，可以实现更灵活和高效的交叉编译过程。 5. 在交叉编译时，还需要注意程序依赖的库和组件是否与目标操作系统兼容。可以使用Docker镜像中的适当环境来构建和验证编译结果。 总之，WSL2和Docker的结合为开发者提供了更好的跨平台开发和部署体验。通过正确设置环境变量和使用Docker的多阶段构建功能，可以在WSL2中轻松实现交叉编译，并将应用程序部署到不同的操作系统中。 ### 回答2： WSL2是Windows Subsystem for Linux 2的缩写，它是Windows 10中的一个子系统，允许用户在Windows操作系统上运行Linux二进制文件。Docker是一个容器平台，可以提供快速、可靠和可重复部署的环境。交叉编译是指将代码从一种操作系统或体系结构编译为另一种操作系统或体系结构的过程。 在WSL2中使用Docker进行交叉编译可以方便地将代码编译成其他平台上可运行的二进制文件。下面是一些步骤： 1. 确保已经在WSL2中安装了Docker。可以通过在终端中运行`docker version`命令来检查Docker是否正确安装和配置。 2. 在WSL2中创建一个目录，用于存放交叉编译的代码。可以使用`mkdir`命令创建一个新目录。 3. 进入该目录，并将需要交叉编译的代码复制到该目录中。可以使用`cp`命令复制文件或文件夹。 4. 在WSL2中运行Docker容器。可以使用`docker run`命令来启动一个容器，并指定所需的镜像。例如，可以使用`docker run -it ubuntu`命令来启动一个Ubuntu的容器。 5. 在Docker容器中安装所需的交叉编译工具。可以使用容器的包管理工具，如apt-get或yum，来安装所需的工具。 6. 使用安装在容器中的交叉编译工具来编译代码。可以在容器的终端中运行适当的编译命令，例如`gcc`或`make`命令。 7. 将交叉编译后的二进制文件复制到WSL2主机上。可以使用`docker cp`命令将文件从容器复制到WSL2文件系统中。例如，可以使用`docker cp <容器ID>:/path/to/binary /path/on/host`命令。 通过以上步骤，我们可以在WSL2中使用Docker进行交叉编译，并将编译后的二进制文件复制回到WSL2主机上使用。这样可以方便地进行跨平台开发和部署。 ### 回答3： WSL2是Windows Subsystem for Linux的第二代版本，它允许在Windows系统上运行Linux操作系统和应用程序。 Docker是一个开源的容器化平台，可以通过容器来打包应用程序及其所有的依赖项，实现简化部署和跨平台运行。 交叉编译是在一种平台上为另一种平台生成可执行文件或库的过程。在使用WSL2和Docker进行交叉编译时，我们可以利用WSL2提供的Linux环境来进行编译，从而为其他平台生成可执行文件或库。 首先，我们需要在WSL2中安装Docker，并确保WSL2和Windows主机之间的网络连接正常。然后，我们可以使用WSL2中的Linux终端，使用Docker命令来拉取相应的交叉编译镜像，例如x86_64-w64-mingw32-gcc镜像用于编译Windows平台的可执行文件。 接下来，我们可以在WSL2中创建一个工作目录，并将需要交叉编译的源代码和相关的依赖项复制到该目录中。然后，使用Docker命令来运行交叉编译镜像，并在容器中进行编译。 在容器中，我们可以使用适当的交叉编译工具链来编译源代码，生成针对目标平台的可执行文件或库。编译完成后，我们可以将生成的可执行文件或库从容器中复制到WSL2主机上。 在整个交叉编译过程中，我们可以充分利用WSL2和Docker的优势，使用更多的Linux工具和环境，并保持与Windows主机的良好集成和通信。 总结起来，通过使用WSL2和Docker进行交叉编译，我们可以方便地在Windows系统上为其他平台生成可执行文件或库，并提高开发和部署的灵活性和效率。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值