DevEco Device Tool 3.0环境配置:Ubuntu 20.04依赖项全攻略
1. 环境准备:系统基础配置
在开始安装DevEco Device Tool 3.0之前,我们需要确保Ubuntu 20.04系统已经完成了必要的基础配置。这些配置看似简单,却往往是后续安装失败的罪魁祸首。
首先,更新系统软件包列表并升级现有软件:
sudo apt update && sudo apt upgrade -y接下来,检查并修改默认shell环境。Ubuntu默认使用dash作为/bin/sh的链接,但鸿蒙开发工具链需要bash环境:
ls -l /bin/sh # 检查当前shell sudo dpkg-reconfigure dash # 选择"No"切换为bash安装基础开发工具和依赖库:
sudo apt install -y curl git vim build-essential注意:系统用户名不能包含中文字符,否则可能导致DevEco Device Tool无法正常加载界面。
2. Python环境配置
Python是DevEco Device Tool的核心依赖之一,必须确保安装正确的版本。Ubuntu 20.04默认安装了Python 3.8,这正好符合要求。
安装Python相关工具:
sudo apt install -y python3-pip python3.8-venv创建Python软链接,确保系统能正确识别Python命令:
sudo ln -sf /usr/bin/python3.8 /usr/bin/python配置pip国内镜像源以加速下载:
pip3 config set global.index-url https://repo.huaweicloud.com/repository/pypi/simple pip3 config set global.trusted-host repo.huaweicloud.com安装必要的Python模块:
pip3 install jinja2 scons pycryptodome ecdsa kconfiglib3. Node.js与HPM安装
Node.js是运行鸿蒙包管理工具HPM的基础环境。我们需要安装LTS版本的Node.js。
下载并安装Node.js 16.x LTS版本:
curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash - sudo apt install -y nodejs验证安装:
node -v # 应显示v16.x.x npm -v # 应显示8.x.x配置npm国内镜像源:
npm config set registry https://repo.huaweicloud.com/repository/npm/安装鸿蒙包管理工具HPM:
sudo npm install -g @ohos/hpm-cli@1.4.4验证HPM安装:
hpm -V # 应显示1.4.4版本4. 编译工具链安装
鸿蒙设备开发需要一系列编译工具,包括hb、gn、ninja等。这些工具的正确配置对后续编译至关重要。
4.1 安装hb工具
hb(ohos-build)是鸿蒙的编译构建工具:
pip3 install --user ohos-build==0.4.3添加hb到环境变量:
echo 'export PATH=$HOME/.local/bin:$PATH' >> ~/.bashrc source ~/.bashrc验证hb安装:
hb -h # 应显示帮助信息4.2 安装gn和ninja
下载并安装gn和ninja:
wget https://repo.huaweicloud.com/harmonyos/compiler/gn/1717/linux/gn-linux-x86-1717.tar.gz wget https://repo.huaweicloud.com/harmonyos/compiler/ninja/1.9.0/linux/ninja.1.9.0.tar tar -xzf gn-linux-x86-1717.tar.gz tar -xf ninja.1.9.0.tar配置环境变量:
echo 'export PATH=$PATH:'$(pwd)'/gn-linux-x86-1717' >> ~/.bashrc echo 'export PATH=$PATH:'$(pwd)'/ninja.1.9.0' >> ~/.bashrc source ~/.bashrc5. 交叉编译器安装
根据目标设备架构的不同,需要安装对应的交叉编译器。以下是常见的RISC-V架构编译器安装方法。
安装RISC-V 32位工具链:
wget https://repo.huaweicloud.com/harmonyos/compiler/gcc_riscv32/7.3.0/linux/gcc_riscv32-linux-7.3.0.tar.gz tar -xzf gcc_riscv32-linux-7.3.0.tar.gz配置环境变量:
echo 'export PATH=$PATH:'$(pwd)'/gcc_riscv32-linux-7.3.0/bin' >> ~/.bashrc source ~/.bashrc6. 环境验证与问题排查
完成所有依赖安装后,我们需要验证环境是否配置正确。
验证Python环境:
python --version # 应显示3.8.x pip3 list | grep ohos-build # 应显示已安装验证Node.js和HPM:
node -v npm -v hpm -V验证编译工具:
gn --version ninja --version hb -h常见问题及解决方案:
hb命令未找到:
- 检查
~/.local/bin是否在PATH中 - 重新执行
source ~/.bashrc
- 检查
HPM安装失败:
- 尝试指定版本:
npm install -g @ohos/hpm-cli@1.4.2 - 检查网络连接,确保能访问华为镜像源
- 尝试指定版本:
Python模块导入错误:
- 确认pip3安装的模块位于正确路径
- 尝试重新安装:
pip3 install --force-reinstall 模块名
7. 一键安装脚本
为方便重复部署,可以将上述步骤整合为一个安装脚本install_deps.sh:
#!/bin/bash # 系统更新 sudo apt update && sudo apt upgrade -y sudo apt install -y curl git vim build-essential # 修改shell环境 sudo dpkg-reconfigure dash # Python环境 sudo apt install -y python3-pip python3.8-venv sudo ln -sf /usr/bin/python3.8 /usr/bin/python pip3 config set global.index-url https://repo.huaweicloud.com/repository/pypi/simple pip3 config set global.trusted-host repo.huaweicloud.com pip3 install jinja2 scons pycryptodome ecdsa kconfiglib # Node.js和HPM curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash - sudo apt install -y nodejs npm config set registry https://repo.huaweicloud.com/repository/npm/ sudo npm install -g @ohos/hpm-cli@1.4.4 # hb工具 pip3 install --user ohos-build==0.4.3 echo 'export PATH=$HOME/.local/bin:$PATH' >> ~/.bashrc # gn和ninja wget https://repo.huaweicloud.com/harmonyos/compiler/gn/1717/linux/gn-linux-x86-1717.tar.gz wget https://repo.huaweicloud.com/harmonyos/compiler/ninja/1.9.0/linux/ninja.1.9.0.tar tar -xzf gn-linux-x86-1717.tar.gz tar -xf ninja.1.9.0.tar echo "export PATH=\$PATH:$(pwd)/gn-linux-x86-1717:$(pwd)/ninja.1.9.0" >> ~/.bashrc # RISC-V工具链 wget https://repo.huaweicloud.com/harmonyos/compiler/gcc_riscv32/7.3.0/linux/gcc_riscv32-linux-7.3.0.tar.gz tar -xzf gcc_riscv32-linux-7.3.0.tar.gz echo "export PATH=\$PATH:$(pwd)/gcc_riscv32-linux-7.3.0/bin" >> ~/.bashrc # 生效环境变量 source ~/.bashrc echo "安装完成,请重新打开终端或执行'source ~/.bashrc'使配置生效"使用方式:
chmod +x install_deps.sh ./install_deps.sh