blog

轻量级 OpenHarmony 南向开发的环境搭建全攻略

本文档指导如何快速搭建 OpenHarmony 的开发环境，包括依赖安装、环境变量配置、工程编译与常见问题的解决方案。

准备工作

确保可用的 Linux 环境

您需要一个可用的 Linux 环境，根据操作系统的不同推荐以下方式：

  1. 推荐操作系统
    • Ubuntu 20.04（支持更高版本如 Ubuntu 22.04）。
  2. Windows 用户推荐
  3. 远程连接

1. 更新系统及安装依赖

按以下步骤完成系统更新和开发工具依赖安装：

1.1 更新系统

1
sudo apt-get update && sudo apt-get upgrade -y

1.2 安装必要工具

1
sudo apt-get install -y cmake python3 python3-pip python3-setuptools wget build-essential sudo curl git bash

2. 切换默认 Shell 为 Bash

部分系统默认 Shell 为 dash，为避免潜在问题，建议切换为 bash：

1
2
echo "dash dash/sh boolean false" | sudo debconf-set-selections
sudo dpkg-reconfigure -p critical dash

3. 安装 Python 依赖

以下 Python 库是项目运行所需的关键依赖，使用 pip3 安装并确保符合版本要求。

1
2
3
4
5
# 安装 kconfiglib >= 14.1.0
pip3 install "kconfiglib>=14.1.0"

# 安装 pycparser >= 2.21
pip3 install "pycparser>=2.21"

4. 验证安装

运行以下命令，验证环境已正确配置：

1
2
3
4
5
python3 --version     # 检查 Python3 版本
cmake --version       # 检查 CMake 版本
pip3 --version        # 检查 pip3 版本
pip3 show kconfiglib  # 检查 kconfiglib 库版本
pip3 show pycparser   # 检查 pycparser 库版本

5. 下载并配置项目

5.1 获取 OH SDK

  1. 下载 OpenHarmony 的 SDK：

  2. 解压 SDK 文件：

    1
    tar -zxvf oh_sdk_20250109.tar.gz

    解压后生成 near_link_sdk 目录。

5.2 下载 Pre 软件

在源码目录下运行以下命令：

1
./build/prebuilts_download.sh

5.3 安装和更新 hb 工具

使用以下命令安装 hb（OpenHarmony 构建工具）：

1
python3 -m pip install --user build/hb

若安装失败或版本不正确，可先卸载后重装：

1
python3 -m pip uninstall ohos-build

5.4 配置环境变量

编辑 ~/.bashrc 文件，追加以下内容（替换 {工程根目录} 为实际路径）：

1
2
export PATH=/{工程根目录}/device/soc/hisilicon/ws63v100/sdkv100/tools/bin/compiler/riscv/cc_riscv32_musl_b090/cc_riscv32_musl/bin:$PATH
export PATH=~/.local/bin:$PATH

运行以下命令使环境变量生效：

1
source ~/.bashrc

6. 编译工程

  1. 设置编译产品：

    1
    hb set -p nearlink_dk_3863

  2. 编译工程：

    1
    hb build -f

  3. 查看制品路径：

    1
    out/nearlink_dk_3863/nearlink_dk_3863/ws63-liteos-app/

  1. 设置编译产品：

    1
    hb set -p nearlink_dk_3863_xts

  2. 调试模式下编译：

    1
    hb build -f -b debug --gn-args build_xts=true

  3. 查看制品路径：

    1
    out/nearlink_dk_3863/nearlink_dk_3863_xts/ws63-liteos-xts/

7. 烧录制品到设备

  1. 下载烧录工具：
    烧录工具下载链接

  2. 按烧录工具说明操作，将生成的制品烧录到设备中。

    1. 打开烧录工具，选择对应的串口,打开烧录工具,点开Option选项,选择对应的芯片,WS63E与WS63属于同一款系列，芯片选择WS63即可。

    2. 选择烧录文件

    3. 勾选Auto Burn和Auto disconnect选项,点击connect连接,单按开发板RST按键开始烧录。

    4. 烧录完成结果如下：

    5. 打开串口工具,波特率选择115200,上电后可以看到相关的串口打印。

8. 常见报错及解决方案

报错：FileNotFoundError: [Errno 2] No such file or directory: ‘python’

原因

脚本尝试调用 python，但系统默认只有 python3，未正确配置 python 命令。

解决方案

创建 python 的软链接指向 python3：

1
sudo ln -s /usr/bin/python3 /usr/bin/python

重新运行编译命令：

1
hb build -f -b debug --gn-args build_xts=true

完成开发环境配置！

至此，您已成功完成 OpenHarmony 开发环境配置，包括依赖安装、工具配置及工程编译流程！适用于 Ubuntu 原生环境 与 WSL2 环境，开发起来更快捷、更灵活。如果还有问题，请仔细检查各依赖版本和环境变量设置是否正确。