【鸿蒙开辟】OpenHarmony调测工具hdc使用教程(装备开辟者) ...

00. 目次


  
01. OpenHarmony概述

OpenHarmony是由开放原子开源基金会（OpenAtom Foundation）孵化及运营的开源项目，目标是面向全场景、全连接、全智能时代，基于开源的方式，搭建一个智能终端装备利用体系的框架宁静台，促进万物互联财产的繁荣发展。
OpenHarmony整体服从分层设计，从下向上依次为：内核层、体系服务层、框架层和应用层。体系功能按照“体系 > 子体系 > 组件”逐级睁开，在多装备部署场景下，支持根据现实需求裁剪某些非必要的组件。OpenHarmony技能架构如下所示：

内核层

• 内核子体系：采用多内核（Linux内核或者LiteOS）设计，支持针对不同资源受限装备选用适合的OS内核。内核抽象层（KAL，Kernel Abstract Layer）通过屏蔽多内核差异，对上层提供基础的内核本领，包括进程/线程管理、内存管理、文件体系、网络管理和外设管理等。
  
• 驱动子体系：驱动框架（HDF）是体系硬件生态开放的基础，提供统一外设访问本领和驱动开辟、管理框架。
  

体系服务层
体系服务层是OpenHarmony的核心本领聚集，通过框架层对应用步伐提供服务。该层包罗以下几个部门：

• 体系根本本领子体系集：为分布式应用在多装备上的运行、调治、迁徙等利用提供了基础本领，由分布式软总线、分布式数据管理、分布式任务调治、公共基础库、多模输入、图形、安全、AI等子体系组成。
  
• 基础软件服务子体系集：提供公共的、通用的软件服务，由事件关照、电话、多媒体、DFX（Design For X） 等子体系组成。
  
• 加强软件服务子体系集：提供针对不同装备的、差异化的本领加强型软件服务，由智慧屏专有业务、穿戴专有业务、IoT专有业务等子体系组成。
  
• 硬件服务子体系集：提供硬件服务，由位置服务、用户IAM、穿戴专有硬件服务、IoT专有硬件服务等子体系组成。
  

根据不同装备形态的部署情况，基础软件服务子体系集、加强软件服务子体系集、硬件服务子体系集内部可以按子体系粒度裁剪，每个子体系内部又可以按功能粒度裁剪。
框架层
框架层为应用开辟提供了C/C++/JS等多语言的用户步伐框架和Ability框架，适用于JS语言的ArkUI框架，以及各种软硬件服务对外开放的多语言框架API。根据体系的组件化裁剪程度，装备支持的API也会有所不同。
应用层
应用层包括体系应用和第三方非体系应用。应用由一个或多个FA（Feature Ability）或PA（Particle Ability）组成。此中，FA有UI界面，提供与用户交互的本领；而PA无UI界面，提供后台运利用命的本领以及统一的数据访问抽象。基于FA/PA开辟的应用，可以或许实现特定的业务功能，支持跨装备调治与分发，为用户提供一致、高效的应用体验。
技能特性
硬件互助，资源共享
主要通过下列模块告竣

• 分布式软总线
  分布式软总线是多装备终端的统一基座，为装备间的无缝互联提供了统一的分布式通信本领，可以或许快速发现并连接装备，高效地传输任务和数据。
  
• 分布式数据管理
  分布式数据管理基于分布式软总线，实现了应用步伐数据和用户数据的分布式管理。用户数据不再与单一物理装备绑定，业务逻辑与数据存储分离，应用跨装备运行时数据无缝衔接，为打造一致、流畅的用户体验创造了基础条件
  
• 分布式任务调治
  分布式任务调治基于分布式软总线、分布式数据管理、分布式Profile等技能特性，构建统一的分布式服务管理（发现、同步、注册、调用）机制，支持对跨装备的应用举行远程启动、远程调用、绑定/解绑、以及迁徙等利用，可以或许根据不同装备的本领、位置、业务运行状态、资源使用情况并结适用户的风俗和意图，选择最合适的装备运行分布式任务
  
• 装备虚拟化
  分布式装备虚拟化平台可以实现不同装备的资源融合、装备管理、数据处理，将周边装备作为手机本领的延伸，共同形成一个超等虚拟终端。
  

一次开辟，多端部署
OpenHarmony提供用户步伐框架、Ability框架以及UI框架，可以或许保证开辟的应用在多终端运行时保证一致性。一次开辟、多端部署。
多终端软件平台API具备一致性，确保用户步伐的运行兼容性。

• 支持在开辟过程中预览终端的本领适配情况（CPU/内存/外设/软件资源等）。
  
• 支持根据用户步伐与软件平台的兼容性来调治用户呈现。
  

统一OS，弹性部署
OpenHarmony通过组件化和组件弹性化等设计方法，做到硬件资源的可大可小，在多种终端装备间，按需弹性部署，全面覆盖了ARM、RISC-V、x86等各种CPU，从百KiB到GiB级别的RAM。
02. hdc简介

