Windows平台搭建OpenHarmony开发环境全攻略-代码聚汇网

Windows平台搭建OpenHarmony开发环境全攻略

赖黹

1. 为什么选择Windows平台搭建OpenHarmony开发环境

作为一名长期在Windows平台工作的开发者，我最近需要为OpenHarmony系统开发一些功能模块。虽然官方文档主要推荐Ubuntu环境，但考虑到团队协作和开发习惯的统一性，我决定尝试在Windows 10上搭建完整的OpenHarmony开发环境。这个决定主要基于以下几个实际考量：

首先，我们团队现有的CI/CD流水线都是基于Windows Server构建的，如果要切换到Linux环境需要重新配置大量基础设施。其次，团队成员的开发机器清一色都是Windows系统，强制切换系统会导致学习成本陡增。最重要的是，经过测试发现通过WSL2（Windows Subsystem for Linux）完全可以满足OpenHarmony的编译需求。

提示：虽然官方推荐Ubuntu，但Windows+WSL2方案在实际开发中完全可行，特别是对于已经熟悉Windows生态的团队。

2. 环境准备与基础组件安装

2.1 系统要求检查

在开始之前，需要确保你的Windows系统满足以下最低要求：

Windows 10 版本2004或更高（建议21H2）
至少16GB内存（编译过程非常吃内存）
100GB可用磁盘空间（源码和编译产物占用较大）
启用BIOS中的虚拟化支持（VT-x/AMD-V）

可以通过运行winver命令查看Windows版本，在任务管理器"性能"选项卡中确认虚拟化已启用。

2.2 安装和配置WSL2

WSL2是本次环境搭建的核心组件，安装步骤如下：

以管理员身份打开PowerShell，运行：

powershell复制dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

重启计算机后，将WSL2设为默认版本：
```
powershell复制wsl --set-default-version 2
```
从Microsoft Store安装Ubuntu 20.04 LTS
启动Ubuntu完成初始化设置（创建用户名和密码）

安装完成后，建议进行以下优化配置：

修改WSL内存限制（在%USERPROFILE%\.wslconfig中添加）：

code复制[wsl2]
memory=12GB
swap=4GB
localhostForwarding=true

2.3 安装必要工具链

在Ubuntu子系统中执行以下命令安装基础工具：

bash复制sudo apt update && sudo apt upgrade -y
sudo apt install -y git python3.8 python3-pip curl unzip
sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.8 1

特别需要注意的是，OpenHarmony对Python版本有严格要求，必须使用3.7-3.9版本，不兼容Python 3.10+。

3. 获取OpenHarmony源码与工具

3.1 配置repo工具

OpenHarmony使用repo管理多仓库代码，需要先配置git和repo：

bash复制git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > /usr/local/bin/repo
chmod a+x /usr/local/bin/repo
pip3 install -i https://pypi.tuna.tsinghua.edu.cn/simple requests

3.2 下载源码

选择适合的OpenHarmony版本（这里以3.2 Release为例）：

bash复制mkdir ~/openharmony && cd ~/openharmony
repo init -u https://gitee.com/openharmony/manifest.git -b OpenHarmony-3.2-Release --no-repo-verify
repo sync -c -j8

下载过程视网络情况可能需要1-3小时。如果中断，可以重复执行repo sync命令继续。

3.3 安装编译工具hb

OpenHarmony提供了hb工具来简化编译流程：

bash复制pip3 install --user build/lite

将hb加入PATH环境变量：

bash复制echo 'export PATH=~/.local/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

4. 编译与烧写配置

4.1 选择开发板型号

OpenHarmony支持多种开发板，这里以Hi3861为例：

bash复制hb set

在交互界面中选择wifiiot_hispark_pegasus。

4.2 开始编译

执行完整编译：

bash复制hb build -f

首次编译会下载各种工具链和依赖，可能需要较长时间（2-4小时取决于网络和机器性能）。编译成功后，输出文件位于：

code复制out/hispark_pegasus/wifiiot_hispark_pegasus/

4.3 Windows下的烧写工具

虽然编译在WSL中完成，但烧写通常需要在Windows环境下进行：

下载HiBurn工具（华为提供的烧写工具）
安装CH340G USB转串口驱动
连接开发板后，在HiBurn中选择生成的.bin文件进行烧写

注意：WSL2目前对USB设备支持不完善，建议烧写步骤在原生Windows环境下完成。

5. 开发环境优化技巧

5.1 VS Code远程开发配置

使用VS Code的Remote-WSL插件可以极大提升开发效率：

在Windows上安装VS Code
安装"Remote - WSL"扩展
通过code .命令在WSL中启动VS Code

这样可以在Windows下使用熟悉的IDE，同时实际运行环境在WSL中。

5.2 加速repo sync的小技巧

国内访问gitee有时不稳定，可以修改repo的URL为镜像源：

bash复制export REPO_URL='https://mirrors.ustc.edu.cn/aosp/git-repo'

5.3 常见问题排查

问题1：内存不足导致编译失败
症状：编译过程中WSL突然退出
解决：增加WSL内存限制（见2.2节），或尝试分模块编译

问题2：Python版本冲突
症状：hb命令报错关于Python版本
解决：确保使用python3.8，并正确设置alternatives

问题3：repo sync卡住
症状：长时间停留在某个仓库的下载
解决：Ctrl+C中断后，单独同步该仓库：

bash复制repo sync -c 仓库路径 -j4

6. 实际开发中的经验分享

经过几个月的实际项目开发，我总结出以下几点关键经验：

增量编译：开发过程中不需要每次都hb build -f，修改单个组件后可以直接到该组件目录下执行make，大幅节省编译时间。
调试技巧：对于Hi3861这类IoT设备，建议使用hilog打印日志，并通过串口工具（如Putty）实时查看输出。
代码导航：由于OpenHarmony代码量大，建议使用VS Code的C/C++扩展提供代码智能提示，需要正确配置c_cpp_properties.json文件。
资源管理：WSL2的磁盘性能不如原生Linux，建议将源码放在WSL文件系统内（如~/openharmony），而不是Windows挂载目录（如/mnt/c/）。
备份策略：完整编译一次环境需要数小时，建议在环境配置好后对WSL子系统进行导出备份：
```
powershell复制wsl --export Ubuntu-20.04 openharmony_env.tar
```

这套环境已经支撑我们团队完成了多个OpenHarmony组件的开发工作，虽然初期搭建过程有些曲折，但稳定后的开发体验相当流畅。对于长期在Windows环境下工作的团队，这个方案既能满足OpenHarmony的开发需求，又避免了切换开发环境的阵痛。