2. HDF开发环境搭建：从源码获取到工具链就绪

说实话，很多初学者在HDF驱动开发上栽跟头，不是因为代码写不对，而是环境没搭好。我见过太多人花了一周时间折腾编译环境，最后发现是Python版本不对。这一章，我就把我在多个项目里踩过的坑、总结的经验，一次性讲清楚。

2.1 OpenHarmony源码获取

源码获取是第一步。我个人习惯用repo工具来管理，因为OpenHarmony的仓库实在太多了，手动git clone会疯掉。

2.1.1 环境准备

先确认你的Linux系统。我推荐Ubuntu 20.04或22.04 LTS，别用太新的版本，有些依赖包还没适配。

2.1.2 安装repo工具

# 创建bin目录并加入PATH
mkdir -p ~/bin
export PATH=~/bin:$PATH

# 下载repo工具
curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > ~/bin/repo
chmod a+x ~/bin/repo

# 验证安装
repo --version

这里有个坑——repo版本必须与OpenHarmony匹配。我曾经用了一个旧版repo去拉新版本代码，结果manifest解析失败，折腾了两天。建议直接用上面的链接。

2.1.3 获取源码

以OpenHarmony 4.0 Release为例：

# 创建工作目录
mkdir -p ~/openharmony
cd ~/openharmony

# 初始化repo
repo init -u https://gitee.com/openharmony/manifest.git -b OpenHarmony-4.0-Release --no-repo-verify

# 同步源码（这一步很慢，建议用镜像）
repo sync -c -j8

repo init -u https://gitee.com/openharmony/manifest.git \
  -b OpenHarmony-4.0-Release \
  --no-repo-verify \
  --repo-url=https://mirrors.huaweicloud.com/git-repo \
  --no-clone-bundle

2.2 编译环境配置

源码拉下来了，接下来配编译环境。嗯，这里要仔细，很多坑都在这一步。

2.2.1 安装依赖包

不同版本的OpenHarmony依赖略有差异，但核心包基本一致：

sudo apt-get update
sudo apt-get install -y \
  binutils binutils-dev \
  build-essential \
  ccache \
  curl \
  file \
  flex \
  g++-multilib \
  gcc-multilib \
  git \
  gnupg \
  gperf \
  lib32ncurses5-dev \
  lib32z1-dev \
  libc6-dev-i386 \
  libgl1-mesa-dev \
  libxml2-utils \
  lz4 \
  m4 \
  make \
  ninja-build \
  nodejs \
  npm \
  openssh-client \
  patch \
  pkg-config \
  python3 \
  python3-pip \
  python3-setuptools \
  rsync \
  scons \
  tzdata \
  unzip \
  vim \
  wget \
  xsltproc \
  zip \
  zlib1g-dev

python3 --version

2.2.2 配置Node.js和npm

编译过程中会用到Node.js做前端资源处理。建议安装Node.js 14.x LTS：

curl -fsSL https://deb.nodesource.com/setup_14.x | sudo -E bash -
sudo apt-get install -y nodejs
node --version
npm --version

2.2.3 安装hb编译工具

hb是OpenHarmony的编译命令行工具，我个人觉得比直接调gn/ninja方便多了。

# 安装hb
python3 -m pip install --user build/hb

# 设置环境变量
export PATH=~/.local/bin:$PATH

# 验证
hb --version

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

2.3 HDF驱动开发工具链安装

环境配好了，但要做HDF驱动开发，还得装几样关键工具。

2.3.1 交叉编译工具链

HDF驱动最终要跑在目标硬件上，所以交叉编译工具链是必须的。以Hi3861为例：

# 下载工具链
wget https://repo.huaweicloud.com/harmonyos/compiler/gcc_riscv32/7.3.0/linux/gcc_riscv32-linux-7.3.0.tar.gz

# 解压到指定目录
sudo tar -xzf gcc_riscv32-linux-7.3.0.tar.gz -C /opt/

# 配置环境变量
export PATH=/opt/gcc_riscv32/bin:$PATH

# 验证
riscv32-unknown-elf-gcc --version

不同芯片的交叉工具链不一样，我整理了一个对照表：

2.3.2 HDF驱动框架源码结构

源码拉下来后，HDF框架在以下目录：

drivers/
├── framework/          # HDF框架核心
│   ├── core/           # 核心层
│   ├── model/          # 设备模型
│   ├── support/        # 支持库
│   └── tools/          # 工具
├── adapter/            # 适配层
├── peripheral/         # 外设驱动
└── interface/          # 驱动接口定义

我个人建议先熟悉drivers/framework/core目录，这是HDF的骨架。你想想看，驱动对象管理、消息机制、配置解析都在这里。

2.3.3 编译HDF驱动示例

环境都齐了，我们来编译一个最简单的HDF驱动验证一下：

# 进入源码根目录
cd ~/openharmony

# 选择产品（以hi3861为例）
hb set -p hi3861

# 编译
hb build -f

第一次编译会比较慢，因为要编译整个系统。之后可以用增量编译：

# 只编译驱动模块
hb build -T drivers

2.4 环境验证与常见问题

搭建过程中难免遇到问题。我把自己踩过的坑列出来，你遇到了可以直接对照：

2.5 本章知识体系

为了让你对整个环境搭建流程有个全局认识，我画了一张流程图：

这张图把整个流程分成了三层：源码获取、编译环境、工具链。每一层都有对应的操作步骤。我建议你按这个顺序来，不要跳步。曾经有个学员跳过了环境依赖安装，直接编译，结果报了一堆错，排查了三天才发现是缺了libxml2。