目录

下载与安装

DevEco Code支持通过npm包管理器进行分发，开发者可以在系统命令窗口或PowerShell中全局安装后，独立调用相关命令，灵活性高。同时，DevEco Code也支持在DevEco Studio的集成终端中直接使用，开发者无需额外配置即可在DevEco Studio终端调用相关命令，操作便捷。

Windows/macOS版DevEco Code支持通过npm安装，鸿蒙电脑版DevEco Code支持通过npm安装和在DevEco Studio中安装。

通过npm分发安装和启动

[h2]环境要求

DevEco Code支持在Windows、macOS和鸿蒙电脑上运行，具体运行环境要求如下。

Windows运行环境：

类别

要求

操作系统

Windows 11 22H2及以上版本

RAM
  • 8GB及以上（以短会话、单模块代码编辑场景为主）
  • 16GB及以上（以长会话、大工程代码编辑、频繁编译构建和模拟器/真机调试场景为主）

磁盘空间

8GB及以上

若需对HarmonyOS工程进行编译构建，以及调用模拟器/真机调试工具链时，需20GB及以上

终端Shell

PowerShell5.1及以上版本，推荐使用PowerShell7及以上版本

macOS运行环境：

类别

要求

操作系统

macOS 15 Sequoia及以上版本

CPU

Intel芯片或M系列Apple芯片，推荐使用M系列Apple芯片

RAM
  • 8GB及以上（以短会话、单模块代码编辑场景为主）
  • 16GB及以上（以长会话、大工程代码编辑、频繁编译构建和模拟器/真机调试场景为主）

磁盘空间

8GB及以上

若需对HarmonyOS工程进行编译构建，以及调用模拟器/真机调试工具链时，需20GB及以上

终端Shell

Zsh（Z Shell）

鸿蒙电脑运行环境：

类别

要求

操作系统

HarmonyOS 7.0及以上版本

RAM

16GB及以上

磁盘空间

100GB及以上

终端Shell

HiShell

[h2]搭建环境（Windows/macOS）

DevEco Code通过npm分发，安装前请先准备以下环境：

  1. 安装Node.js，推荐使用22及以上版本。
  2. （可选）安装DevEco Studio 6.1.0及以上版本，不安装会影响HarmonyOS工程的编译构建、推包等。
  3. （可选）配置DEVECO_HOME环境变量，指向DevEco Studio安装目录。DevEco Studio默认路径为：
    • macOS：/Applications/DevEco-Studio.app
    • Windows：C:\Program Files\Huawei\DevEco Studio

[h2]搭建环境（鸿蒙电脑）

  1. 在鸿蒙电脑上打开设置 > 系统，查看开发者选项是否存在。如果不存在，需在设置 > 具体的设备名称中，连续七次单击软件版本，直到提示“开启开发者选项”，点击确认开启后输入PIN码（如果已设置），设备将自动重启，请等待设备完成重启。
  2. 如需使用多设备预览器，需要打开DevEco Studio，并且鸿蒙电脑需要在设置 > 系统 > 开发者选项中，打开无线调试开关。
  3. DevEco Code通过npm进行分发，安装前需要先下载和安装DevEco Studio或Command Line Tools。

    如果安装DevEco Studio，按以下步骤配置环境变量。

    1. 在终端中执行以下命令，打开环境变量配置文件。
      vim ~/.zshrc
    2. 在.zshrc文件中添加Node.js环境变量。hmos-clt_x.x.x请根据实际情况进行修改，可在鸿蒙电脑终端或DevEco Studio终端中进入/data/service/hnp/hmos-clt.org目录查看。
      export PATH=/data/service/hnp/hmos-clt.org/hmos-clt_x.x.x/node/bin:$PATH
    3. 在终端中执行以下命令，设置npm包安装路径，建议设置到个人目录下/storage/Users/currentUser/npm。
      npm config set prefix /storage/Users/currentUser/npm
    4. 在.zshrc文件中添加npm环境变量。
      export PATH=/storage/Users/currentUser/npm/bin:$PATH
    5. 保存并关闭文件，使用source命令重新加载.zshrc配置文件。
      source ~/.zshrc

    如果安装Command Line Tools，按以下步骤配置环境变量。

    1. 在终端中执行以下命令，解压命令行工具commandline-tools-harmonyos-xxx.tar.gz，工具名称请根据实际情况进行修改。
      tar -zxvf commandline-tools-harmonyos-xxx.tar.gz
    2. 执行以下命令，打开环境变量配置文件。
      vim ~/.zshrc
    3. 在.zshrc文件中添加Node.js环境变量。
      export COMMAND_LINE_TOOL_PATH=${Command Line Tools解压路径}/command-line-tools   # 解压路径替换为实际的解压路径
export PATH=$COMMAND_LINE_TOOL_PATH/node/bin:$PATH  # 配置Node.js环境变量
    4. 保存并关闭文件，使用source命令重新加载.zshrc配置文件。
      source ~/.zshrc
    5. 在终端中执行以下命令，设置npm包安装路径，建议设置到个人目录下/storage/Users/currentUser/npm。
      npm config set prefix /storage/Users/currentUser/npm
    6. 在.zshrc文件中添加npm环境变量。
      export PATH=/storage/Users/currentUser/npm/bin:$PATH
    7. 保存并关闭文件，使用source命令重新加载.zshrc配置文件。
      source ~/.zshrc

[h2]检验环境是否搭建成功

在终端Shell中，验证Node.js环境：

node -v
npm -v

[h2]安装

安装（稳定版）
npm install -g @deveco/deveco-code@stable

安装（尝鲜版）

npm install -g @deveco/deveco-code
  • 鸿蒙电脑版DevEco Code仅支持通过npm install -g @deveco/deveco-code命令安装尝鲜版。
  • 安装命令中的标签@stable是可选项，加标签@stable表示下载安装稳定版本，不加标签@stable表示下载安装最新版本。
  • 可通过npm的registry参数配置不同的镜像源，命令为npm install -g @deveco/deveco-code --registry=string。推荐使用npm官方源（https://registry.npmjs.org/）或淘宝镜像源（https://registry.npmmirror.com），其他镜像源可能因同步延迟导致安装失败或版本滞后。

    安装时默认使用npm官方源，指定淘宝镜像源时命令为npm install -g @deveco/deveco-code --registry=https://registry.npmmirror.com。

[h2]启动与登录

在终端Shell中执行以下命令启动DevEco Code，若未登录按照指引先登录华为账号。
deveco
执行以下命令退出登录，下次启动时需重新登录。
deveco auth logout

[h2]更新与卸载

查看版本
deveco --version
更新
deveco upgrade
卸载
deveco uninstall   // 卸载运行时数据和安装包，适用于彻底清除所有数据的场景
npm uninstall -g @deveco/deveco-code   // 保留运行时数据，只卸载安装包，适用于保留配置项卸载重装的场景

在DevEco Studio中安装和启动

当前仅鸿蒙电脑版DevEco Code支持在DevEco Studio中安装和启动。

[h2]安装

在鸿蒙电脑版DevEco Studio的菜单栏点击安装DevEco Code，等待完成安装。

[h2]启动与登录

  1. 安装完成后，点击新对话新建并开启一个会话。

  2. 选择信任当前文件夹，并点击链接登录华为账号。

  3. 登录完成后，在终端开始体验DevEco Code。

[h2]更新与卸载

卸载命令

deveco uninstall

更新命令

deveco upgrade