?hdc（OpenHarmony Device Connector）是為開發人員提供的用于設備連接調試的命令行工具，該工具需支持部署在 Windows/Linux/Mac 等系統上與 OpenHarmony 設備（或模擬器）進行連接調試通信。簡單來講，hdc 是 OpenHarmony 提供的用于開發人員調試硬件、應用的命令行工具，用在電腦與開發板之間的交互。

hdc適用于 OpenHarmony 應用、硬件開發及測試人員，是每個開發人員的必備、入門工具。

官方文檔：文檔中心

參考資料：【全網最全】鴻蒙 HDC 命令合集 (awesome-hdc)_鴻蒙hdc-CSDN博客

一、使用方法

在使用hdc前，請在設備上開啟usb調試功能，用usb線連接設備和PC。

1.基本語法

單個設備連接

hdc <command>

多個設備連接

hdc -t <connectKey> <command>

-t: 連接指定的目標設備，連接一臺設備時為可選參數，連接多臺設備時為必選參數。

connectKey： 為已經連接設備的唯一標識符。可使用hdc list targets 命令獲得。

例如

這里獲取到的connectKey為880103534c4433324747a35fd1a01b00

則可以使用如下命令

2.參數講解

上面的命令中我們講解了-t的意義，這里講解一下所有的參數的意思。

參數	說明
-t	連接指定的目標設備，連接一臺設備時為可選參數，連接多臺設備時為必選參數。
-l	可選參數，指定運行時日志等級，范圍為數字0-6，默認為3（LOG_INFO）。
-s	可選參數，指定客戶端連接服務端時，服務進程的網絡監聽參數，格式為ip:port。
-p	可選參數，繞過對服務進程的查詢步驟，用于快速執行客戶端命令。
-m	可選參數，使用前臺啟動模式啟動服務進程

二、所有命令

list targets	查詢已連接的所有目標設備。
wait	等待設備正常連接。
tmode port	打開設備網絡連接通道。
tmode port close	關閉設備網絡連接通道。
tconn	指定連接設備：通過“IP地址：端口號”來指定連接的設備。
shell	在設備側執行單次命令。
install	安裝指定的應用文件。
uninstall	卸載指定的應用包。
file send	從本地發送文件至遠端設備。
file recv	從遠端設備發送文件至本地。
fport ls	列出全部轉發端口轉發任務。
fport	設置正向端口轉發任務：監聽“主機端口”，接收請求并進行轉發， 轉發到“設備端口”。
rport	設置反向端口轉發任務：監聽“設備端口”，接收請求并進行轉發，轉發到“主機端口”。
fport rm	刪除指定的端口轉發任務。
start	啟動hdc服務進程。
kill	終止hdc服務進程。
hilog	打印設備端的日志信息。
jpid	顯示設備上所有開啟了JDWP調試協議的應用的PID。
track-jpid	實時顯示設備上開啟了JDWP調試協議的應用的PID和應用名。
target boot	重啟目標設備。
keygen	生成一個新的秘鑰對。
version	打印hdc版本信息，也可使用hdc -v打印版本信息。
checkserver	獲取客戶進程與服務進程版本信息。

三、使用示例?

1.查詢已連接的所有目標設備

hdc list targets

2.發送文件到開發板

hdc file send 文件地址 發送目標地址

3.進入shell

hdc shell

4.卸載應用

hdc app uninstall 

5.查看應用列表

hdc shell bm dump -a

6.設置永不息屏

hdc shell power-shell setmode 602