原文链接：环境搭建 - openharmony学习
环境搭建
搭建WSL环境
自动安装
在管理员模式下打开 PowerShell 或 Windows 命令提示符，方法是右键单击并选择“以管理员身份运行”，输入 wsl --install 命令，然后重启计算机。1
wsl --install
手动安装
- 步骤 1 - 启用适用于 Linux 的 Windows 子系统
- 步骤 2 - 检查运行 WSL 2 的要求
- 步骤 3 - 启用虚拟机功能
- 步骤 4 - 下载 Linux 内核更新包
- 步骤 5 - 将 WSL 2 设置为默认版本
- 步骤 6 - 安装所选的 Linux 分发
为简单起见，通常建议使用 wsl --install 安装适用于 Linux 的 Windows 子系统，但如果运行的是旧版 Windows，则可能不支持这种方式。 下面介绍了手动安装步骤。 如果在安装过程中遇到问题，请查看疑难解答指南的安装部分。2
步骤 1 - 启用适用于 Linux 的 Windows 子系统
需要先启用“适用于 Linux 的 Windows 子系统”可选功能，然后才能在 Windows 上安装 Linux 分发。
以管理员身份打开 PowerShell（“开始”菜单 >“PowerShell” >单击右键 >“以管理员身份运行”），然后输入以下命令：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
建议现在转到步骤 #2，更新到 WSL 2，但如果只想安装 WSL 1，现在可以重新启动计算机，然后继续执行步骤 6 - 安装所选的 Linux 发行版。 若要更新到 WSL 2，请等待重新启动计算机，然后继续执行下一步。
步骤 2 - 检查运行 WSL 2 的要求
若要更新到 WSL 2，需要运行 Windows 10。
- 对于 x64 系统：版本 1903 或更高版本，内部版本为 18362.1049 或更高版本。
- 对于 ARM64 系统：版本 2004 或更高版本，内部版本为 19041 或更高版本。或 Windows 11。
!!! 备注 低于 18362 的版本不支持 WSL 2。 使用 Windows Update 助手更新 Windows 版本。 Windows 版本 1903 支持也仅适用于 x64 系统。 如果使用的是 Arm64 版本的 Windows，则需要升级到 Windows 10 版本 2004 或更高版本才能完全访问 WSL 2。 有关详细信息，请参阅WSL 2 即将支持 Windows 10 版本 1903 和 1909。
若要检查 Windows 版本及内部版本号，选择 Windows 徽标键 + R，然后键入“winver”，选择“确定”。 更新到“设置”菜单中的最新 Windows 版本。
!!! 备注 如果运行的是 Windows 10 版本1903 或 1909，请在 Windows 菜单中打开“设置”，导航到“更新和安全性”，然后选择“检查更新”。 内部版本号必须是 18362.1049+ 或 18363.1049+，次要内部版本号需要高于 .1049。 阅读详细信息：WSL 2 即将支持 Windows 10 版本 1903 和 1909。
步骤 3 - 启用虚拟机功能
安装 WSL 2 之前，必须启用“虚拟机平台”可选功能。 计算机需要虚拟化功能才能使用此功能。
以管理员身份打开 PowerShell 并运行：
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
重新启动计算机，以完成 WSL 安装并更新到 WSL 2。
步骤 4 - 下载 Linux 内核更新包
Linux 内核更新包会安装最新版本的 WSL 2 Linux 内核，以便在 Windows 操作系统映像中运行 WSL。
-
下载最新包：
-
运行上一步中下载的更新包。(双击以运行 - 系统将提示你提供提升的权限，选择“是”以批准此安装。)
安装完成后，请继续执行下一步 - 在安装新的 Linux 分发时，将 WSL 2 设置为默认版本。(如果希望将新的 Linux 安装设置为 WSL 1，请跳过此步骤。)
!!! 备注 有关详细信息，请参阅 Windows 命令行博客上的文章对更新 WSL2 Linux 内核的更改。
步骤 5 - 将 WSL 2 设置为默认版本
打开 PowerShell，然后在安装新的 Linux 发行版时运行以下命令，将 WSL 2 设置为默认版本：
wsl --set-default-version 2
步骤 6 - 安装所选的 Linux 分发
打开 Microsoft Store，并选择你偏好的 Linux 分发版。
导入openharmony编译镜像发行版
!!! 备注 操作前提:拥有一个Linu发行版，并正确安装docker!
拉取镜像
docker pull swr.cn-south-1.myhuaweicloud.com/openharmony-docker/docker_oh_small:3.2
运行镜像,导出镜像为rar
# 运行镜像
docker run -itd --name ohos swr.cn-south-1.myhuaweicloud.com/openharmony-docker/docker_oh_small:3.2 /bin/bash
# 查看容器ID
docker ps -a
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
43fd141410dd swr.cn-south-1.myhuaweicloud.com/openharmony-docker/docker_oh_mini:3.2 "/bin/bash" 2 weeks ago Exited (255) 2 weeks ago ohos
# 导出为rar
docker export 43fd141410dd > /mnt/d/ohos.tar
将 tar 文件导入 WSL
wsl --import ohos E:\ohos .\ohos.tar
!!! 注意
ohos --wsl发行版名称(可自定义) E:\ohos --wsl发行版硬盘路径(可自定义) .\ohos.tar --rar文件路径
打开PowerShell通过wsl -d ohos进入镜像
获取openharmony源码
!!! 备注 这里只介绍通过repo的方式获取v4.0Release源码，其他方式参考官方文档
从版本发布Tag节点获取源码。可获取与版本发布时完全一致的源码。
mkdir openharmony && cd openharmony
repo init -u https://gitee.com/openharmony/manifest -b refs/tags/OpenHarmony-v4.0-Release --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'
安装hb编译工具
# 卸载
pip uninstall ohos-build
# 安装
pip3 install --user build/hb
补全编译子系统
./build/
- 验证hb工具
hb set
hb是OpenHarmony为了方便开发者进行代码构建编译，提供的python脚本工具，其源码就在//build/lite仓库目录下。在执行hb set命令时，脚本会遍历
//vendor/<product_company>/<product_name>目录下的config.json，给出可选产品编译选项。在config.json文件中，product_name表示产品名，device_company和board用于关联出//device/board/<device_company>/<board>目录，匹配该目录下的<any_dir_name>/config.gni文件，其中<any_dir_name>目录名可以是任意名称，但建议将其命名为适配内核名称（如：liteos_m、liteos_a、linux）。hb命令如果匹配到了多个config.gni，会将其中的kernel_type和kernel_version字段与vendor/<device_company>下config.json文件中的字段进行匹配，从而确定参与编译的config.gni文件。3
调试及下载工具下载
串口工具
下载地址: 串口工具
!!! warning "注意" 自建镜像流量昂贵，请勿刷流量
下载工具
下载地址: STM32CubeProg
下载示例：
- 选择连接器
- 选择连接器方式
- 选择镜像文件
- 下载
下载成功会有提示
