☰
DevEco Code 基本安装与使用基本安装与使用
2026/9/29 21:16:15 网站建设 项目流程

第一部分:Windows 环境安装与演示基本流程

一、node和nvm下载与安装: Node.js — 下载 Node.js®

二、DevEco Studio下载与安装:下载中心 | 华为开发者联盟-HarmonyOS开发者官网,共建鸿蒙生态

三、检查基本配置 Windows+R cmd

四、DevEco Code 安装 Windows+R cmd

五、登录华为账户

六、关联 DevEco Studio 安装路径

安装路径寻找 右键图标

七、进入工作界面与完成首个工程项目

八、运行模拟器

运行效果

九、切换工作模式

十、打开已经开发的项目

十一、通过DevEco Studio 打开 打开源码所在位置即可 模拟器运行如下

附件:官方支持:

deveco-code:基于 OpenHarmony 的 AI 辅助应用开发工具项目 - AtomGit

文档中心

第二部分:整体流程与说明

推荐配置

一、操作系统

Windows:Windows 11 22H2 及以上

macOS:macOS 15 Sequoia 及以上

二、硬件

日常使用(短会话、单模块改动、以对话与代码编辑为主):8 GB 及以上内存

重度使用(大工程、长会话、频繁编译构建与模拟器/真机调试):16 GB 及以上内存;建议为 DevEco Studio、SDK、模拟器与构建缓存预留 20 GB 及以上可用磁盘空间

三、运行时与工具链

Node.js 22 及以上

DevEco Studio 6.1 及以上(编译构建、Hvigor、HDC、模拟器/真机运行)

已配置 DEVECO_HOME 环境变量,指向 DevEco Studio 安装目录

终端 Shell

Windows:PowerShell 7+(推荐)、Windows PowerShell 5.1+

macOS:Zsh(推荐)、Bash

四、网络

需要稳定的互联网连接(华为账号登录、模型调用、HarmonyOS 知识库检索等)

五、安装前置与常用命名

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

安装 Node.js,推荐使用 22 及更高版本

(可选)安装 DevEco Studio,推荐使用 6.1 及更高版本;若不安装,HarmonyOS 应用构建、推包等工具将无法使用

(可选)配置 DEVECO_HOME 环境变量指向 DevEco Studio 安装目录,默认路径示例:

macOS:/Applications/DevEco-Studio.app

Windows:C:\Program Files\Huawei\DevEco Studio

可先在终端验证 Node.js 环境:cmd

node -v

npm -v

安装与卸载 CMD

安装:

npm install -g @deveco/deveco-code

查看版本、启动:

deveco --version

deveco

更新:

deveco upgrade

卸载运行时数据与全局包:

deveco uninstall

npm uninstall -g @deveco/deveco-code

登录与登出

使用 DevEco Code 需先通过华为账号登录。首次执行 deveco 时会在终端内引导完成登录;也可单独执行登录命令:

deveco auth login

登出会清除当前华为账号的本地登录状态,下次启动需重新登录。执行:

deveco auth logout

创建桌面快捷方式

cmd /k “deveco”

打开已经开发好的项目

cd C:\Users\65794\DevEcoStudioProjects\EarthSimulator(项目路径)

打开模拟器运行

deveco run

六、模型配置

登录后可使用 DevEco Code 提供的免费模型通道。

在 DevEco Code 中输入 /models 可进入模型配置界面。当前免费提供 GLM-5.1 模型,单账号默认每分钟 50 次请求。也可以通过 /connect 进入 Provider 选择界面,配置支持的第三方模型。

也可以通过 deveco.jsonc 配置模型:

{

“$schema”: “https://opencode.ai/config.json”,

“provider”: {

"deveco": { "name": "DevEco Code", "models": { "glm-5": { "tool_call": true, "limit": { "context": 200000, "output": 8192 } } }, "options": { "baseURL": "https://api.openbitfun.com/v1", "apiKey": "{env:DEVECO_API_KEY}" } }

}

}

