鸿蒙版本的ADB Idea (hdc tools) 来了

3,264 阅读6分钟

随机壁纸

随机Bing壁纸欣赏(狂按F5刷新壁纸)

hdc tools 鸿蒙命令行快捷操作工具

推个广,小子我近期搞了一些副业,虽然赚的不多,但是自己不用浪费太多时间,比较适合撸码的筒子们,有想了解的大佬可以私沃❤️❤️❤️

另外,近期打算启动一款新的IDE插件的开发,诚邀各位开发者“入伙”,哈哈,有想学习如何开发IDE插件或者已经“入坑”的大佬,欢迎共建,私沃“入伙”哈,💯💯💯

介绍

在鸿蒙开发中,我们可能会经常用到一些常用的 hdc 命令行来进行一些操作,比如来安装APP、卸载APP、清除缓存数据、同步剪贴板数据等等,正常的使用流程我们需要开启 终端 然后键入相关的命令行进行操作,如此流程相对较复杂一点。那么有没有这么一种操作,我直接在 DevEco Studio 中点几下鼠标甚至是通过快捷键,就能实现上述操作呢? 答案肯定是可以的~那么就来到了本文(插件)的舞台了~~~

PS:以下基于 DevEco Studio 5.0.30403 版本以及对应的模拟器进行验证;真机 Mate 60 Pro 验证

版本更新记录

plugin版本IDEA版本(开发)DevEco 版本备注
v1.0.02023.3.15.0.3.502
v1.0.12023.3.15.0.3.502
v1.0.22023.3.15.0.3.502
v1.0.32023.3.15.0.3.502
v1.0.42023.3.15.0.3.502
v1.0.52023.3.15.0.3.810
v1.0.62025.1.15.0.1 Release
---

v1.0.6

1.兼容最新的 Release 版本的 DevEco Studio

v1.0.5

1.修复了一些已知问题

2.兼容高版本DevEco Studio

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 appAPP杀掉进程
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以调试模式启动APPAPP关闭的前提下执行,启动后手动点击DevEco 的attach_debugger.png), (详细使用方式见底下)
hdc restart app with debugger以调试模式重新启动APPAPP关闭或者前台情况下都可以执行,启动后手动点击DevEco 的attach_debugger.png), (详细使用方式见底下)
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

2.如果 hdc tools 未安装,可以手动下载安装一下,链接如下:harmony_hdc_tools.hap

详细使用方式按照三步走

第一步:下载安装

  1. 在线安装 在 DevEco Studio 依次点击 Preferences -> Plugins ,选择左边的 MarketPlace,然后在搜索框中输入 hdc tools进行搜索,搜索到之后,点击安装即可(目前DevEco Studio 对接的 Jetbrains Marketplace 不稳定,可能会存在搜不到的情况,此时建议使用第二种安装方式 )

截图中参考了其他名字的搜索,到时候直接搜索 hdc tools 就行

MarketPlace 搜索 'hdc tools'

  1. 离线安装

    2.1 去 Jetbrains MarketPlace 市场下载最新版的插件:地址如下() 下载后存放到PC本地任意目录下

    2.2 在 DevEco Studio 依次点击 Preferences -> Plugins , 选择右边的 设置图标,然后选择 Install Plugin from Disk...,找到刚才下载的 插件包,选择安装,然后重启DevEco Studio 即可。

本地安装

第二步:基础配置

鉴于目前鸿蒙开发中对于源码结构的差异以及可操作性,获取应用相关的 bundleName、defaultAbility(可以理解为APP的启动页面) 无法准确获取,因此需要针对项目添加手动配置上述两个参数

增加:因为在DevEco Studio 中执行 终端 命令会存在无法准确获取相对地址的问题,因此 hdc 的环境变量配置也需要手动添加一下。

注意下:此配置项跟项目代码绑定,不同的项目需要多次设置

第一步中安装完成后,在 Preferences 手动配置一下 当前鸿蒙项目的 bundleNamedefaultAbilityhdcPath 的值,便于后续准确调用相关命令。

  • 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 尾部查看对应的快捷键,后续可以自己修改适合自己的快捷键)便捷唤起。 然后选择自己需要执行的操作即可

2_1.png

2_2.png

部分指令使用详解

hdc start app with debugger
(以调试模式启动APP)

作用:

便于调试那些需要在APP刚启动的场景下的一些调试逻辑

操作步骤:

  • 1.关闭APP
  • 2.执行此命令
  • 3.手动在 DevEco Studio 中添加 Debugger

3对应的位置截图

attach_debugger_big.png

hdc restart app with debugger
(以调试模式重新启动APP)

整体作用、使用方式跟上边那个一致,只不过这个不用手动关闭APP了,即APP非关闭状态也可以使用。

操作视频如下:

hdc-tools使用视频.gif

插件地址

plugins.jetbrains.com/plugin/2519…

其他好用的插件

JsonFormat:

juejin.cn/post/739539…


1.JSON、JavaBean、ets 之间无痕转换

plugins.jetbrains.com/plugin/2493…

2.Json 转成 ets 文件

plugins.jetbrains.com/plugin/2515…