hdc（OpenHarmony Device Connector）是 OpenHarmony 为开辟人员提供的用于调试的命令行工具，通过该工具可以在Windows/Linux/MacOS等体系上与开辟机或者模拟器举行交互。
03. hdc获取

hdc 工具获取方式：
通过OpenHarmony sdk获取，hdc在sdk的toolchains目次下。
使用举例：
下面以windows侧使用方式举例：
获取windows的sdk，将hdc.exe放到磁盘某个位置即可使用。
注意事项
   

• 使用hdc，如果出现非常，可以尝试通过hdc kill
  命令杀掉hdc服务，或者通过hdc start -r命令重启服务进程举行解决。
  
• 如果出现hdc list targets获取不到装备信息，通过任务管理器查看是否有hdc进程存在，如果进程存在，可以通过杀掉该进程举行解决。
  

  04. option相关的命令

option涉及以下命令：

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

命令说明
返回值返回值说明返回对应信息帮助或者版本信息 示例

1. # 查看帮助信息
2. D:\tools>hdc -h
4. D:\tools>hdc help
6. # 查看版本信息
7. D:\tools>hdc -v
8. Ver: 1.1.1l
10. D:\tools>hdc version
11. Ver: 1.1.1l

复制代码

• -l 0-5 用于指定运行时日志品级,默认为LOG_INFO。
  

命令说明
参数参数说明0LOG_OFF1LOG_FATAL2LOG_WARN3LOG_INFO4LOG_DEBUG5LOG_ALL 示例

1. D:\tools>hdc -l5 start
2. [D][2025-03-08 19:14:13.154][1228][channel.cpp:341] Mallocchannel:564292774
3. [D][2025-03-08 19:14:13.155][1228][base.cpp:761] File "HDCServer" locked. proc already exit!!!
5. [D][2025-03-08 19:14:13.156][1228][channel.cpp:424] Begin to free channel, channelid:564292774
6. [D][2025-03-08 19:14:13.156][1228][main.cpp:346] !!!!!!!!!Main finish main
8. D:\tools>

复制代码

• -t key 用于连接指定装备标识为key的装备。
  

命令说明
参数参数说明key为 IP地址:port 格式，或者USB序列号返回值返回值说明①error: device ‘***’ not found
②Nothing to do…①装备不存在
②附加的命令不存在 示例
该option需要与详细的利用命令搭配使用，下面以shell命令举例：

1. hdc list targets （获取设备信息）
3. hdc -t key shell （-t后面添加的_key_ 需要替换为上面查询的设备信息）
5. D:\tools>hdc list targets
6. 2f011130375330303010b6204718ab00
8. D:\tools>hdc -t 2f011130375330303010b6204718ab00 shell
9. #

复制代码

说明
   一台开辟机可支持多个装备连接，每个装备有其唯一的装备标识，如果通过网络与装备连接,其标识为IP地址:port格式，如果通过USB连接则标识为装备sn号。该命令需要跟随详细利用命令。
  

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

命令说明
返回值返回值说明Client version: server version:client-server版本号 示例

1. D:\tools>hdc checkserver

复制代码

05. 查询装备列表的命令

查询装备列表涉及以下命令：

1. list targets[-v]

复制代码

表现全部已经连接的目标装备列表
表5 命令说明
参数参数说明-v添加-v选项，则会打印装备详细信息返回值返回值说明①返回装备信息
②[Empty]①已经连接的装备列表信息
②没有查询到装备信息 示例

1. D:\tools>hdc list targets
2. 2f011130375330303010b6204718ab00
4. D:\tools>hdc list targets -v
5. 2f011130375330303010b6204718ab00                USB     Connected       localhost
6. COM1            UART    Ready
7. COM3            UART    Ready
8. COM4            UART    Ready
10. D:\tools>

复制代码

06. 服务进程相关命令

服务进程涉及以下命令：

• target mount 以读写模式挂载体系分区。
  表6 命令说明
     参数参数说明无无返回值返回值说明①Mount finish
  ②返回详细信息①乐成情况下返回的信息
  ②失败情况下的详细信息
  

示例

1. D:\tools>hdc target mount
2. Mount finish

复制代码

• target boot 装备重启。
  

示例

1. D:\tools>hdc target boot

复制代码

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

示例

1. D:\tools>hdc smode
3. D:\tools>
4. D:\tools>hdc smode -r

复制代码

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

命令说明
参数参数说明-r触发服务重启返回值返回值说明①Kill server finish
②返回详细信息①乐成情况下返回的信息
②失败情况下的详细信息 示例

1. D:\tools>hdc kill
3. Kill server finish
5. D:\tools>

复制代码

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

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

1. D:\tools>hdc start
3. D:\tools>

复制代码

07. 网络相关的命令

网络部门涉及以下命令：

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

命令说明
参数参数说明host[:port]为IP地址:port格式-remove表示断开与指定装备的连接返回值返回值说明①返回详细信息
②无①失败情况下的详细信息
②乐成情况下无返回值 示例

1. D:\tools>hdc tconn 192.168.0.100:8710

复制代码

• tmode usb 执行后装备端对应daemon进程重启，并首先选用USB连接方式。
  