UI 检查配置

UI 检查是功能验证阶段的可选能力,用于验证界面是否符合需求描述。

该功能需调用多模态模型(仅用于 UI 检查,不作为主对话模型):已登录账号时默认使用内置 Qwen3-VL 模型,未登录时则跳过 UI 检查。

如需配置第三方多模态模型(仅支持 Qwen 系列),可在 deveco.jsonc 的 agent 中指定,以qwen3-vl-plus为例:

{

“$schema”: “https://opencode.ai/config.json”,

“provider”: {

"myprovider": { "npm": "@ai-sdk/openai-compatible", "name": "alibaba", "options": { "baseURL": "https://dashscope.aliyuncs.com/compatible-mode/v1", "apiKey": "your-api-key", }, "models": { "qwen3-vl-plus": { "modalities": { "input": ["text", "image"], "output": ["text"], }, }, }, },
  • .

},

“agent”: {

"ui_verification": { "mode": "subagent", "model": "myprovider/qwen3-vl-plus", // 格式为<provider-name>/<model-name> "hidden": true, },

},

}

配置文件读取优先级:

项目目录下 .deveco/deveco.jsonc

项目目录下 deveco.jsonc

用户目录下 .config/deveco/deveco.jsonc

七、Agent 配置

DevEco Code 面向 HarmonyOS 开发提供以下 Agent 配置(按 Tab 键切换):

Build:默认模式,适合工程生成、代码生成、配置修正、测试执行、推包运行和发布执行

Plan:适合需求拆解、技术方案、发布规划、测试规划和文档生成

Goal:适合 SDD 五阶段从需求到实现与构建验证的端到端特性交付

HarmonyOS 场景能力

DevEco Code 集成了常用 HarmonyOS 开发工具能力:

常见场景包括:从零到一创建 HarmonyOS 工程、增量开发页面、修复编译报错、真机调试。

八、扩展能力

DevEco Code 兼容 OpenCode 的 Skill、MCP 和 Plugin 扩展方式。

新增或修改 Skill、MCP、Plugin 配置后,需退出并重新执行 deveco 启动后才会生效。

Skills

npx skills add vercel-labs/agent-skills

也可以把 Skill 放到 ~/.config/deveco/skills 目录。

MCP

可在 ~/.config/deveco/deveco.jsonc 中配置 MCP:

{

“$schema”: “https://opencode.ai/config.json”,

“mcp”: {

"playwright": { "type": "local", "command": ["npx", "@playwright/mcp@latest"], "enabled": true }

}

}

Plugins

npm install -g oh-my-opencode

然后在 deveco.jsonc 中配置插件入口:

{

“plugin”: [

"node_modules/oh-my-opencode/dist/index.js"

]

}

九、从 OpenCode 迁移

如果需要从 OpenCode 迁移到 DevEco Code,请将配置文件迁移到 DevEco Code 目录。主配置文件可参考:

Windows PowerShell

Copy-Item -Force “{源路径}\opencode.jsonc” “~.config\deveco\deveco.jsonc”

macOS

cp {源路径}/opencode.jsonc ~/.config/deveco/deveco.jsonc

Skills、Agents、Plugins 也可以迁移到 ~/.config/deveco 下的对应目录;MCP 配置项可迁移到 deveco.jsonc 中。

第三部分 工具说明

DevEco Code 是一款面向 HarmonyOS 开发场景的 AI Agent 工具,支持代码编写、编译构建、设备运行、文档查阅、运行时调试及 ArkTS 问题修复等能力。

DevEco Code 基于开源项目 OpenCode 扩展开发,保留了 OpenCode 的终端交互、配置体系、 Provider / MCP / Skill / Plugin 等能力,并针对 HarmonyOS 工程增加了 DevEco Studio、Hvigor、HDC、Skill、HarmonyOS 知识库、ArkTS 检查和设备调试相关集成。

本文参考鸿蒙官方文

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询