HDC(HarmonyOS Device Connector)是為開發人員提供的用于調試的命令行工具,通過該工具可以在windows/linux/mac系統上與真實設備進行交互。
?使用HDC前,需要配置相關環境變量:
????????在此電腦 > 屬性 > 高級系統設置 > 高級 > 環境變量中,添加HDC端口變量名為:HDC_SERVER_PORT,變量值可設置為任意未被占用的端口。?環境變量配置完成后,關閉并重啟DevEco Studio。
????????
????????在此電腦 > 屬性 > 高級系統設置 > 高級 > 環境變量 > 系統變量中,將SDK的toolchains完整路徑添加到Path變量值中,具體路徑信息以SDK實際配置路徑為準。
????????
?常見命令:
Option | 說明 |
---|---|
-t [key] [command] | 指定連接唯一標識的目標設備,標識可通過命令hdc list targets查詢 |
help/-h | 打印hdc幫助信息 |
version/-v | 打印hdc版本信息 |
-l [level] | 指定運行時日志等級,默認為LOG_INFO |
checkserver | 獲取client-server版本 |
target mount | 讀寫模式掛載系統分區(user不可用) |
target boot | 重啟目標設備,查看目標列表可用list targets命令 |
smode [-r] | 授予設備端hdc后臺服務進程root權限, 使用-r參數取消授權(user不可用) |
kill [-r] | 終止hdc服務進程,使用-r參數觸發服務進程重新啟動 |
start [-r] | 啟動hdc服務進程,使用-r參數觸發服務進程重新啟動 |
fport ls | 列出全部轉發端口轉發任務 |
fport localnode remotenode | 設置正向端口轉發任務:監聽“主機端口”,接收請求并進行轉發, 轉發到“設備端口” |
fport rm localnode remotenode | 刪除正向端口轉發任務:取消指定的“主機端口”轉發 |
rport remotenode localnode | 設置反向端口轉發任務:監聽“設備端口”,接收請求并進行轉發,轉發到“主機端口” |
rport rm remotenode localnode | 刪除反向端口轉發任務:取消指定的“設備端口”轉發 |
tmode usb | 已連接設備切換為USB連接方式:設備端daemon進程重啟,并首先選用USB連接方式 |
tmode port [port-number] | 已連接設備切換為網絡連接方式:設備端daemon進程重啟,并優先使用網絡方式連接設備,如果連接設備失敗,再選擇USB連接 |
tconn [IP]:[port] [-remove] | 指定連接設備:通過“IP地址:端口號”來指定連接的設備,使用-remove參數斷開連接 |
file send local remote | 從本地發送文件至遠端設備 |
file recv remote local | 從遠端設備發送文件至本地 |
install src | 安裝指定的應用文件(.hap .hsp) |
uninstall packageName | 卸載指定的應用包package包名 |
jpid | 顯示可調試應用列表 |
hilog [options] | 打印設備端的日志信息,options表示hilog支持的參數,可通過hdc hilog -h查閱支持的參數列表 |
shell [command] | 交互命令,command表示需要執行的單次命令,不同類型或版本的系統支持的command命令有所差異,可以通過hdc shell ls /system/bin查閱支持的命令列表 |
?
參考文檔:HDC常見命令?