环境准备
DevEco CLI支持在Windows、macOS、Linux和鸿蒙电脑上运行。
从1.3.0版本开始支持在Linux上运行。
[h2]搭建环境(Windows/macOS/Linux)
- 在macOS环境中,DevEco Studio需使用默认的安装路径,安装在~/Applications或/Applications目录下。
[h2]搭建环境(鸿蒙电脑)
- 在鸿蒙电脑上查看设置 > 系统中开发者选项是否存在,如果不存在,可在设置 > 具体的设备名称中,连续七次单击软件版本,直到提示“开启开发者选项”,点击确认开启后输入PIN码(如果已设置),设备将自动重启,请等待设备完成重启。
- 如需使用多设备预览器,需要打开DevEco Studio,并且鸿蒙电脑需要在设置 > 系统 > 开发者选项中,打开无线调试开关。
- DevEco CLI通过npm进行分发,安装前需要先下载和安装DevEco Studio或Command Line Tools。
如果安装DevEco Studio,按以下步骤配置环境变量。
- 在终端中执行以下命令,打开环境变量配置文件。
vim ~/.zshrc
- 在.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
- 在终端中执行以下命令,设置npm包安装路径,建议设置到个人目录下/storage/Users/currentUser/npm。
npm config set prefix /storage/Users/currentUser/npm
- 在.zshrc文件中添加npm环境变量。
export PATH=/storage/Users/currentUser/npm/bin:$PATH
- 保存并关闭文件,使用source命令重新加载.zshrc配置文件。
source ~/.zshrc
如果安装Command Line Tools,按以下步骤配置环境变量。
- 在终端中执行命令,解压命令行工具commandline-tools-harmonyos-xxx.tar.gz,工具名称请根据实际情况进行修改。
tar -zxvf commandline-tools-harmonyos-xxx.tar.gz
- 执行以下命令,打开环境变量配置文件。
vim ~/.zshrc
- 在.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环境变量 - 保存并关闭文件,使用source命令重新加载.zshrc配置文件。
source ~/.zshrc
- 在终端中执行以下命令,设置npm包安装路径,建议设置到个人目录下/storage/Users/currentUser/npm。
npm config set prefix /storage/Users/currentUser/npm
- 在.zshrc文件中添加npm环境变量。
export PATH=/storage/Users/currentUser/npm/bin:$PATH
- 保存并关闭文件,使用source命令重新加载.zshrc配置文件。
source ~/.zshrc
[h2]检验环境是否搭建成功
在终端Shell中,验证Node.js环境:
node -v
npm -v
安装(稳定版)
npm install -g @deveco/deveco-cli@stable
安装(尝鲜版)
npm install -g @deveco/deveco-cli
- 鸿蒙电脑版DevEco CLI仅支持通过npm install -g @deveco/deveco-cli命令安装尝鲜版。
- 安装命令中的@stable标签是可选项,带有@stable标签表示下载安装稳定版本,未带有@stable标签表示下载安装最新版本。
首次使用
- 初始化。

- 创建一个HarmonyOS应用。
