【入门到实战】OpenHarmony设备开发:hdc使用指南

OpenHarmony实战:命令行工具hdc安装应用指南 适用于 OpenHarmony 应用、硬件开发及测试人员,是每个开发人员的必备、入门工具。 阅读详情
AI摘要

本文围绕OpenHarmony设备开发中的hdc工具展开,介绍其是用于调试的命令行工具,可在多系统与开发机或模拟器交互。详细说明了环境准备、使用注意事项,列举option、查询设备列表、服务进程、网络、文件、应用、调试等相关命令及使用举例,还给出常见问题的解决办法。

往期鸿蒙5.0全套实战文章必看:(文中附带全栈鸿蒙5.0学习资料)


hdc使用

hdc(OpenHarmony Device Connector)是 OpenHarmony 为开发人员提供的用于调试的命令行工具,通过该工具可以在Windows/Linux/MacOS等系统上与开发机或者模拟器进行交互。

下文将介绍hdc的环境准备和常用命令及使用举例。

环境准备

hdc 工具获取方式:

通过OpenHarmony sdk获取,hdc在sdk的toolchains目录下。

使用举例:

下面以windows侧使用方式举例:

获取windows的sdk,将hdc.exe放到磁盘某个位置即可使用。

注意事项

  • 使用hdc,如果出现异常,可以尝试通过hdc kill命令杀掉hdc服务,或者通过hdc start -r命令重启服务进程进行解决。

  • 如果出现hdc list targets获取不到设备信息,通过任务管理器查看是否有hdc进程存在,如果进程存在,可以通过杀掉该进程进行解决。

option相关的命令

option涉及以下命令:

  • -h/help -v/version 用于显示hdc相关的帮助、版本信息。

    表1 命令说明

    返回值返回值说明
    返回对应信息帮助或者版本信息

    使用方法:

    hdc -h / hdc help
    hdc -v / hdc version
    
  • -l 0-5 用于指定运行时日志等级,默认为LOG_INFO。

    表2 命令说明

    参数参数说明
    0LOG_OFF
    1LOG_FATAL
    2LOG_WARN
    3LOG_INFO
    4LOG_DEBUG
    5LOG_ALL

    使用方法:

    hdc -l5 start
    
  • -t key 用于连接指定设备标识为key的设备。

    表3 命令说明

    参数参数说明
    key为 IP地址:port 格式,或者USB序列号
    返回值返回值说明
    ①error: device ‘***’ not found
    ②Nothing to do…
    ①设备不存在
    ②附加的命令不存在

    使用方法:

    该option需要与具体的操作命令搭配使用,下面以shell命令举例:

    hdc list targets (获取设备信息)

    hdc -t key shell (-t后面添加的_key_ 需要替换为上面查询的设备信息)

    icon-note.gif

     说明: 一台开发机可支持多个设备连接,每个设备有其唯一的设备标识,如果通过网络与设备连接,其标识为IP地址:port格式,如果通过USB连接则标识为设备sn号。该命令需要跟随具体操作命令。

  • checkserver 用于获取client-server版本。

    表4 命令说明

    返回值返回值说明
    Client version: server version:client-server版本号

    使用方法:

    hdc checkserver
    

查询设备列表的命令

查询设备列表涉及以下命令:

list targets[-v]

显示所有已经连接的目标设备列表

表5 命令说明

参数参数说明
-v添加-v选项,则会打印设备详细信息
返回值返回值说明
①返回设备信息
②[Empty]
①已经连接的设备列表信息
②没有查询到设备信息

使用方法:

hdc list targets
hdc list targets -v

服务进程相关命令

服务进程涉及以下命令:

  • target mount 以读写模式挂载系统分区。

    表6 命令说明

    参数参数说明
    无无
    返回值返回值说明
    ①Mount finish
    ②返回具体信息
    ①成功情况下返回的信息
    ②失败情况下的具体信息

    使用方法:

    hdc target mount
    
  • target boot 设备重启。

    使用方法:

    hdc target boot
    
  • smode [-r] 授予后台服务进程root权限, 使用-r参数取消授权。

    使用方法:

    hdc smode
    hdc smode -r
    
  • kill [-r] 终止服务进程。

    表7 命令说明

    参数参数说明
    -r触发服务重启
    返回值返回值说明
    ①Kill server finish
    ②返回具体信息
    ①成功情况下返回的信息
    ②失败情况下的具体信息

    使用方法:

    hdc kill
    
  • start [-r] 启动服务进程。

    表8 命令说明

    参数参数说明
    -r如果服务进程已经启动,-r选项会触发服务进程重新启动
    返回值返回值说明
    无无

    使用方法:

    hdc start
    

