dsh-hmos-emulator

鸿蒙模拟器 · dsh-hmos-emulator

DeepSeek Harness 侧边栏插件:一键启动鸿蒙模拟器,并将 HarmonyOS 应用构建、部署到模拟器。

能做什么

• 启动 / 停止模拟器：一键启动或停止鸿蒙模拟器,自动列出可用实例与在线设备。
• 选择应用项目：文件浏览或一键扫描,自动识别鸿蒙工程。
• 一键构建并部署：将选定的应用构建、安装并启动到目标设备,自动识别多入口模块。
• 部署实时输出：构建 / 安装 / 启动过程实时显示,无需干等。
• 就绪检测：模拟器冷启动后一键检测设备是否上线。
• 全程可见：每一步的输出与状态实时显示,成功 / 失败一目了然。

依赖说明

本插件以「鸿蒙模拟器」标签页显示在侧边栏,依赖 dsh-better-sidebar;未安装时,请参考其说明安装。

安装

前置条件:

• 已安装 dsh 并正常运行(dsh web);Node.js ≥ 22(LTS 或更新)、pnpm ≥ 10。
• 已安装 DevEco Studio(提供模拟器、hdc 与 SDK);Linux 上改用 Command Line Tools(见「平台支持」)。
• 已安装 devecocli 命令行工具;如未安装,执行 npm i -g @deveco/deveco-cli,或装好插件后在面板点击「一键安装 devecocli」。

方式一:npm 安装(推荐)

dsh plugin --profile web add dsh-hmos-emulator

方式二:从 GitHub 安装(免 npm)

dsh plugin --profile web add github:momo20012002/dsh-hmos-emulator

方式三:本地挂载(开发)

git clone https://github.com/momo20012002/dsh-hmos-emulator.git
cd dsh-hmos-emulator && pnpm install && pnpm build
dsh plugin --profile web add .

安装完成后,重启 dsh web(加载宿主端),再刷新浏览器页面(加载客户端),即可生效。

卸载:

dsh plugin --profile web remove dsh-hmos-emulator

使用

1. 打开侧边栏的 + 菜单 →「鸿蒙模拟器」。
2. 点击「扫描可用」列出模拟器与在线设备,再点击「启动」启动模拟器。
3. 在「应用项目」中浏览或扫描,选择鸿蒙工程。
4. 点击「构建并部署」,等待完成。

平台支持

• Windows / macOS:模拟器启动与停止由 DevEco Studio 提供。
• Linux:DevEco Studio 没有 Linux 版,模拟器来自 Command Line Tools(需 26.0.0 Release 及以上)。需要:
  • Ubuntu 18.04 及以上;
  • 把 DEVECO_CLI_CLT_PATH 指向 Command Line Tools 安装目录(或把其 emulator 目录加入 PATH);
  • 需要桌面环境:无图形界面(DISPLAY / WAYLAND_DISPLAY 均未设置)时,本插件不提供启动支持。
• 选择工程、连接设备、构建并部署在所有系统上均可用。

常见问题

现象	处理
启动时提示授权 / 协议未接受	在终端执行 devecocli emulator license accept 后重试
扫描不到模拟器实例	使用 DevEco Studio 的 Device Manager 确认实例存在,或在终端执行 devecocli emulator list 查看实际报错
Linux 上启动模拟器报错	需 Command Line Tools 26.0.0 Release 及以上(DevEco Studio is not available on Linux 即未设置 DEVECO_CLI_CLT_PATH)
部署失败但无具体报错	在工程中配置签名后重试;多入口模块已自动选择入口模块(可在面板切换)
提示找不到 hdc	设置环境变量 DEVECO_SDK_HOME 指向 DevEco Studio 的 SDK 目录,然后重启 dsh web

License

MIT