文档开发者中心
我的
|

DevEco Device Tool

DevEco Device Tool手动准备依赖环境——Linux篇

Ubuntu开发环境准备

说明:推荐使用Linux+Windows的混合开发模式,纯Linux模式的开发场景工具没有做过全量测试,可能存在未知的异常信息,导致无法使用。并且,为了正常使用,开发者可能除了本文中的工作,还需要一些额外的、未知的工作。

系统要求:

  • Ubuntu18及以上版本。

  • 系统的用户名不能含有中文字符。

  • 只能使用普通用户角色搭建开发环境

基于Ubuntu系统,DevEco Device Tool以插件方式提供,基于Visual Studio Code进行扩展,安装分为如下几步:

  1. 安装Visual Studio Code

  2. 安装Python

  3. 安装Node.js

  4. 安装hpm

  5. 安装DevEco Device Tool插件

获取软件

工具名称

用途说明

版本要求

获取渠道

Visual Studio Code

代码编辑工具

(说明:如果采用的是Linux+Windows的远程模式,无需安装)

V1.60及以上64位版本

https://code.visualstudio.com/Download

Python

编译构建工具

V3.8.9~V3.9.x 64位版本

(如果安装DevEco Device Tool 2.1 Release版本,Python版本只能为3.8.x版本,不能安装最新的Python3.9.x版本。)

 使用命令行工具进行安装,请参考。

Node.js

提供npm环境

(说明:3.0 Beta2版本内嵌,无需安装)

以下版本三选一:

  • V12.22.5及以上64位版本

  • V14.17.5及以上64版本

  • V16.6.0及以上64位版本

https://nodejs.org/zh-cn/download/

hpm

包管理工具

(说明:3.0 Beta2版本内嵌,无需安装)

V1.3.0及以上

请参考。

DevEco Device Tool

HarmonyOS源码的编译、烧录、调试插件工具

V3.0 Beta2

https://device.harmonyos.com/cn/ide#download_beta

下载请,请使用华为开发者帐号登录,如未注册,请先注册华为开发者帐号。

将Ubuntu shell改为bash

  1. 打开终端工具,执行如下命令,输入密码,然后选择No,将Ubuntu shell修改为bash。

    收起
    自动换行
    深色代码主题
    复制
    sudo dpkg-reconfigure dash
  2. 执行如下命令,确认输出结果为bash。

    收起
    自动换行
    深色代码主题
    复制
    ls -l /bin/sh

安装Python 【非必须,3.1 Beta2可跳过,会自动下载安装Python】

  1. 打开终端工具,执行以下命令,更新软件包列表并安装必备组件。

    收起
    自动换行
    深色代码主题
    复制
    sudo apt updatesudo apt install software-properties-common

  2. 执行如下命令,将Deadsnakes PPA添加到系统的来源列表中。

    收起
    自动换行
    深色代码主题
    复制
    sudo add-apt-repository ppa:deadsnakes/ppa

  3. 执行如下命令,安装Python,下面以安装Python 3.8版本为例进行说明

    收起
    自动换行
    深色代码主题
    复制
    sudo apt install python3.8

  4. 执行如下命令,验证Python3.8是否安装成功。

    收起
    自动换行
    深色代码主题
    复制
    python3.8 --version

  5. 执行如下命令,查询安装的python3.8的路径。

    收起
    自动换行
    深色代码主题
    复制
    which python3.8

  6. 执行如下命令,分别设置python和python 3软链接,并对多个版本进行管理。假设系统中同时存在Python3.6和Python3.8版本时,需要将Python3.8设置为更高优先级。该命令格式为sudo update-alternatives --install <link> <name> <path> <priority>,其中:

    • link:指向/etc/alternatives/<name>的符号引用。

    • name:链接组的名称。

    • path:Python工具的实际路径。

    • priority:优先级,数字较大的选项有较高的优先级。

      收起
      自动换行
      深色代码主题
      复制
      sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.6 1sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.8 2sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.6 1sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.8 2
  7. 执行如下命令,安装并更新pip3,用于安装DevEco Device Tool过程中拉取所需的工具链、脚本等。

    收起
    自动换行
    深色代码主题
    复制
    sudo apt-get install python3-pip && python3 -m pip install --upgrade pip

  8. 执行如下命令,安装venv,用于安装DevEco Device Tool过程中创建独立的Python环境。

    收起
    自动换行
    深色代码主题
    复制
    sudo apt-get install python3.8-venv

  9. 分别执行如下命令,设置pip3镜像源,国内用户建议使用国内三方的镜像源。

    收起
    自动换行
    深色代码主题
    复制
    pip3 config set global.trusted-host repo.huaweicloud.compip3 config set global.index-url https://repo.huaweicloud.com/repository/pypi/simplepip3 config set global.timeout 120

