OpenHarmony 工具适配：tree 2.2.1 交叉编译与 HNP 打包

OpenHarmony Linux 命令行工具适配实战：基于 Cursor × WSL 的 tree 2.2.1 交叉编译与 HNP 打包

前提准备

通过 Microsoft Store 安装 WSL Ubuntu 24.04：打开微软应用商店，搜索 Ubuntu 并选择最新长期支持版本安装，完成后从开始菜单启动对应终端即可。

WSL Ubuntu 24.04 系统迁移与重构

1. 管理员身份运行 Windows PowerShell 后，先通过 wsl --shutdown 关闭所有 WSL 实例，再强制终止 wslhost 和 wslservice 相关进程，忽略终止失败的错误，等待 30 秒确保进程完全停止，最后用 wsl -l -v 查看当前 WSL 分发版的列表及运行状态。
2. 使用.tar 格式备份系统。
3. 注销原系统释放 C 盘空间。
4. 导入系统到 D 盘。
5. 恢复默认用户。
6. 验证迁移结果。

Linux 开发环境初始化与依赖配置

1. 更换 APT 软件源清华源。
2. 更新软件包。
3. 安装 Python 环境。

OpenHarmony SDK 获取、安装与环境配置

1. 下载 OpenHarmony SDK。
2. 解压 SDK 包。
3. 解压核心组件。
4. 创建鸿蒙软件包安装目录。
5. 获取构建工具，下载鸿蒙构建脚手架。
6. 源码准备与适配，下载 tree 命令鸿蒙适配版源码。
7. 创建适配配置文件，进入源码目录，添加两个关键适配文件 hnp.json 配置文件和 build_ohos.sh 编译脚本。
8. 赋予脚本执行权限，完成基于 Windows 的 WSL 适配鸿蒙 PC 的 Linux 命令行环境配置流程。

OpenHarmony 工具链验证与编译测试

1. 环境验证，在开始编译前，需要验证鸿蒙工具链的完整性。
2. 编译环境测试，创建测试程序验证交叉编译环境 hello_ohos.c。
3. 使用鸿蒙工具链编译（用 OpenHarmony SDK 的 clang 交叉编译 hello_ohos.c，指定 aarch64-OHOS 目标平台、SDK sysroot 路径及 OHOS 宏，生成适配 OpenHarmony 的可执行文件）。
4. 验证生成文件。
5. 环境验证成功：输出显示为 ARM aarch64 架构的鸿蒙可执行文件，证明交叉编译环境已正确配置。开始编译，回到 build 根目录，执行编译命令。

基于 Cursor / VS Code 的鸿蒙适配开发实践

1. 在 WSL 终端中快速在 Windows 中打开 build 文件夹。
2. Cursor 集成开发环境配置：在 VS Code 中打开脚手架文件夹，选择终端为 WSL: Ubuntu-24.04，切换到 WSL 终端进行开发。

OpenHarmony PC 适配：tree 2.2.1 交叉编译与 HNP 打包

1. 修改 build.sh 需要构建的命令行组件名称（OpenHarmony 组件构建初始化脚本，需通过 --sdk 指定 SDK 路径并校验有效性，根据运行系统配置编译工具链与 HNP 相关目录，检查 Python 环境并提供安装指引，导出编译工具、编译选项及构建相关路径等环境变量，创建必要目录后，默认执行 code/cmdtree 目录下的 build_ohos.sh 构建组件，也可通过 BUILD_BY_DEPENDENCY=true 按 dependency.json 构建依赖组件）。
2. code/cmdtree/hnp.json 鸿蒙原生包配置（tree 组件的 HNP 配置文件，指定配置类型为 hnp-config，组件名称为 tree、版本 2.2.1，安装配置留空）。
3. code/cmdtree/build_ohos.sh 构建与打包脚本（脚本定义 tree 组件相关参数，清理旧构建、编译安装组件，拷贝文档与 hnp.json，通过 HNP 工具打包并生成对应版本的 tar.gz 压缩包）。
4. 配置 dependency.json 依赖配置文件（配置文件定义项目依赖组件，明确指定需引入 tree 工具，其源码来源）。