# HdcDevTools
**Repository Path**: mahongyin/HdcDevTools
## Basic Information
- **Project Name**: HdcDevTools
- **Description**: 鸿蒙开发工具插件。支持hap分发
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: mahy
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-01-16
- **Last Updated**: 2026-09-28
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
随机Bing壁纸欣赏(狂按F5刷新壁纸)
Fork自[hdc_tool](gitee.com/yanftch/hdc_tools.git)进行二次开发，插件和hdc tool冲突 请自行选择。
### 功能清单
支持安装hap
支持上传hap到FTP服务/蒲公英
支持hdc重启/卸载/清理hap数据等
1.DevEco Studio 安装插件 HdcDevTools
如果要看日志到设置里开启日志，单次有效
选择hap文件右击选择上传或安装到调试设备。如果FTP自备FTPServer 设置用户和密码，关闭防火墙或放行21端口
如果上传蒲公英自己在设置填写Apikey
2.java -jar LogServer.jar 接受日志
3.Hap安装器.exe 推拽hap包到上面进行安装到调试设备{开启+连接usb/wifi调试}
# hdc tools InsertCode 一键插入鸿蒙模板代码
在日常鸿蒙项目开发中，我们需要编写大量的代码，但是很多时候，我们只能手动去复制一些重复的、标准的代码，那么有没有什么方法能够直接在
IDEA 中插入一段代码呢？
当然是可以的，这也是本次插件更新的核心功能~ 减少你的工作量，减少你的时间，提高你的效率。
PS：为了方便大家使用，本次功能整合进了 `hdc tools`
里边里，减少了大家的下载成本，参考：[hdc tools](https://juejin.cn/post/7407374655110086667)
本次插件更新，核心功能如下：
1.DevEco Studio 中一键插入鸿蒙模板代码
2.个性化定制自己习惯的模板代码
## 插件安装
在这不赘述，在线安装 或则 离线安装 两种方式，不会的同学自行百度~
或者可以参考上一篇文章 [hdc tools](https://juejin.cn/post/7407374655110086667)
## 插件使用
### 插入代码
插件本身自带了一部分模板代码，可以直接使用，后续大家可以定制化自己习惯的模板代码~
-
1. 进入编辑器界面（当然了，比如打开某个 .ets 文件，你肯定是要在编辑器里边插入代码啦~）
-
2. 唤起选择模板的弹窗，可以通过 `Ctrl + K` (快捷键建议大家修改成自己合适的) 或者 `菜单里` -> `Code` -> `一键插入代码`
来唤起
-
3. 选择需要插入的模板名称，键盘回车或者双击，即可一键插入！
在编辑器中，比如打开某个 .ets 文件，将光标移动到你需要出入代码的位置，然后按下快捷键 `Ctrl + K` (
快捷键建议大家修改成自己合适的) 或者 `菜单里` -> `Code` -> `一键插入代码`
，即可弹出选择模板的弹窗，从弹窗中选择你要插入的代码模板，键盘回车或者双击，即可一键插入！，如下图：
### 增加代码模板
如果插件自带的模板不合适，大家可以定制化自己常用的模板，只要在插件中配置好模板，就可以通过插件来插入代码了~
- 1.打开设置页面，Mac 系统 菜单 `Preferences` -> `Tools` -> `InsertCodeSettings`
- 2.`添加自定义模板`输入框中，输入你要创建的模板的 名称（便于在插入的时候找到），然后在右侧的输入面板中，写入你的模板代码，然后点击
`apply` 或者 `ok`；如果需要创建多个，建议点击 `apply`，然后继续添加
- 3.`添加自定义模板`输入框，鼠标移动过去的时候停留2s，会有提示，按照提示操作即可。PS :
自定义模板：此输入框输入「模板名」，右侧输入模板代码，保存即可。名称必须字母开头！
- 4.配置好模板，就可以在 `菜单里` -> `Code` -> `一键插入代码` 中找到，双击即可插入！
至此，结束~
--------------------
--------------------
--------------------
--------------------
--------------------
--------------------
##### 构建说明
##### 打包使用shadowJar 产出包在build/libs/hdc_tools-版本号.jar
##### 报错：Caused by: java.lang.NullPointerException: getHeaderField("Location") must not be null, 原因是开了代理，关闭代理即可
##### Swing_UI 需要IDEA设置一下才能成功绑定。
# hdc tools 鸿蒙命令行快捷操作工具
## 介绍
在鸿蒙开发中，我们可能会经常用到一些常用的 hdc 命令行来进行一些操作，比如来安装APP、卸载APP、清除缓存数据、同步剪贴板数据等等，正常的使用流程我们需要开启
`终端` 然后键入相关的命令行进行操作，如此流程相对较复杂一点。那么有没有这么一种操作，我直接在 DevEco Studio
中点几下鼠标甚至是通过快捷键，就能实现上述操作呢？
答案肯定是可以的~那么就来到了本文(插件)的舞台了~~~
**PS：以下基于 DevEco Studio 5.0.30403 版本以及对应的模拟器进行验证；真机 Mate 60 Pro 验证**
## 版本更新记录
| plugin版本 | IDEA版本(开发) | DevEco 版本 | 备注 |
|:---------|:-----------|:----------|------------|
| v1.0.0 | 2023.3.1 | 5.0.3.502 | |
| v1.0.1 | 2023.3.1 | 5.0.3.502 | |
| v1.0.2 | 2023.3.1 | 5.0.3.502 | |
| v1.0.3 | 2023.3.1 | 5.0.3.502 | |
| v1.0.4 | 2023.3.1 | 5.0.3.502 | |
| v1.0.5 | 2023.3.1 | 5.0.3.810 | |
| v1.0.6 | 2023.3.1 | 5.0.3.810 | |
| v1.0.8 | 2023.3.1 | 6.0.1.249 | 2026-01-13 |
| v1.0.9 | 2023.3.1 | 6.0.1.249 | 2026-01-18 |
| - | - | - | |
### v1.0.9
1.支持配置鸿蒙基础模板代码.
2.一键插入ArkTs代码.
3.自定义ArkTs模板.
4.支持查看设备udid.
5.支持安装hap.
6.支持上传hap到FTP服务/蒲公英.
7.支持hdc重启/卸载/清理hap数据等.
### v1.0.8
1.支持配置鸿蒙基础模板代码.
2.一键插入ArkTs代码.
3.自定义ArkTs模板.
4.支持hdc重启/卸载/清理hap数据等.
### v1.0.6
1.支持配置鸿蒙基础模板代码.
2.一键插入ArkTs代码.
3.自定义ArkTs模板.
### v1.0.5
1.移除最高兼容版本限制
### v1.0.4
1.增加指令：以调试模式启动APP、以调试模式重新启动APP
2.修复了一些bug
### v1.0.3
1.issue收集增加配置
2.修复了一些bug
### v1.0.2
1.修复了一些bug
2.增加issue收集
### v1.0.1
1.第一个相对完整的版本
2.修复了在DevEco Studio 中执行 hdc 命令时无法准确获取 环境变量 的问题
### v1.0.0
1.第一个完整功能版本
---
## 命令解释
| hdc tool 选项 | 操作功能 | 备注 |
|:-------------------------------------|:----------------------------------------------------------|--------------------------------------------------------------------------------------------------|
| hdc install app | 安装APP | |
| hdc uninstall app | 卸载APP | |
| hdc uninstall app with hsp | 卸载APP(共享包同步删除) | |
| hdc kill app | APP杀掉进程 | |
| hdc start app | 启动APP | |
| hdc restart app | 重启APP | |
| hdc clean app data | 清除APP缓存数据 | |
| hdc clean app data and restart | 清除APP缓存数据并重新启动 | |
| hdc start app with debugger | 以调试模式启动APP | APP关闭的前提下执行，启动后手动点击DevEco 的， [(详细使用方式)](#1) |
| hdc restart app with debugger | 以调试模式**重新启动**APP | APP关闭或者前台情况下都可以执行，启动后手动点击DevEco 的， [(详细使用方式)](#2) |
| hdc clean app data and restart | 清除APP缓存数据并重新启动 | |
| hdc copy string to phone's clipboard | **将PC端剪贴板的最新内容拷贝到手机/模拟器的剪贴板上** | 需要在手机/模拟器上安装 「hdc tools」这个APP，请勿卸载！(无任何安全隐患，放心食用~)源码公开： |
以上所有功能中，个人感觉最后一个 **hdc copy string to app's clipboard** 最实用，轻松的将
***电脑端复制的内容拷贝到手机/模拟器的剪贴板上~*** 逐步实现类似于安卓开发中的dab she'll input text 命令（逐步完善中）
## 如何使用
> 注意：
>
>1.使用期间，需要在手机/模拟器上安装一个 hdc tools 应用(.hap)
> ，此APP起到辅助作用，无任何副作用，放心食用，切记不要卸载！源码链接：[harmony_hdc_tools](https://gitee.com/yanftch/harmony_hdc_tools)
>
>2.如果 hdc tools
> 未安装，可以手动下载安装一下，链接如下：[harmony_hdc_tools.hap](https://gitee.com/mahongyin/harmony_hdc_tools/blob/master/harmony_hdc_tools.hap)
>
>
**详细使用方式按照三步走**
### 第一步：下载安装
1. 在线安装
在 DevEco Studio 依次点击 `Preferences` -> `Plugins` ,选择左边的 `MarketPlace`，然后在搜索框中输入 `HdcDevtools`
进行搜索，搜索到之后，点击安装即可（目前DevEco Studio 对接的 Jetbrains Marketplace
不稳定，可能会存在搜不到的情况，此时建议使用第二种安装方式 ）
截图中参考了其他名字的搜索，到时候直接搜索 `hdcdevtools` 就行
2. 离线安装
2.1 去 Jetbrains MarketPlace 市场下载最新版的插件：[地址如下](https://plugins.jetbrains.com/plugin/29790-hdcdevtools)
下载后存放到PC本地任意目录下
2.2 在 DevEco Studio 依次点击 `Preferences` -> `Plugins` , 选择右边的 `设置`图标，然后选择
`Install Plugin from Disk...`，找到刚才下载的 插件包，选择安装，然后重启DevEco Studio 即可。
### 第二步：基础配置
> 鸿蒙开发中对于源码结构, 自动获取应用相关的 bundleName、defaultAbility(可以理解为APP的启动页面)、`hdc`默认取DevEco自带的hdc,如果没有需要配置hdc环境变量。
> 注意下：蒲公英pgyer和ftpserver需要针对每个项目手动配置参数，此配置项跟项目绑定，不同的项目需要多次设置
>
>
>
第一步中安装完成后，在 `Preferences` 手动配置一下 当前鸿蒙项目的 `bundleName` 、`defaultAbility`、`hdcPath`
的值，便于后续准确调用相关命令。
- bundleName: APP的唯一标识，取自 项目结构下 `AppScope` -> `app.json5`
- defaultAbility: APP启动的第一个页面对应的 Ability 的名字。eg:默认新建一个鸿蒙项目的 defaultAbility 叫做 `EntryAbility`
- hdcPath: 环境变量中配置的hdc的路径，比如：/Users/yanfeng/develop/toolchains/hdc **切记需要带有hdc结尾；Windows系统应该是
hdc.exe 结尾**
**注意：上述配置文件是跟项目绑定的，配置文件 `hdc_tools_info_settings.xml` 会存储在 `项目目录` > `.idea` 目录里**
### 第三步：使用
在 DevEco Studio 中，通过 顶部 `Tools` -> `hdc tools` 点击，即可唤起操作面板；或者使用快捷键 `Control+Shift+D`(
Mac系统，Windows系统可以通过 Tools -> hdc tools 尾部查看对应的快捷键，后续可以自己修改适合自己的快捷键)便捷唤起。
然后选择自己需要执行的操作即可
## 部分指令使用详解
## hdc start app with debugger
(以调试模式启动APP)
作用：
> 便于调试那些需要在APP刚启动的场景下的一些调试逻辑
操作步骤：
- 1.关闭APP
- 2.执行此命令
- 3.手动在 DevEco Studio 中添加 Debugger
3对应的位置截图
## hdc restart app with debugger
(以调试模式重新启动APP)
整体作用、使用方式跟上边那个一致，只不过这个不用手动关闭APP了，即APP非关闭状态也可以使用。
## 插件地址
https://plugins.jetbrains.com/plugin/29790-hdcdevtools
## 其他好用的插件
JsonFormat:
https://juejin.cn/post/7395396352183205898
---
1.JSON、JavaBean、ets 之间无痕转换
> https://plugins.jetbrains.com/plugin/24930-jsonformat
2.Json 转成 ets 文件
> https://plugins.jetbrains.com/plugin/25151-json2ets
------------------------------------------------------------------------------------------------------------------------