命令说明
参数参数说明无无返回值返回值说明①返回详细信息
②无①失败情况下的详细信息
②乐成情况下无返回值 示例

1. hdc tmode usb

复制代码

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

命令说明
参数参数说明port-numberlisten连接的网络端口号返回值返回值说明①返回详细信息
②无①失败情况下的详细信息
②乐成情况下无返回值 示例

1. hdc tmode port 8710

复制代码

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

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

示例

1. hdc fport tcp:1234 tcp:1080

复制代码

• rport remotenode localnode 端口转发，指定 装备侧端口 转发数据到 主机端口。
  

示例

1. hdc rport tcp:2080 tcp:2345

复制代码

• fport ls 列出全部转发端口转发任务。
  

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

1. hdc fport ls

复制代码

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

示例

1. hdc fport rm tcp:1234 tcp:1080

复制代码

08. 文件相关的命令

文件部门涉及以下命令：

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

命令说明
参数参数说明local当地待发送文件路径remote远程待接收文件路径返回值返回值说明①返回详细信息
②返回传输结果①失败情况下的详细信息
②乐成传输的结果信息 示例

1. D:\tools>hdc file send D:\tools/SN.txt /data/local/tmp/SN.txt
2. FileTransfer finish, Size:22, File count = 1, time:31ms rate:0.71kB/s
4. D:\tools>

复制代码

• file recv [-a] remote local 从远端装备接收文件至当地。
  

命令说明
参数参数说明-a文件保留时间戳模式local当地待接收文件路径remote远程待发送文件路径返回值返回值说明①返回详细信息
②无①失败情况下的详细信息
②乐成情况下无返回值 示例

1. D:\tools>hdc file recv /data/local/tmp/SN.txt ./a.txt
2. FileTransfer finish, Size:22 time:3ms rate:7.33kB/s

复制代码

09. 应用相关的命令

应用部门涉及以下命令：

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

命令说明
参数参数说明packageOpenHarmony应用安装包文件名-r更换已存在应用-d允许降级安装-g应用动态授权返回值返回值说明①返回详细信息
②无①失败情况下的详细信息
②乐成情况下无返回值 示例

1. hdc install hwadmin.hap

复制代码

• uninstall [-k] package 卸载OpenHarmony应用。
  

命令说明
参数参数说明packageOpenHarmony应用安装包-k保留/data/cache返回值返回值说明①返回详细信息
②无①失败情况下的详细信息
②乐成情况下无返回值 示例

1. hdc uninstall package

复制代码

10. 调试相关的命令

调试涉及以下命令：

• hilog 支持抓取log信息。
  

命令说明
参数参数说明无无返回值返回值说明返回详细信息抓取的日志信息 抓取hilog日志：

1. hdc hilog

复制代码

清算hilog缓存日志：

1. hdc shell
2. "hilog -r"

复制代码

• shell [command] 远程执行命令或进入交互命令情况。
  

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

1. hdc shell

复制代码

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

示例

1. D:\tools>hdc jpid
2. 1037
3. 1061
4. 1105
5. 1117
6. 1260
7. 1653

复制代码

11. 常见题目

11.1 hdc连接不到装备

• 征象描述 执行 "hdc list targets"命令后结果为：[Empty]
  
• 解决方法
  
  
  • 装备没有被辨认： 在装备管理器中查看是否有hdc装备，在通用串行总线装备中会有“HDC Device”信息。如果没有，hdc无法连接。此时需要断开并重联PC和OpenHarmony装备之间的USB连接，或者烧写最新的镜像。
    
  • hdc工作非常： 可以执行"hdc kill
    "或者"hdc start -r"杀掉hdc服务或者重启hdc服务，然后再执行hdc list targets查看是否已经可以获取装备信息。
    
  • hdc与装备不匹配： 如果装备烧写的是最新镜像，hdc也需要使用最新版本。
    
  
  

11.2 hdc运行不了

• 征象描述 点击hdc.exe文件无法运行。
  
• 解决方法
  
  
  • 运行情况非常： linux版本发起ubuntu 18.04以上 64位，其他相近版本也可；libc++.so引用错误请使用ldd/readelf等命令检查库引用 windows版本发起windows10 64位，如果低版本windows winusb库缺失，请使用zadig更新库。对于复合装备，需要使用zadig工具安装libusb-win32驱动。
    
  • 怎样运行hdc.exe： hdc.exe不需要安装，直接放到磁盘上就能使用，也可以添加到情况变量中。通过打开cmd执行hdc命令直接使用。
    
  
  

11.3 hdc client怎样远程访问hdc server

• 使用场景
  当地client指定远程server上的装备，执行hdc命令。
  
• 连接步骤
  
  
  
  • 关闭当地sever：
    
    1. hdc kill

    复制代码
  • -s [ip:]port -m
    启动远程server：
    
    1. hdc -s severIP:8710 -m

    复制代码
  • -s [ip:]port command
    指定server执行指令：
    
    1. hdc -s severIP:8710 list targets

    复制代码
  
  

12. 附录


免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。