快速入门

环境准备

DevEco CLI支持在Windows、macOS、Linux和鸿蒙电脑上运行。

从1.3.0版本开始支持在Linux上运行。

搭建环境（Windows/macOS/Linux）

• 下载和安装DevEco Studio 6.0.0及以上版本。
• 安装Node.js，推荐使用22及以上版本。

export DEVECO_CLI_CLI_PATH=/opt/command-line-tools

搭建环境（鸿蒙电脑）

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

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

   1. 执行以下命令，打开环境变量配置文件。

      vim ~/.zshrc

   2. 添加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

检验环境是否搭建成功

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

node -v
npm -v

安装和更新

首次使用

1. 初始化。

   

2. 创建一个HarmonyOS应用。