在 Ubuntu 24.04 上搭建 OpenHarmony（鸿蒙）PC 命令行移植开发环境

个人首页： VON
鸿蒙系列专栏：鸿蒙开发小型案例总结
综合案例：鸿蒙综合案例开发
鸿蒙6.0：从0开始的开源鸿蒙6.0.0
鸿蒙5.0：鸿蒙5.0零基础入门到项目实战
Electron适配开源鸿蒙专栏：Electron for OpenHarmony
Flutter 适配开源鸿蒙专栏：Flutter for OpenHarmony

前言

本文面向希望在 Ubuntu 24.04 系统上进行 OpenHarmony（鸿蒙）命令行工具移植的开发者。由于部分教程仍基于 Ubuntu 22.04 编写，在新版系统中会遇到如 libltdl7-dev 包名变更等问题。本指南已针对 Ubuntu 24.04 的兼容性问题完成修正，并配以实际操作截图，助你顺利搭建开发环境。

1. 安装常见依赖工具

首先更新软件源：

bash 复制代码

# 更新软件源
sudo apt update

接着安装必备开发工具。注意：Ubuntu 24.04 中 libltdl7-dev 已被移除 ，应使用 libltdl-dev 替代。

原始命令（适用于 Ubuntu 22.04）：

plain 复制代码

sudo apt install -y curl git vim gcc g++ make pkg-config autoconf automake patch libtool autopoint gperf tcl8.6-dev wget unzip gccgo-go flex bison premake4 python3 python3-pip ninja-build meson sox gfortran subversion build-essential module-assistant gcc-multilib g++-multilib libltdl7-dev cabextract libboost-all-dev libxml2-utils gettext libxml-libxml-perl libxml2 libxml2-dev libxml-parser-perl texinfo xmlto po4a libtool-bin yasm nasm xutils-dev libx11-dev xtrans-dev

执行时会报错，如下图所示：

✅ 修正后的完整安装命令（适用于 Ubuntu 24.04）：

bash 复制代码

sudo apt install -y curl git vim gcc g++ make pkg-config autoconf automake patch libtool autopoint gperf tcl8.6-dev wget unzip gccgo-go flex bison premake4 python3 python3-pip ninja-build meson sox gfortran subversion build-essential module-assistant gcc-multilib g++-multilib cabextract libboost-all-dev libxml2-utils gettext libxml-libxml-perl libxml2 libxml2-dev libxml-parser-perl texinfo xmlto po4a libtool-bin yasm nasm xutils-dev libx11-dev xtrans-dev libltdl-dev

安装完成后效果如下：

2. 下载 OpenHarmony SDK

创建并进入工作目录：

bash 复制代码

# 创建鸿蒙 PC 命令行移植的工作目录
mkdir ~/harmonypc

# 进入工作目录
cd ~/harmonypc

下载官方 SDK（文件较大，请耐心等待）：

bash 复制代码

# 下载 OHOS SDK
wget https://cidownload.openharmony.cn/version/Master_Version/ohos-sdk-full_ohos/20250819_020817/version-Master_Version-ohos-sdk-full_ohos-20250819_020817-ohos-sdk-full_ohos.tar.gz

下载过程如下图：

解压主 SDK 包：

bash 复制代码

# 解压 OHOS SDK
tar xf version-Master_Version-ohos-sdk-full_ohos-20250819_020817-ohos-sdk-full_ohos.tar.gz

解压后目录结构如下：

进入 linux 子目录，解压 native 和 toolchains 两个关键组件：

bash 复制代码

cd ~/harmonypc/ohos-sdk/linux/

# 解压 native（含 Clang 编译器）
unzip -q native-linux-x64-6.0.0.46-Beta1.zip

# 解压 toolchains（含签名等工具）
unzip -q toolchains-linux-x64-6.0.0.46-Beta1.zip

解压完成后可用 ls 查看内容：

3. 配置环境变量

设置 OHOS_SDK 环境变量，指向 SDK 的 Linux 目录：

bash 复制代码

# 设置 OHOS_SDK 环境变量
export OHOS_SDK=~/harmonypc/ohos-sdk/linux

验证两个核心工具是否存在：

bash 复制代码

ls $OHOS_SDK/native/llvm/bin/clang
ls $OHOS_SDK/toolchains/lib/binary-sign-tool

正常应输出文件路径，如下图所示：

为使环境变量永久生效，将其写入 shell 配置文件：

bash 复制代码

echo 'export OHOS_SDK=~/harmonypc/ohos-sdk/linux' >> ~/.`basename $SHELL`rc

✅ 此命令会自动适配 bash 或 zsh，无需手动判断。

4. 下载并构建 lycium_plusplus 示例项目

克隆构建框架仓库：

bash 复制代码

# 进入工作目录
cd ~/harmonypc

# 下载 lycium_plusplus
git clone https://gitcode.com/OpenHarmonyPCDeveloper/lycium_plusplus.git

克隆过程如下：

进入构建脚本目录，尝试编译 tree 命令：

bash 复制代码

# 进入 build.sh 目录
cd ~/harmonypc/lycium_plusplus/lycium/

# 构建 tree 命令
./build.sh tree

首次运行可能因缺少 cmake 而失败：

安装 CMake：

bash 复制代码

# 安装 cmake
sudo apt install -y cmake

安装过程如下：

再次执行构建：

bash 复制代码

# 重新构建 tree 命令
./build.sh tree

若看到类似以下输出，即表示构建成功：

结尾总结

通过以上步骤，你已在 Ubuntu 24.04 上成功：

修复并安装了兼容新版系统的开发依赖
下载并配置了 OpenHarmony SDK
设置了持久化环境变量
使用 lycium_plusplus 成功构建了 tree 命令

这标志着你的 OpenHarmony PC 移植开发环境已准备就绪！接下来可尝试移植更多命令行工具，或深入参与 OpenHarmony 生态建设。

🌐 资源参考

OpenHarmony 官网：https://www.openharmony.cn/

GitCode 社区项目：https://atomgit.com/OpenHarmonyPCDeveloper

祝你开发顺利，共建鸿蒙未来！🚀