hdc组件

简介
架构
目录
- 使用说明
相关仓

简介

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

架构

hdc主要有三部分组成：

hdc client部分：运行于开发机上的客户端，用户可以在开发机命令终端（windows cmd/linux shell）下请求执行相应的hdc命令，运行于开发机器，其它的终端调试IDE也包含hdc client。
hdc server部分：作为后台进程也运行于开发机器，server管理client和设备端daemon之间通信包括连接的复用、数据通信包的收发，以及个别本地命令的直接处理。
hdc daemon部分：daemon部署于鸿蒙设备端作为守护进程来按需运行，负责处理来自client端的请求。

/developtools
├── hdc_standard      # hdc代码目录
│   └── src
│       ├── common    # 设备端和host端公用的代码目录
│       ├── daemon    # 设备端的代码目录 
│       ├── host      # host端的代码目录
│       ├── test      # 测试用例的代码目录 
│   └── prebuilt      # 预编译目录，存放预编译的二进制文件

使用说明

hdc当前支持如下命令：

表 1 hdc命令列表

Option	Description
-t key	用于指定连接该指定设备识Key 举例：hdc -t *****(设备id) shell
-s socket	用于指定服务监听的socket配置举例：hdc -s ip:port
-h/help -v/version	用于显示hdc相关的帮助、版本信息
list targets[-v]	显示所有已经连接的目标设备列表，-v选项显示详细信息举例： hdc list targets
target mount	以读写模式挂载/system等分区举例： hdc target mount
smode [off]	授予后台服务进程root权限，使用off参数取消授权举例： hdc smode
kill [-r]	终止hdc服务进程, -r选项会触发再次重启hdc server 举例： hdc kill
start [-r]	启动hdc服务进程, -r选项会触发重启hdc server 举例： hdc start
tconn host[:port][-remove]	通过【ip地址：端口号】来指定连接的设备举例： hdc tconn 192.168.0.100:10178
tmode usb	执行后设备端对应daemon进程重启，并首先选用usb连接方式
tmode port port-number	执行后设备端对应daemon进程重启，并优先使用网络方式连接设备，如果连接设备再选择usb连接
fport list	查看所有已建立的映射连接列表，显示的参数包括转发配置字符串，转发类型，转发参数
fport rm local	删除已映射的给定配置字符串连接(配置字符串值可以通过list获取)，没有指定则删除所有
file send local remote	从host端发送文件至设备端举例： hdc file send E:\a.txt /data/local/tmp
file recv [-a] remote local	从设备端拉出文件至本地host端举例： hdc file recv /data/local/tmp/a.txt ./
install [-r/-d/-g] package	安装 OpenHarmony package 举例： hdc install ***.hap
uninstall [-k] package	卸载 OpenHarmony应用
hilog	支持查看抓取hilog调试信息举例： hdc hilog
shell [command]	远程执行命令或进入交互命令环境举例： hdc shell

以下是常用hdc命令示例，供开发者参考：

查看设备连接信息
```
hdc list targets
```

往设备中推送文件

hdc file send  E:\a.txt  /data/local/tmp

重启设备
```
hdc target boot
```
查看日志
```
hdc hilog
```
进入命令行交互模式
```
hdc shell
```
配置服务监听的socket。
```
hdc -s 192.168.1.100:1234 
```
重启至bootloader模式。
```
hdc target boot bootloader
```
网络连接。
```
hdc tconn 192.168.0.100:8710
```

OpenHarmony/developtools_hdc_standard
关闭

hdc组件

简介

架构

目录

使用说明

相关仓

简介

发行版

贡献者

语言

近期动态

OpenHarmony/developtools_hdc_standard关闭 .gitee-modal { width: 500px !important; }

hdc组件

简介

架构

目录

使用说明

相关仓

简介

发行版

开源评估指数源自 OSS-Compass 评估体系，评估体系围绕以下三个维度对项目展开评估：

贡献者

语言

近期动态

搜索帮助

OpenHarmony/developtools_hdc_standard
关闭