网络相关的命令

网络部分涉及以下命令:

  • tconn host[:port][-remove] 通过【ip地址:端口号】来指定连接的设备

    表9 命令说明

    参数参数说明
    host[:port]为IP地址:port格式
    -remove表示断开与指定设备的连接
    返回值返回值说明
    ①返回具体信息
    ②无
    ①失败情况下的具体信息
    ②成功情况下无返回值

    使用方法(举例):

    hdc tconn 192.168.0.100:8710
    
  • tmode usb 执行后设备端对应daemon进程重启,并首先选用USB连接方式。

    表10 命令说明

    参数参数说明
    无无
    返回值返回值说明
    ①返回具体信息
    ②无
    ①失败情况下的具体信息
    ②成功情况下无返回值

    使用方法:

    hdc tmode usb
    
  • tmode port port-number 执行后设备端对应daemon进程重启,并优先使用网络方式连接设备,如果连接设备失败,再选择USB连接。

    表11 命令说明

    参数参数说明
    port-numberlisten连接的网络端口号
    返回值返回值说明
    ①返回具体信息
    ②无
    ①失败情况下的具体信息
    ②成功情况下无返回值

    使用方法:

    hdc tmode port 8710
    
    

    icon-note.gif

     说明: 执行完毕后,远端daemon将会退出并重启,默认启用TCP连接,如果不加上listen端口则listen随机端口。

  • fport localnode remotenode 端口转发,指定 主机端口 转发数据到 设备侧端口。

    使用方法:

    hdc fport tcp:1234 tcp:1080
    
  • rport remotenode localnode 端口转发,指定 设备侧端口 转发数据到 主机端口。

    使用方法:

    hdc rport tcp:2080 tcp:2345
    
  • fport ls 列出全部转发端口转发任务。

    表12 命令说明

    参数参数说明
    无无
    返回值返回值说明
    ‘tcp:1234 tcp:1080’ [Forward]正向端口转发任务
    ‘tcp:2080 tcp:2345’ [Reverse]反向端口转发任务

    使用方法:

    hdc fport ls
    
  • fport rm 删除指定端口转发任务。

    使用方法:

    hdc fport rm tcp:1234 tcp:1080
    

文件相关的命令

文件部分涉及以下命令:

  • file send local remote 发送文件至远端设备。

    表13 命令说明

    参数参数说明
    local本地待发送文件路径
    remote远程待接收文件路径
    返回值返回值说明
    ①返回具体信息
    ②返回传输结果
    ①失败情况下的具体信息
    ②成功传输的结果信息

    使用方法(举例):

    hdc file send E:\a.txt   /data/local/tmp/a.txt
    
  • file recv [-a] remote local 从远端设备接收文件至本地。

    表14 命令说明

    参数参数说明
    -a文件保留时间戳模式
    local本地待接收文件路径
    remote远程待发送文件路径
    返回值返回值说明
    ①返回具体信息
    ②无
    ①失败情况下的具体信息
    ②成功情况下无返回值

    使用方法(举例):

    hdc file recv  /data/local/tmp/a.txt   ./a.txt
    

应用相关的命令

应用部分涉及以下命令:

  • install [-r/-d/-g] package 安装OpenHarmony APP package。

    表15 命令说明

    参数参数说明
    packageOpenHarmony应用安装包文件名
    -r替换已存在应用
    -d允许降级安装
    -g应用动态授权
    返回值返回值说明
    ①返回具体信息
    ②无
    ①失败情况下的具体信息
    ②成功情况下无返回值

    使用方法(举例):

    hdc install hwadmin.hap
    
  • uninstall [-k] package 卸载OpenHarmony应用。

    表16 命令说明

    参数参数说明
    packageOpenHarmony应用安装包
    -k保留/data/cache
    返回值返回值说明
    ①返回具体信息
    ②无
    ①失败情况下的具体信息
    ②成功情况下无返回值

    使用方法(举例):

    hdc uninstall package
    

调试相关的命令

