Windows 11 WSL2 高效搭建 OpenHarmony RK3568 开发环境全攻略对于习惯 Windows 系统的开发者来说想要体验 OpenHarmony 的强大功能WSL2 无疑是最佳选择。本文将带你从零开始在 Windows 11 上打造一个高效的 OpenHarmony 开发环境特别针对 RK3568 开发板进行优化配置。1. 环境准备与 WSL2 安装在开始 OpenHarmony 开发之前我们需要确保 Windows 系统满足基本要求。Windows 11 21H2 或更高版本是最佳选择它能提供最稳定的 WSL2 支持。首先检查系统版本winver关键准备工作确保 BIOS 中已启用虚拟化技术Intel VT-x 或 AMD-V至少分配 8GB 内存给 WSL2推荐 16GB 以获得更好的编译体验预留 100GB 以上的磁盘空间OpenHarmony 代码和编译产物会占用大量空间安装 WSL2 的步骤如下以管理员身份打开 PowerShell 执行wsl --install此命令会自动启用必要功能并安装默认的 Ubuntu 发行版重启系统完成安装提示如果遇到网络问题导致 Ubuntu 安装失败可以手动下载发行版包并通过wsl --import命令导入。2. WSL2 系统优化配置默认安装的 WSL2 需要进行一些优化才能充分发挥性能特别是针对 OpenHarmony 的大规模代码编译场景。2.1 迁移 WSL2 到非系统盘默认情况下 WSL2 会安装在系统盘我们可以将其迁移到其他分区# 首先导出当前发行版 wsl --export Ubuntu-20.04 D:\wsl-ubuntu20.04.tar # 然后注销原发行版 wsl --unregister Ubuntu-20.04 # 最后在新位置导入 wsl --import Ubuntu-20.04 D:\wsl\Ubuntu-20.04 D:\wsl-ubuntu20.04.tar --version 22.2 配置阿里云镜像源为了加速软件包下载我们需要将 Ubuntu 的软件源替换为国内镜像sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak sudo sed -i s/archive.ubuntu.com/mirrors.aliyun.com/g /etc/apt/sources.list sudo sed -i s/security.ubuntu.com/mirrors.aliyun.com/g /etc/apt/sources.list sudo apt update sudo apt upgrade -y2.3 内存与交换空间优化在%UserProfile%\.wslconfig文件中添加以下配置[wsl2] memory16GB swap8GB processors83. OpenHarmony 开发环境配置3.1 安装必要依赖工具OpenHarmony 编译需要大量依赖工具建议分批安装以避免超时# 基础编译工具 sudo apt install -y build-essential binutils git git-lfs flex bison gperf # Python 环境 sudo apt install -y python3.8 python3-pip sudo update-alternatives --install /usr/bin/python python /usr/bin/python3 150 # 其他必要工具 sudo apt install -y ccache zlib1g-dev libc6-dev-i386 lib32ncurses5-dev3.2 配置 Git 和 Repogit config --global user.name YourName git config --global user.email your.emailexample.com git config --global credential.helper store # 安装 repo 工具 curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 ~/repo chmod ax ~/repo sudo mv ~/repo /usr/local/bin/4. 获取 OpenHarmony 源码针对 RK3568 开发板我们需要获取特定版本的代码mkdir ~/openharmony cd ~/openharmony repo init -u gitgitee.com:openharmony/manifest.git -b master --no-repo-verify repo sync -c repo forall -c git lfs pull注意代码下载过程可能需要较长时间建议在网络状况良好的情况下进行。5. 编译 RK3568 系统镜像5.1 预编译准备# 在源码根目录执行 bash build/prebuilts_download.sh5.2 完整编译命令针对 RK3568 开发板的编译命令如下./build.sh --product-name rk3568 --target-cpu arm64 --ccache编译过程关键点首次编译可能需要 2-4 小时取决于硬件配置使用--ccache参数可以显著加速后续编译编译过程中如果中断可以尝试继续而不是重新开始5.3 编译产物位置编译完成后系统镜像位于out/rk3568/packages/phone/images/主要镜像文件包括boot.img启动镜像system.img系统镜像vendor.img厂商定制镜像userdata.img用户数据镜像6. 烧写镜像到 RK3568 开发板6.1 准备工作下载 Windows 版烧录工具 RKDevTool安装 USB 驱动包含在 RKDevTool 包中准备 Type-C 数据线连接开发板6.2 烧录步骤开发板断电状态下按住 Recovery 键插入 USB 线连接电脑按下 Reset 键并保持 2 秒在 RKDevTool 中加载编译生成的镜像文件点击执行开始烧录常见问题解决问题现象可能原因解决方案设备未识别驱动未正确安装重新安装驱动并检查设备管理器烧录失败镜像文件损坏重新编译或检查镜像完整性设备无法启动烧录配置错误检查 config.cfg 文件是否正确7. 开发调试技巧7.1 使用 HDC 工具调试HDC 是 OpenHarmony 的调试工具编译后位于out/rk3568/develop_tools/hdc_std常用命令hdc list targets # 列出连接的设备 hdc shell # 进入设备shell hdc file send local remote # 推送文件到设备7.2 串口调试配置使用 USB 转串口工具连接开发板配置串口工具参数波特率1500000数据位8停止位1无校验7.3 测试套执行编译测试套cd test/xts/acts ./build.sh product_namerk3568 system_sizestandard执行测试run acts8. 日常开发效率提升代码缓存配置# 在 ~/.bashrc 中添加 export USE_CCACHE1 export CCACHE_DIR/mnt/c/ccache ccache -M 50G常用快捷命令# 快速编译内核 ./build.sh --product-name rk3568 --build-target kernel --target-cpu arm64 # 单独编译某个模块 ./build.sh --product-name rk3568 --build-target module_name资源监控watch -n 1 free -h; df -h; top -b -n 1 | head -n 15
Windows 11 + WSL2 保姆级教程：手把手带你搞定 OpenHarmony RK3568 开发环境（含阿里源配置与避坑指南）
Windows 11 WSL2 高效搭建 OpenHarmony RK3568 开发环境全攻略对于习惯 Windows 系统的开发者来说想要体验 OpenHarmony 的强大功能WSL2 无疑是最佳选择。本文将带你从零开始在 Windows 11 上打造一个高效的 OpenHarmony 开发环境特别针对 RK3568 开发板进行优化配置。1. 环境准备与 WSL2 安装在开始 OpenHarmony 开发之前我们需要确保 Windows 系统满足基本要求。Windows 11 21H2 或更高版本是最佳选择它能提供最稳定的 WSL2 支持。首先检查系统版本winver关键准备工作确保 BIOS 中已启用虚拟化技术Intel VT-x 或 AMD-V至少分配 8GB 内存给 WSL2推荐 16GB 以获得更好的编译体验预留 100GB 以上的磁盘空间OpenHarmony 代码和编译产物会占用大量空间安装 WSL2 的步骤如下以管理员身份打开 PowerShell 执行wsl --install此命令会自动启用必要功能并安装默认的 Ubuntu 发行版重启系统完成安装提示如果遇到网络问题导致 Ubuntu 安装失败可以手动下载发行版包并通过wsl --import命令导入。2. WSL2 系统优化配置默认安装的 WSL2 需要进行一些优化才能充分发挥性能特别是针对 OpenHarmony 的大规模代码编译场景。2.1 迁移 WSL2 到非系统盘默认情况下 WSL2 会安装在系统盘我们可以将其迁移到其他分区# 首先导出当前发行版 wsl --export Ubuntu-20.04 D:\wsl-ubuntu20.04.tar # 然后注销原发行版 wsl --unregister Ubuntu-20.04 # 最后在新位置导入 wsl --import Ubuntu-20.04 D:\wsl\Ubuntu-20.04 D:\wsl-ubuntu20.04.tar --version 22.2 配置阿里云镜像源为了加速软件包下载我们需要将 Ubuntu 的软件源替换为国内镜像sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak sudo sed -i s/archive.ubuntu.com/mirrors.aliyun.com/g /etc/apt/sources.list sudo sed -i s/security.ubuntu.com/mirrors.aliyun.com/g /etc/apt/sources.list sudo apt update sudo apt upgrade -y2.3 内存与交换空间优化在%UserProfile%\.wslconfig文件中添加以下配置[wsl2] memory16GB swap8GB processors83. OpenHarmony 开发环境配置3.1 安装必要依赖工具OpenHarmony 编译需要大量依赖工具建议分批安装以避免超时# 基础编译工具 sudo apt install -y build-essential binutils git git-lfs flex bison gperf # Python 环境 sudo apt install -y python3.8 python3-pip sudo update-alternatives --install /usr/bin/python python /usr/bin/python3 150 # 其他必要工具 sudo apt install -y ccache zlib1g-dev libc6-dev-i386 lib32ncurses5-dev3.2 配置 Git 和 Repogit config --global user.name YourName git config --global user.email your.emailexample.com git config --global credential.helper store # 安装 repo 工具 curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 ~/repo chmod ax ~/repo sudo mv ~/repo /usr/local/bin/4. 获取 OpenHarmony 源码针对 RK3568 开发板我们需要获取特定版本的代码mkdir ~/openharmony cd ~/openharmony repo init -u gitgitee.com:openharmony/manifest.git -b master --no-repo-verify repo sync -c repo forall -c git lfs pull注意代码下载过程可能需要较长时间建议在网络状况良好的情况下进行。5. 编译 RK3568 系统镜像5.1 预编译准备# 在源码根目录执行 bash build/prebuilts_download.sh5.2 完整编译命令针对 RK3568 开发板的编译命令如下./build.sh --product-name rk3568 --target-cpu arm64 --ccache编译过程关键点首次编译可能需要 2-4 小时取决于硬件配置使用--ccache参数可以显著加速后续编译编译过程中如果中断可以尝试继续而不是重新开始5.3 编译产物位置编译完成后系统镜像位于out/rk3568/packages/phone/images/主要镜像文件包括boot.img启动镜像system.img系统镜像vendor.img厂商定制镜像userdata.img用户数据镜像6. 烧写镜像到 RK3568 开发板6.1 准备工作下载 Windows 版烧录工具 RKDevTool安装 USB 驱动包含在 RKDevTool 包中准备 Type-C 数据线连接开发板6.2 烧录步骤开发板断电状态下按住 Recovery 键插入 USB 线连接电脑按下 Reset 键并保持 2 秒在 RKDevTool 中加载编译生成的镜像文件点击执行开始烧录常见问题解决问题现象可能原因解决方案设备未识别驱动未正确安装重新安装驱动并检查设备管理器烧录失败镜像文件损坏重新编译或检查镜像完整性设备无法启动烧录配置错误检查 config.cfg 文件是否正确7. 开发调试技巧7.1 使用 HDC 工具调试HDC 是 OpenHarmony 的调试工具编译后位于out/rk3568/develop_tools/hdc_std常用命令hdc list targets # 列出连接的设备 hdc shell # 进入设备shell hdc file send local remote # 推送文件到设备7.2 串口调试配置使用 USB 转串口工具连接开发板配置串口工具参数波特率1500000数据位8停止位1无校验7.3 测试套执行编译测试套cd test/xts/acts ./build.sh product_namerk3568 system_sizestandard执行测试run acts8. 日常开发效率提升代码缓存配置# 在 ~/.bashrc 中添加 export USE_CCACHE1 export CCACHE_DIR/mnt/c/ccache ccache -M 50G常用快捷命令# 快速编译内核 ./build.sh --product-name rk3568 --build-target kernel --target-cpu arm64 # 单独编译某个模块 ./build.sh --product-name rk3568 --build-target module_name资源监控watch -n 1 free -h; df -h; top -b -n 1 | head -n 15
