鸿蒙HarmonyOS实战开发:调试的命令行工具-hdc

鸿蒙Harmony驱动开发:hdc与真机调试 ​ 要想开发客户端,真机调试是必须的。要想真机调试,首先得让PC连上设备。对比Android的ADB,华为搞了个hdc(HarmonyOS Device Connector)。 ​ 阅读详情
AI摘要

本文介绍了鸿蒙HarmonyOS调试的命令行工具hdc,它可在多系统上与设备交互。文中详细说明了hdc的环境准备,包括配置环境变量;列举了全局option、查询设备列表、服务进程等相关命令;还介绍了USB、TCP、远程连接及日志获取等常见场景,以及设备无法识别、hdc无法运行等常见问题的排查方法。

 鸿蒙NEXT开发实战往期必看文章:

一分钟了解”纯血版!鸿蒙HarmonyOS Next应用开发!

“非常详细的” 鸿蒙HarmonyOS Next应用开发学习路线!(从零基础入门到精通)

HarmonyOS NEXT应用开发案例实践总结合(持续更新......)

HarmonyOS NEXT应用开发性能优化实践总结(持续更新......)


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

环境准备

hdc工具通过HarmonyOS SDK获取,存放于SDK的toolchains目录下,首次使用按照如下提示配置环境变量。

配置环境变量HDC_SERVER_PORT

Windows环境变量设置方法

在此电脑 > 属性 > 高级系统设置 > 高级 > 环境变量中,添加HDC端口变量名为:HDC_SERVER_PORT,变量值可设置为任意未被占用的端口,如7035。

环境变量配置完成后,关闭并重启DevEco Studio。

macOS环境变量设置方法

  1. 打开终端工具,执行以下命令,根据输出结果分别执行不同命令。

    echo $SHELL
    • 如输出结果为/bin/bash,则执行以下命令,打开.bash_profile文件。

      
      vi ~/.bash_profile
    • 如输出结果为/bin/zsh,则执行以下命令,打开.zshrc文件。

      vi ~/.zshrc
  2. 单击字母“i”,进入Insert模式。

  3. 输入以下内容,在PATH路径下添加HDC_SERVER_PORT端口信息。

    HDC_SERVER_PORT=7035
    launchctl setenv HDC_SERVER_PORT $HDC_SERVER_PORT
    export HDC_SERVER_PORT
  4. 编辑完成后,单击Esc键,退出编辑模式,然后输入“:wq”,单击Enter键保存。

  5. 执行以下命令,使配置的环境变量生效。

    • 如果步骤1时打开的是.bash_profile文件,请执行如下命令:

      source ~/.bash_profile
    • 如果步骤1时打开的是.zshrc文件,请执行如下命令:

      source ~/.zshrc
  6. 环境变量配置完成后,关闭并重启DevEco Studio。

(可选)配置全局环境变量

说明

如未配置全局环境变量,开发者可通过命令行进入SDK的toolchains目录,在目录中执行hdc相关命令进行调试。

Windows环境变量设置方法

在此电脑 > 属性 > 高级系统设置 > 高级 > 环境变量 > 系统变量中,将SDK的toolchains完整路径添加到Path变量值中,具体路径信息以SDK实际配置路径为准。

以下图示内容以本地SDK的toolchains完整路径$DevEco Studio安装目录/sdk/default/openharmony/toolchains为例:

Linux/macOS环境变量设置方法

  1. 打开终端工具,执行以下命令,根据输出结果分别执行不同命令。

    echo $SHELL
    • 如输出结果为/bin/bash,则执行以下命令,打开.bash_profile文件。

      vi ~/.bash_profile
    • 如输出结果为/bin/zsh,则执行以下命令,打开.zshrc文件。

      vi ~/.zshrc
  2. 单击字母“i”,进入Insert模式。

  3. 输入以下内容,在PATH路径下增加SDK路径信息,具体路径信息以SDK实际配置路径为准。

    以下内容以本地SDK的toolchains完整路径$DevEco Studio安装目录/sdk/default/openharmony/toolchains为例:

    HDC_SDK_PATH=/User/username/sdk/HarmonyOS/10/toolchains
    launchctl setenv HDC_SDK_PATH $HDC_SDK_PATH # 仅MacOS需要在此执行,Linux无须执行
    export PATH=$PATH:$HDC_SDK_PATH
  4. 编辑完成后,单击Esc键,退出编辑模式,然后输入“:wq”,单击Enter键保存。

  5. 执行以下命令,使配置的环境变量生效。

    • 如果步骤1时打开的是.bash_profile文件,请执行如下命令:

      source ~/.bash_profile
    • 如果步骤1时打开的是.zshrc文件,请执行如下命令:

      source ~/.zshrc

全局option相关命令