调试涉及以下命令:

  • hilog 支持抓取log信息。

    表17 命令说明

    参数参数说明
    无无
    返回值返回值说明
    返回具体信息抓取的日志信息

    抓取hilog日志:

    hdc hilog
    

    清理hilog缓存日志:

    hdc shell "hilog -r"
    
  • shell [command] 远程执行命令或进入交互命令环境。

    表18 命令说明

    参数参数说明
    command需要执行的单次命令
    返回值返回值说明
    返回具体信息shell后面执行命令的结果信息

    使用方法:

    hdc shell
    
  • jpid 获取可调试进程列表。

    使用方法:

    hdc jpid
    

常见问题

hdc连接不到设备

  • 现象描述 执行 "hdc list targets"命令后结果为:[Empty]

  • 解决方法

    1. 设备没有被识别: 在设备管理器中查看是否有hdc设备,在通用串行总线设备中会有“HDC Device”信息。如果没有,hdc无法连接。此时需要断开并重联PC和OpenHarmony设备之间的USB连接,或者烧写最新的镜像。
    2. hdc工作异常: 可以执行"hdc kill"或者"hdc start -r"杀掉hdc服务或者重启hdc服务,然后再执行hdc list targets查看是否已经可以获取设备信息。
    3. hdc与设备不匹配: 如果设备烧写的是最新镜像,hdc也需要使用最新版本。

hdc运行不了

  • 现象描述 点击hdc.exe文件无法运行。

  • 解决方法

    1. 运行环境异常: linux版本建议ubuntu 18.04以上 64位,其他相近版本也可;libc++.so引用错误请使用ldd/readelf等命令检查库引用 windows版本建议windows10 64位,如果低版本windows winusb库缺失,请使用zadig更新库。对于复合设备,需要使用zadig工具安装libusb-win32驱动。
    2. 如何运行hdc.exe: hdc.exe不需要安装,直接放到磁盘上就能使用,也可以添加到环境变量中。通过打开cmd执行hdc命令直接使用。

hdc client如何远程访问hdc server

  • 使用场景

    本地client指定远程server上的设备,执行hdc命令。

  • 连接步骤

    1. 关闭本地sever:
      hdc kill
      
    2. -s [ip:]port -m 启动远程server:
      hdc -s severIP:8710 -m
      
    3. -s [ip:]port command 指定server执行指令:
      hdc -s severIP:8710 list targets

Harmon实战开发:调测工具-hdc使用指导 hdc(OpenHarmony Device Connector)是 OpenHarmony 为开发人员提供的用于调试的命令行工具,通过该工具可以在Windows/Linux/MacOS等系统上与开发机或者模拟器进行交互。 阅读详情

相关推荐

鸿蒙开发神器HDC,使用秘籍全公开!

HDC 作为鸿蒙开发中不可或缺的工具,为开发者提供了丰富且强大的功能。从设备连接管理到应用管理,从文件传输到安全相关命令,它贯穿了鸿蒙应用开发的各个环节,极大地提高了开发效率,让我们能够更加便捷地与鸿蒙设备进行交互和调试。在未来的鸿蒙开发中,随着鸿蒙系统应用场景的不断拓展,从智能穿戴设备到智能家居、智能汽车等领域,HDC 也将不断进化和完善。我们有理由期待 HDC 在未来能够支持更多新特性,比如更高效的分布式调试功能,以满足日益复杂的分布式应用开发需求;

大雨淅淅的博客 2668

hdc常用命令大全

当我们在使用命令行或脚本时,经常会遇到一些报错信息,其中一个常见的错误是"hdc不是内部或外部命令"。这个错误一般出现在Windows系统中,它意味着系统无法找到我们输入的命令或执行的脚本。那么需要系统属性---环境变量PATH里添加hdc.exe的路径。一般路径为:C:\Users\name\AppData\Local\Huawei\Sdk\openharmony\9\toolchains。

跟踪世界脚步 1万+

OpenHarmony实战开发-HDC-OpenHarmony设备连接器

HDC(OpenHarmony Device Connector) 是为开发人员提供的用于设备连接调试的命令行工具,pc端开发机使用命令行工具hdc,该工具需支持部署在Windows/Linux/Mac等系统上与OpenHarmony设备(或模拟器)进行连接调试通信。PC端hdc工具需要针对以上开发机操作系统平台分别发布相应的版本,设备端hdc daemon需跟随设备镜像发布包括对模拟器进行支持。下文将介绍hdc的常用命令及使用举例

2401_82546228的博客 3508

OpenHarmony 开源鸿蒙北向开发——hdc工具安装

