DevEco Device Tool 3.0 Release 环境搭建：Ubuntu 20.04 下 10 个关键依赖项配置详解

DevEco Device Tool 3.0 Release 环境搭建Ubuntu 20.04 下 10 个关键依赖项配置详解对于鸿蒙设备开发者而言一个稳定高效的开发环境是项目成功的基础。本文将深入解析在Ubuntu 20.04系统中配置DevEco Device Tool 3.0所需的10个核心依赖项帮助开发者构建可靠的开发基础。1. Python环境配置3.8-3.9版本Python作为DevEco Device Tool的核心运行时环境版本选择至关重要。Ubuntu 20.04默认安装Python 3.8但仍需进行以下优化配置# 安装必备组件 sudo apt-get install python3-pip python3.8-venv # 创建python软链接 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注意避免使用root权限直接安装Python包推荐使用--user参数或虚拟环境2. Node.js环境部署LTS版本HPM工具链依赖Node.js环境建议选择16.x LTS版本# 下载并解压Node.js二进制包 wget https://repo.huaweicloud.com/nodejs/v16.15.1/node-v16.15.1-linux-x64.tar.xz tar -xvf node-v16.15.1-linux-x64.tar.xz -C ~/HarmonyTools/ # 配置环境变量 echo export PATH$HOME/HarmonyTools/node-v16.15.1-linux-x64/bin:$PATH ~/.bashrc source ~/.bashrc验证安装node -v # 应输出v16.15.1 npm -v # 应输出8.11.03. HPM工具链安装与配置鸿蒙包管理器需要特定版本以避免兼容性问题# 配置淘宝镜像源 npm config set registry https://registry.npmmirror.com # 安装指定版本HPM npm install -g ohos/hpm-cli1.4.4 # 验证安装 hpm -V常见问题解决方案安装失败清除npm缓存后重试npm cache clean --force版本冲突先卸载旧版npm uninstall -g ohos/hpm-cli4. 编译工具链gn/ninja鸿蒙特有编译工具需要手动部署工具下载地址环境变量配置示例gnhttps://repo.huaweicloud.com/harmonyos/compiler/gn/1717/linux/gn-linux-x86-1717.tar.gzexport PATH~/tools/gn:$PATHninjahttps://repo.huaweicloud.com/harmonyos/compiler/ninja/1.9.0/linux/ninja.1.9.0.tarexport PATH~/tools/ninja:$PATH# 解压后添加执行权限 chmod x ~/tools/gn/gn chmod x ~/tools/ninja/ninja5. Python关键模块安装以下模块是鸿蒙编译系统的必要依赖pip3 install --user jinja2 scons pycryptodome ecdsa kconfiglib # 验证scons安装 scons -v # 应输出版本信息模块功能说明jinja2模板引擎用于代码生成scons构建工具替代品pycryptodome加密算法支持kconfiglib配置菜单生成6. Shell环境切换dash→bashUbuntu默认使用dash可能导致脚本兼容性问题# 检查当前shell ls -l /bin/sh # 若显示dash则需切换 # 切换为bash sudo dpkg-reconfigure dash # 选择No提示修改后需要重新登录终端生效7. ohos-build工具链部署鸿蒙专用构建工具安装指南# 安装最新版hb pip3 install --user ohos-build # 若出现兼容性问题可指定版本 pip3 install --user ohos-build0.4.3 # 添加本地路径到环境变量 echo export PATH$HOME/.local/bin:$PATH ~/.bashrc source ~/.bashrc验证安装成功hb -h # 应显示帮助信息8. 开发板专用工具链根据目标硬件选择安装RISC-V架构开发板wget https://repo.huaweicloud.com/harmonyos/compiler/gcc_riscv32/7.3.0/linux/gcc_riscv32-linux-7.3.0.tar.gz tar -xvf gcc_riscv32-linux-7.3.0.tar.gz -C ~/tools/ echo export PATH~/tools/gcc_riscv32/bin:$PATH ~/.bashrcOpenHarmony 1.x分支wget https://repo.huaweicloud.com/harmonyos/compiler/clang/9.0.0-36191/linux/llvm-linux-9.0.0-36191.tar tar -xvf llvm-linux-9.0.0-36191.tar -C ~/tools/ echo export PATH~/tools/llvm/bin:$PATH ~/.bashrc9. 基础工具集安装开发过程中常用的辅助工具sudo apt-get update sudo apt-get install -y git curl vim net-tools # 配置git身份 git config --global user.name Your Name git config --global user.email your.emailexample.com工具说明curl网络请求工具net-tools网络诊断工具包vim高效文本编辑10. 环境验证脚本创建快速检查脚本check_env.sh#!/bin/bash echo 环境依赖检查 check_tool() { if command -v $1 /dev/null; then echo -e \033[32m[OK]\033[0m $1: $(which $1) else echo -e \033[31m[FAIL]\033[0m $1 未安装 fi } check_version() { if $1 $2 | grep -q $3; then echo -e \033[32m[OK]\033[0m $1 版本符合要求 else echo -e \033[31m[FAIL]\033[0m $1 版本不符 fi } # 基础工具检查 check_tool python check_tool node check_tool npm check_tool hpm check_tool gn check_tool ninja check_tool hb # 版本检查 check_version python --version 3.8\|3.9 check_version node --version v16 check_version hpm -V 1.4 echo 检查完成 赋予执行权限chmod x check_env.sh ./check_env.sh通过以上10个关键步骤的系统化配置开发者可以获得一个稳定可靠的鸿蒙设备开发环境。每个组件都经过版本验证和兼容性测试确保整个工具链协同工作时不会出现意外问题。