Option 说明
-h/help 打印hdc帮助信息
-v/version 打印hdc版本信息
-t [connect-key] [command] 连接指定的目标设备,connect-key可通过hdc list targets查询
-l [level] 指定运行时日志等级,默认为LOG_INFO
wait 等待设备正常连接,用于检测设备是否连接并准备好接收指令
checkserver 获取client-server版本
  1. 显示hdc相关的帮助信息,命令格式如下:

    hdc -h/help

    返回值:

    返回值 说明

    HarmonyOS device connector(HDC) ...

    ---------------------------------global commands:----------------------------------

    -h/help [verbose] - Print hdc help, 'verbose' for more other cmds

    ...(此处省略详细帮助信息)

    hdc命令使用帮助信息

    使用方法:

    hdc -h 或 hdc help
  2. 显示hdc的版本信息,命令格式如下:

    hdc -v/version

    返回值:

    返回值 说明
    Ver: X.X.Xa hdc(SDK)的版本信息

    使用方法:

    hdc -v 或 hdc version
  3. 连接单台设备时,执行命令无需指定设备标识符;连接了多台设备时,每次执行命令时需要指定目标设备的标识符,命令格式如下:

    hdc -t [connect-key] [command]

    参数:

    参数名 说明
    connect-key 设备标识符
    command hdc支持的命令

说明

connect-key为每个设备唯一的标识符。如果通过usb连接,标识符为序列号;如果通过网络连接设备,标识符为“IP地址:端口号”;

返回值:

返回值 说明
命令执行返回内容 请参考对应命令的返回值
[Fail]Not match target founded, check connect-key please 没有找到与connect-key匹配的设备
[Fail]Device not founded or connected 设备未找到或尚未连接
[Fail]ExecuteCommand need connect-key? please confirm a device by help info 多设备连接时需要指定一个设备
Unknown operation command... 不支持的命令

使用方法:

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

hdc list targets // 查询已连接的所有目标设备的connect-key
hd
鸿蒙HarmonyOS开发知识:命令行工具Command Line Tools 将解压后command-line-tools文件夹的bin目录配置到环境变量中。 阅读详情

相关推荐

Harmon实战开发:调测工具-hdc使用指导

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

qazwsx957486的博客 2619

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

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

m0_64420071的博客 1万+

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

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

大雨淅淅的博客 2670

鸿蒙南向开发实战:hdc命令行工具高效调试技巧全解析

本文全面解析鸿蒙南向开发中hdc命令行工具的高效调试技巧,涵盖设备连接、环境配置、核心命令使用及实战案例。通过HDC工具(HarmonyOS Device Connector),开发者可实现实时日志查看、文件传输、应用安装等操作,大幅提升鸿蒙设备开发效率。特别适合OpenHarmony开发者掌握调试工具的高级用法。

weixin_28309571的博客 315

鸿蒙开发必备:hdc命令行工具从安装到实战调试全指南(附常见问题排查)

本文是鸿蒙开发中hdc命令行工具的完整实战指南。详细介绍了从环境配置、核心命令精解到高效调试工作流的全流程,并重点提供了设备连接失败、命令执行报错等常见问题的系统性排查方案,帮助开发者掌握这一核心调试工具,提升开发效率。

weixin_42576186的博客 210

鸿蒙HarmonyOS实战开发:调试工具-Ability assistant

Ability assistant(Ability助手,简称为aa),是用于启动应用和启动测试用例的工具,为开发者提供基本的应用调试和测试能力,例如启动应用组件、强制停止进程、打印应用组件相关信息等。

m0_67143533的博客 2175

鸿蒙系统Root用户权限关闭

虽然鸿蒙系统对外宣传天然无Root,但只要是代码开发者,在使用hdc时,‘#’出现在你的面前,当然对于 1. 开发调试者是一种窃喜,想怎么往里推文件,修改参数。但从最终用户来看,这是安全隐患。如何关闭root,切 换到shell用户呢,解决中… 解决思路: 1.参考Android init启动流程,参考对应的adb守护进程,发现在其中在启动流程中,切换了root 到shell。 static void drop_privileges(int server_port) { if (should_drop.

求变,从思想开始 1万+

llama factory

NOTE] 除上述链接以外的其他网站均为未经许可的第三方网站,请小心甄别。

thesky123456的博客 1277

Audio2Face进阶玩法:结合LiveLink在UE5中实现MetaHuman全身动画+语音驱动(保姆级配置指南)

本文提供了一份详尽的保姆级教程,指导如何将NVIDIA Audio2Face与Unreal Engine 5的LiveLink功能结合,实现驱动MetaHuman数字人面部表情的同时,无缝融合身体动画。文章详细讲解了从环境准备、插件部署、基础面部驱动测试,到动画蓝图高级配置与多数据流融合的全流程,并分享了性能优化与问题排查的实战经验,旨在帮助创作者打造表情与肢体动作协调统一的生动数字人。