该工具需支持部署在 Windows/Linux/Mac 等系统上与 OpenHarmony 设备(或模拟器)进行连接调试通信。简单来讲,hdc 是 OpenHarmony 提供的用于开发人员调试硬件、应用的命令行工具,用在电脑与开发板之间的交互。hdc适用于 OpenHarmony 应用、硬件开发及测试人员,是每个开发人员的必备、入门工具。

我是晚秋,我在这里,谢谢你的看见。 3757

Openharmony 命令行工具hdc的获取与安装

OpenHarmony实战:命令行工具hdc安装应用指南_hdc工具-优快云博客t=N7T8。

Devlin_的博客 1万+

OpenHarmony之HDC

本文介绍了矿鸿开发板连接电脑并进行程序安装的详细过程。首先需要配置HDC工具环境变量,包括设置HDC_SERVER_PORT端口和添加SDK路径。连接设备后,通过hdc list targets命令获取设备信息,使用hdc shell进入调试模式。重点讲解了程序安装命令hdc install的使用方法及参数说明,包括-r替换、-d降级安装等选项,并提供了卸载应用的hdc uninstall命令格式。文章还提醒开发者需确保工程类型为OpenHarmony,并给出了完整的安装流程示例。

Chaunceyin的博客 1453

【鸿蒙开发】OpenHarmony调测工具hdc使用教程(设备开发者)

OpenHarmony是由开放原子开源基金会(OpenAtom Foundation)孵化及运营的开源项目,目标是面向全场景、全连接、全智能时代,基于开源的方式,搭建一个智能终端设备操作系统的框架和平台,促进万物互联产业的繁荣发展。OpenHarmony整体遵从分层设计,从下向上依次为:内核层、系统服务层、框架层和应用层。系统功能按照“系统 > 子系统 > 组件”逐级展开,在多设备部署场景下,支持根据实际需求裁剪某些非必要的组件。内核层。

C/C++软件工程师、嵌入式软件工程师、物联网研发工程师、C/C++讲师、物联网讲师、嵌入式讲师、鸿蒙讲师---欢迎大家一起交流(私信添加博主微信) 3259

OpenHarmony南向设备开发:命令行工具hdc安装应用指南

适用于 OpenHarmony 应用、硬件开发及测试人员,是每个开发人员的必备、入门工具。

初一十五的博客 1400

OpenHarmony命令行工具hdc安装应用指南

OpenHarmony命令行工具hdc安装、应用指南详细阐述了hdc工具下载、安装、路径的环境配置和USB驱动安装。接下来完整给出了19条hdc命令用法及正确输出示意。最后列出典型的三种错误处理。

phmatthaus的专栏 2万+

鸿蒙开发进阶(OpenHarmony)hdc调试命令行工具

hdc(OpenHarmony Device Connector)是为开发人员提供的用于调试的命令行工具,通过该工具可以在windows/linux/mac系统上与设备进行交互。

wea22984984的博客 2426

OpenHarmony南向设备开发:使用远程hdc能力

DevEco Device Tool采用Windows+Ubuntu混合设备开发环境,降低了嵌入式开发的环境配置复杂度。

初一十五的博客 915

从HDC到Dropbear:OpenHarmony设备远程管理工具的演进与选择

本文深入分析了OpenHarmony设备远程管理工具HDC与Dropbear的技术演进与选型策略。针对RK3568等硬件平台,详细对比了两者在功能特性、性能表现和安全性方面的差异,为开发者提供基于Release版本的实践指导,帮助根据开发调试或生产环境需求做出最优选择。

i7j8k9l的博客 916

OpenHarmony之hdc

OpenHarmony之hdc | DD'NotesOpenHarmony之hdc简介 hdc(OpenHarmony Device Connector)是 OpenHarmony 为开发人员提供的用于调试的命令行工具,通过该工具可以在Windows/Linux/MacOS等系统上与开发机或者模拟器进行交互。类似于Android的adb,和adb类似,使用hdc的前提是开发机器hdc工具已安装好,设备端hdc已安装且已配置好。开发机HDC开发简介。

DD'Notes 626

Openharmony hdc和adb指令对应

ADB和hdc的指令对应

u013379032的博客 6588

鸿蒙OpenHarmony【hdc使用】 调测工具使用

hdc(OpenHarmony Device Connector)是 OpenHarmony 为开发人员提供的用于调试的命令行工具,通过该工具可以在Windows/Linux/MacOS等系统上与开发机或者模拟器进行交互。

