HDC Assistant 使用说明
这是给 HarmonyOS 开发者用的小工具，把日常开发里高频的 hdc 命令搬到了 DevEco Studio 的菜单里。装好之后不用再开终端敲命令，点一下菜单就行。
支持的操作：
- 安装应用（自动找构建出来的 .hap）
- 卸载、强杀、启动、重启应用
- 清理应用数据（可以顺手重启）
- 调试模式启动应用（等 hdc 调试器 attach）
- 开关 Wi-Fi、移动数据
- 获取设备 UDID（自动复制到剪贴板）
使用前准备
1 设备用数据线连上电脑，或者已经配好了 Wi-Fi 调试。打开终端跑一下：
markdown
hdc list targets
能看到设备序列号就说明连接没问题。看不到的话先去处理连接，插件所有操作都依赖这个。2 建议用 DevEco Studio 打开你的 HarmonyOS 工程。插件会自动从工程文件里读 bundleName 和 EntryAbility，不依赖工程也能用，但启动、卸载这类操作就必须手动配 bundleName 了。
安装插件
下载插件
本地安装（插件市场上架之前先这样装）：
- 拿到
HdcAssistant-1.1.0.zip - DevEco Studio → File → Settings → Plugins → 点右上角齿轮 → Install Plugin from Disk...
- 选中 zip，装完重启 IDE
插件市场安装（审核通过之后）：
Settings → Plugins → Marketplace 里搜 "HDC Assistant"，点 Install 即可。
两种使用方式
菜单方式
顶部菜单栏 Tools → HDC Assistant，里面有全部操作的列表，每一项对应一条或一组 hdc 命令。比如：
- HDC Install App →
hdc install -r xxx.hap - HDC Uninstall App →
hdc uninstall com.xxx.yyy - HDC Restart App → 先
aa force-stop再aa start - HDC Get Device UDID →
hdc shell bm get --udid
快捷键方式（推荐）
按 Ctrl + Alt + Shift + A 会弹出可搜索的操作列表，直接打字过滤。比如敲 inst 回车就是安装，敲 udid 回车就是取 UDID。比翻菜单快很多。
各功能说明
Install App
执行 hdc install -r（带 -r 参数，保留应用数据重装）。
安装包不用自己找：插件会自动扫工程里 <module>/build/.../outputs/ 目录下最近编译出来的 .hap，有多个就取最新改动的那个。如果工程还没编译过、找不到 hap，会弹一个文件选择框让你手动选。
Start App with Debugger / Restart with Debugger
调试用。执行 aa start -D，应用启动后会挂起等调试器。之后用 DevEco 的 hdc 调试配置 attach 上去就能断点了。重启版本会先 force-stop 再启动。
Enable / Disable Mobile Data
移动数据开关特殊一点：不同设备的移动网卡名字不一样（rmnet_data0、ccmni 之类的），插件会先跑 hdc shell ifconfig 自动识别网卡再执行开关，不用你关心名字。
Get Device UDID
执行 hdc shell bm get --udid。设备返回的 UDID 会显示在 HDC 控制台里，同时自动复制到剪贴板，直接 Ctrl + V 就能用。有些设备会额外输出一行提示文字，插件取的是最后一行非空内容，也就是真正的 UDID 本身。
HDC 控制台
IDE 底部有个 HDC 工具窗口，每次执行都会把命令和完整输出打印在这里。执行失败先看这里，报错信息都看得见。
设置
Tools → HDC Assistant → HDC Settings... ，可以改三项：
- hdc 路径 ：一般情况下不用填。插件会依次找 DevEco 自带 SDK 里的 hdc、
%LOCALAPPDATA%\Huawei\Sdk下的 hdc，找到就用。只有这些都找不到、或者你想用特定版本时才手动指定。 - bundleName / abilityName：自动识别失败或者想临时操作别的应用时手动填。填了就用填的，不填走自动识别。
常见问题
点了没反应 / 报 hdc not found
终端里跑 hdc list targets 确认 hdc 本身可用。如果终端能用但插件找不到，去 HDC Settings 里手动填一下 hdc.exe 的完整路径。
报 bundleName not detected
工程里没找到 AppScope/app.json5（或者里面没有 bundleName 字段）。打开 HDC Settings 手动填 bundleName；abilityName 不填的话插件会取 module.json5 里的 mainElement。
Install App 弹了文件选择框
说明工程里没编译出 .hap。先在 DevEco 里 Build → Make Module，生成 <模块名>-default-signed.hap 之后再执行。也可以在选择框里直接选中已有的 hap 安装。
Wi-Fi 开关无效
部分真机的 wlan0 需要 root 权限才能 ifconfig down，设备没 root 的话这个操作会静默失败，看 HDC 控制台的输出确认。
移动数据开关报 no mobile data interface found
ifconfig 输出里没识别到移动网卡。可以把控制台的 ifconfig 完整输出发给开发者，把网卡关键字加进识别规则。
快捷键
| 功能 | 快捷键 |
|---|---|
| 呼出操作列表 | Ctrl + Alt + Shift A |
在 Settings → Keymap 里搜 "HDC" 可以改绑。
使用效果
安装app
获取udid
等等等还有更多其他功能大家自己安装探索吧
最后总结
这个插件灵感来自android studio 里面的 adb 的插件, 所以我就重新写了一个deveco 版本的 也是帮助调试鸿蒙next项目的app的时候 更加的快捷的和方便 也在希望各位同学能多多支持鸿蒙生态，希望能帮助各位开发者和学生。 如果觉得不错可以给我一个star
项目地址
github :HdcPlugin