安装Node.js (说明:3.0 Beta2版本内嵌,无需安装)

  1. 进入Node.js软件包目录(例如: ~/tools/),执行如下命令,解压已经下载好的安装包,其中node-v1x.xx.x-linux-x64.tar.xz为软件包名称,请根据实际进行修改。

    收起
    自动换行
    深色代码主题
    复制
    tar -xvf node-v1x.xx.x-linux-x64.tar.xz

  2. 配置Node.js环境变量

    • 执行如下命令,打开当前用户下的配置文件.bashrc

      收起
      自动换行
      深色代码主题
      复制
      vim ~/.bashrc如果提示“Command 'vim' not found”,请执行sudo apt install vim命令安装vim。

    • 在配置文件中,点击键盘上的“i”,然后在最后插入Node.js的环境变量信息,文件目录和软件包名称请根据实际情况进行修改。

      收起
      自动换行
      深色代码主题
      复制
      #nodejsexport NODE_HOME=~/tools/node-v1x.xx.x-linux-x64export PATH=$NODE_HOME/bin:$PATH

  3. 添加完成后,点击键盘上的“Esc”,然后输入:wq,点击“Enter”进行保存。

  4. 执行source命令使配置文件立即生效

    收起
    自动换行
    深色代码主题
    复制
    source ~/.bashrc

  5. 执行如下命令,检查Node.js安装结果

    收起
    自动换行
    深色代码主题
    复制
    node -v

安装Hpm(说明:3.0 Beta2版本内嵌,无需安装)

该方式需先确保Node.js安装成功。

在安装hpm前,请检查网络连接状态,如果网络不能直接访问Internet,则需要通过代理服务器才可以访问。这种情况下,需要先设置npm代理,才能安装hpm。

如果已安装hpm,可以执行npm update -g @ohos/hpm-cli命令升级hpm至最新版本。

  1. 建议将npm源配置为国内镜像,例如设置为华为云镜像源。

    收起
    自动换行
    深色代码主题
    复制
    npm config set registry https://repo.huaweicloud.com/repository/npm/

  2. 执行如下命令安装HPM

    收起
    自动换行
    深色代码主题
    复制
    npm install -g @ohos/hpm-cli

  3. 执行如下命令(V为大写字母)查看HPM安装结果

    收起
    自动换行
    深色代码主题
    复制
    hpm -V

  4. 检查HPM的网络连接状态,如果网络不能直接访问Internet,则需要通过代理服务器才可以访问,请先hpm代理设置。

    收起
    自动换行
    深色代码主题
    复制
    hpm search -t distribution

  5. 执行如下命令,安装curl工具,用于通过hpm下载源码时拉取对应的工具链。

    收起
    自动换行
    深色代码主题
    复制
    sudo apt-get install curl

安装Visual Studio Code(说明:如果采用的是Linux+Windows的远程模式,无需安装)

  1. 进入Visual Studio Code安装包目录,执行如下命令,安装Visual Studio Code,其中code_1.xx.x-xxx_amd64.deb为软件包名称,请根据实际进行修改。

    收起
    自动换行
    深色代码主题
    复制
    sudo dpkg -i code_1.xx.x-xxx_amd64.deb

  2. 安装结束后,执行如下命令,查询Visual Studio Code安装结果。

    收起
    自动换行
    深色代码主题
    复制
    code --version

安装DevEco Device Tool

安装DevEco Device Tool插件,主机的用户名不能包含中文字符,否则在运行DevEco Device Tool时,DevEco Home界面会一直处于Loading状态,导致不能正常使用。

DevEco Device Tool正常运行需要依赖于C/C++和CodeLLDB插件,在安装完DevEco Device Tool后,会自动从Visual Studio Code的插件市场安装C/C++和CodeLLDB插件。因此,在安装DevEco Device Tool前,请检查Visual Studio Code的网络连接状态,如果网络不能直接访问Internet,则需要通过代理服务器才可以访问,请先Visual Studio Code代理设置。