adsjgfjha123123的博客 1770

别急着做AI:FDE教你识别真需求,让AI真正落地

人工智能项目在落地过程中,经常出现业务方高喊“我们要做AI”,却说不清具体应用场景的现象。判断一个需求是否值得用AI实现,不能只看技术流行度,而要从问题出现频率、当前替代方案以及可量化业务价值三个维度展开验证。同时需要冷静比较规则引擎与大模型的边界:不是所有语义任务都要靠生成式模型,稳定、可解释且低成本的传统方案往往更具工程性价比。数据闭环也至关重要,缺乏历史样本与反馈回流路径的项目,很难在真实环境中持续优化。针对智能客服、合同审查或企业知识库等典型场景,可借助人机协同与最小代价的用户验证,逐步筛除伪需求,

weixin_42624889的博客 343

HarmonyOS-hdc远程网络方式连接设备

hdc(OpenHarmony Device Connector)是为开发人员提供的用于设备连接调试的命令行工具,pc端开发机使用命令行工具hdc,该工具需支持部署在Windows/Linux/Mac等系统上与OpenHarmony设备(或模拟器)进行连接调试通信。PC端hdc工具需要针对以上开发机操作系统平台分别发布相应的版本,设备端hdc daemon需跟随设备镜像发布包括对模拟器进行支持。hdc组成关系图如下图所示:PC与设备侧,可以通过网络连接,也可以通过USB线连接。

邵东的博客 4763

扩视机器视觉—Halcon机器视觉48个实战项目六(检测定位角度)

此项目halcon检测检测定位角度问题,并显示。

qq_21516871的博客 1097

OpenHarmony之HDC配置问题

hdc(OpenHarmony Device Connector)是 OpenHarmony 为开发人员提供的用于调试的命令行工具,通过该工具可以在Windows/Linux/MacOS等系统上与开发机或者模拟器进行交互。

1354

Cadence SpectreRF仿真避坑指南:PSS和Pnoise设置详解(附实战案例)

本文详细解析了Cadence SpectreRF中PSS(周期稳态分析)和Pnoise(周期噪声分析)的关键设置技巧,帮助模拟IC设计工程师避开常见仿真陷阱。通过实战案例分享,涵盖引擎选择、Beat Frequency计算、噪声类型配置等核心参数优化策略,提升仿真精度与效率。特别针对开关电容电路和振荡器等复杂场景提供专业解决方案。

weixin_42613501的博客 602

LangGraph实战:用Plan-and-Execute模式5步搭建智能问答机器人(附Tavily搜索集成)

本文详细介绍了如何利用LangGraph的Plan-and-Execute模式,通过规划、执行、动态调整三个核心阶段,构建一个能够处理复杂多步骤问题的智能问答机器人。文章提供了从环境配置、状态管理到核心节点(规划、执行、重新规划)实现的完整实战指南,并集成了Tavily搜索工具,展示了如何将智能任务规划应用于实际信息查询场景。

weixin_29258297的博客 343

【鸿蒙开发】OpenHarmony调测工具hdc使用教程(应用开发者)

OpenHarmony是由开放原子开源基金会(OpenAtom Foundation)孵化及运营的开源项目,目标是面向全场景、全连接、全智能时代,基于开源的方式,搭建一个智能终端设备操作系统的框架和平台,促进万物互联产业的繁荣发展。OpenHarmony整体遵从分层设计,从下向上依次为:内核层、系统服务层、框架层和应用层。系统功能按照“系统 > 子系统 > 组件”逐级展开,在多设备部署场景下,支持根据实际需求裁剪某些非必要的组件。内核层。

C/C++软件工程师、嵌入式软件工程师、物联网研发工程师、C/C++讲师、物联网讲师、嵌入式讲师、鸿蒙讲师---欢迎大家一起交流(私信添加博主微信) 4479

别再让PyCharm吃光你的C盘!保姆级教程:安全迁移config、plugins和remote sources到D盘

本文提供了一份详细的PyCharm配置与缓存文件迁移指南,帮助开发者将config、plugins和remote sources等占用大量C盘空间的文件安全转移到D盘。通过修改data.properties文件和正确迁移顺序,确保PyCharm功能不受影响,同时释放宝贵的系统盘空间。

weixin_28836989的博客 424
上一篇: 【入门到实战】OpenHarmony设备开发:bytrace使用指南
下一篇: 【入门到实战】OpenHarmony设备开发:hiperf使用指南
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值