DevEco Device Tool 3.0 Release 环境配置：Ubuntu 20.04 下 8 个依赖项完整安装与验证

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/安装鸿蒙包管理工具HPMsudo npm install -g ohos/hpm-cli1.4.4验证HPM安装hpm -V # 应显示1.4.4版本4. 编译工具链安装鸿蒙设备开发需要一系列编译工具包括hb、gn、ninja等。这些工具的正确配置对后续编译至关重要。4.1 安装hb工具hb(ohos-build)是鸿蒙的编译构建工具pip3 install --user ohos-build0.4.3添加hb到环境变量echo export PATH$HOME/.local/bin:$PATH ~/.bashrc source ~/.bashrc验证hb安装hb -h # 应显示帮助信息4.2 安装gn和ninja下载并安装gn和ninjawget 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和HPMnode -v npm -v hpm -V验证编译工具gn --version ninja --version hb -h常见问题及解决方案hb命令未找到检查~/.local/bin是否在PATH中重新执行source ~/.bashrcHPM安装失败尝试指定版本npm install -g ohos/hpm-cli1.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-cli1.4.4 # hb工具 pip3 install --user ohos-build0.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