安装DevEco Device Tool时,请先关闭Visual Studio Code。

  1. 进入DevEco Device Tool软件包目录,执行如下命令解压软件包,其中devicetool-linux-tool-3.0.0.300.zip为软件包名称,请根据实际进行修改。

    收起
    自动换行
    深色代码主题
    复制
    unzip devicetool-linux-tool -3.0.0.300.zip

  2. 进入解压后的文件夹,执行如下命令,赋予安装文件可执行权限,其中devicetool-linux-tool-3.0.0.300.sh请根据实际进行修改。

    收起
    自动换行
    深色代码主题
    复制
    chmod u+x devicetool-linux-tool-3.0.0.300.sh

  3. 执行如下命令,安装DevEco Device Tool,其中devicetool-linux-tool-3.0.0.300.sh请根据实际进行修改。

    收起
    自动换行
    深色代码主题
    复制
    sudo ./devicetool-linux-tool-3.0.0.300.sh -- -- install-plugins

  4. 安装完成后,在Ubuntu左下角的中,启动Visual Studio Code。

点赞
1
收藏
3
回复
8
分享
举报
浏览3703 编辑于2023-03-28 01:57广东
全部评论
最多点赞
最新发布
最早发布
收起
自动换行
深色代码主题
复制
cd /home/user0/.nvm/versions/node/v16.20.2/lib/node_modules/@ohos/hpm-cli
# 初始化 package.json(一路回车默认即可)
npm init -y

# 安装缺失的核心依赖
npm install idempotent-babel-polyfill --registry=https://repo.huaweicloud.com/repository/npm/

cd ~
hpm --version

hpm -v    报错解决

6楼回复于2026-03-12 07:25 来自广东
收起
自动换行
深色代码主题
复制
npm install -g @ohos/hpm-cli

并不会自动安装dependencies,因为bundledDependencies中制定了这些依赖,但实际发行的tar中并没有包括这些文件。请检查upstream的CI打包时是否实际通过 `npm run pack:bundle`发布,或在package.json中移除bundledDependencies。

https://www.npmjs.com/package/@ohos/hpm-cli?activeTab=code

/@ohos/hpm-cli/package.json

收起
自动换行
深色代码主题
复制
    "bundledDependencies": [
        "@ohos/hpm-cli-dag",
        "@ohos/hpm-cli-notice",
        "@ohos/hpm-cli-x2h",
        "axios",
        "commander",
        "compressing",
        "form-data",
        "https-proxy-agent",
        "idempotent-babel-polyfill",
        "inquirer",
        "log4js",
        "semver",
        "shelljs",
        "tar"
    ]
1
5楼回复于2026-02-17 13:12 来自广东
  • ljh
    临时解决办法为: ``` npm install -g @ohos/hpm-cli cd "$(npm root -g)/@ohos/hpm-cli" npm install --production ```
    2026-02-17 13:14 来自广东

安装DevEco Device Tool的第3步应当是:sudo ./devicetool-linux-tool-3.0.0.300.sh -- --install-plugins.

4楼回复于2025-01-30 14:37 来自北京

前面一切正常 但最后code里没有DevEco Device Tool。装了好几遍都没,这怎么解决那

2
3楼回复于2023-03-27 15:32 来自陕西
  • 腹有诗书气自华
    请问,你是要在纯Linux环境下,安装VSCode并且看到Device Tool吗?这种场景不是很推荐,并且测试也没有覆盖测试,可能存在未知问题。还是推荐你使用Linux+Windows的方式。
    2023-03-28 01:40 来自广东
  • Cles8it回复腹有诗书气自华
    抽象的开发环境
    2024-09-04 03:41 来自江苏
IDE 南向插件安装很方便功能很图形化,楼主写的很棒,如何输入 linux 命令都写得非常详细。但是目前官网没有提供历史版本的下载我刚安装好 devicetool-linux-tool-3.0.0.200 这个版本的插件然后一看官网没地方下载了。。。
1楼回复于2022-01-11 07:43 未知归属地
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

目录 收起
Ubuntu开发环境准备
了解社区公约,与您携手共创和谐专业的开发者社区。