q9w8e7r6t5的博客 200

学习笔记9--智能驾驶的功能安全设计之功能安全设计

本系列博客包括6个专栏,分别为:《自动驾驶技术概览》、《自动驾驶汽车平台技术基础》、《自动驾驶汽车定位技术》、《自动驾驶汽车环境感知》、《自动驾驶汽车决策与控制》、《自动驾驶系统设计及应用》。此专栏是关于《自动驾驶系统设计及应用》书籍的笔记.

FUXI_Willard 1802

文献计量VOSviewer分析知网文献基本操作及实用技巧

本教程旨在为读者提供一个关于VOS viewer的初级使用指南。VOS viewer是一个强大的科学研究可视化工具,主要用于构建和可视化科学地图。它能够处理大规模的科研数据,包括文献引用、共引、共词、共作者等信息。无论你是科研人员,还是数据分析师,甚至是研究生,都能在这个教程中找到使用VOS viewer的有效方法。我们将一步步教你如何使用这个软件,以及如何利用它进行科研数据的可视化。

Jia_n的博客 8777

基于YOLOv8和时序模型的异常动作检测系统

异常动作检测是计算机视觉领域的重要应用,广泛应用于智能监控、安防系统、老人看护等场景。本项目结合YOLOv8目标检测和LSTM时序模型,实现对打架、摔倒、奔跑等异常动作的实时检测,并提供了完整的Web界面。多技术融合: 结合YOLOv8目标检测和LSTM时序建模实时检测: 支持实时视频流处理和文件分析用户友好: 提供完整的Web界面可扩展性: 模块化设计便于功能扩展高性能: 包含多种优化策略。

YOLO 766

YOLOv11在RK3588芯片上的NPU加速与INT8量化部署全面指南

RK3588 NPU适配YOLOv11的关键技术要点 摘要:本文详细分析了Rockchip RK3588 NPU的硬件架构特性及其对YOLOv11模型的适配优化方案。RK3588 NPU采用三核设计,具备6TOPS算力,包含192个MAC单元和128KB专用SRAM。YOLOv11作为最新目标检测模型,其CSPNet-v5骨干网络、PANet特征金字塔和SiLU激活函数需要特殊适配处理。文章系统介绍了从PyTorch模型导出、ONNX优化到RKNN模型转换的完整流程,重点阐述了NPU不支持的算子处理方案和量

本博客聚焦 YOLOv11 全流程落地,涵盖架构优化、数据集处理、训练技巧与多场景部署,兼及国产数据库、Java 开发与 AI 模型应用,内容兼顾理论与工程实践,为开发者提供系统干货,助力高效提升技术能力。 1368

【OS】AUTOSAR OS Alarm实现原理

AUTOSAR OS Alarm实现原理

qq_36056498的博客 1027

时间序列、时间序列分析、时间序列效应分解、平稳时间序列、AIC和BIC

时间序列、时间序列分析、时间序列效应分解、平稳时间序列、AIC和BIC 目录 时间序列、时间序列分析、时间序列效应分解、平稳时间序列、AIC和BIC 时间序列 时间序列分析 时间序列效应分解 平稳时间序列 AIC和BIC 时间序列 时间序列数据是某个个体在多个时间点上收集的数据。分析时间序列的方法构成了数据分析的一个重要领域,即时间序列分析。时间序列根据所研究的依据不同,可产生不同的分类。按照研究对象可以分为一元时间序列和多元时间序列;按照时间属性可以分为离散时间序列和连续时间序列;按照序

data+scenario+science+insight 1240

VB摄像头监控

该VB模块可对摄像头捕获的画面进行录像等,可在创建的窗口进行控制

计算机控制技术及应用

《计算机控制技术及应用》通过总结作者的科研成果和吸收国内外的先进理论、方法和技术,以计算机控制系统的网络化、开放化、智能化和集成化发展趋势为主线索,主要介绍计算机控制系统的基本概念和计算机控制系统的典型形式,计算机控制系统的数学描述与基本分析方法,以及数字PID控制器、最少拍控制系统、达林算法、状态变量设计法等设计方法及其各种改进算法。重点突出计算机控制系统输入输出通道接口的设计方法和典型控制系统的设计案例与实现方法等。

假人有限元模型

假人模型,车辆碰撞假人有限元模型,适合做乘员安全的研究者利用

上一篇: 鸿蒙HarmonyOS实战开发:电源状态转换工具-power-shell
下一篇: 鸿蒙HarmonyOS实战开发:hilog命令行查询
酷酷的星~
博客等级 码龄5年 2539粉丝 272原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值
⌂ 换网址