HDC 和 HiLog 命令详细介绍
以下是 HDC（HarmonyOS Device Connector） 和 HiLog（鸿蒙日志系统） 的详细介绍，分别列出它们的命令和功能。
1. HDC（HarmonyOS Device Connector）
HDC 是鸿蒙系统的设备调试工具，类似于 Android 的 ADB。它提供了丰富的命令行工具，用于设备连接、调试、日志查看和性能监控等。
1.1 设备管理
| 命令 | 功能描述 |
|---|---|
hdc list targets | 列出当前连接的设备。 |
hdc target mount | 挂载设备的文件系统。 |
hdc target bootloader | 重启设备进入 Bootloader 模式。 |
hdc target recovery | 重启设备进入 Recovery 模式。 |
hdc reboot | 重启设备。 |
hdc reboot bootloader | 重启设备并进入 Bootloader 模式。 |
hdc reboot recovery | 重启设备并进入 Recovery 模式。 |
1.2 文件操作
| 命令 | 功能描述 |
|---|---|
hdc file send <本地路径> <设备路径> | 将文件从本地推送到设备。 |
hdc file recv <设备路径> <本地路径> | 将文件从设备拉取到本地。 |
hdc file list <设备路径> | 列出设备指定目录下的文件。 |
hdc file delete <设备路径> | 删除设备上的文件。 |
1.3 应用管理
| 命令 | 功能描述 |
|---|---|
hdc install <应用路径> | 安装应用程序到设备。 |
hdc uninstall <包名> | 卸载设备上的应用程序。 |
hdc shell bm list | 列出设备上已安装的应用程序。 |
hdc shell am start <包名/Activity> | 启动指定的应用程序或 Activity。 |
hdc shell am force-stop <包名> | 强制停止指定的应用程序。 |
1.4 日志查看
| 命令 | 功能描述 |
|---|---|
hdc log | 查看设备的实时日志。 |
hdc log -c | 清除设备的日志缓存。 |
hdc log -f <关键字> | 过滤日志，只显示包含指定关键字的日志。 |
1.5 调试与性能
| 命令 | 功能描述 |
|---|---|
hdc shell | 进入设备的命令行终端。 |
hdc shell top | 查看设备的实时资源使用情况（CPU、内存等）。 |
hdc shell ps | 列出设备上正在运行的进程。 |
hdc shell dumpsys <服务名> | 查看指定系统服务的状态信息。 |
hdc shell perfetto | 启动性能跟踪工具，生成性能报告。 |
1.6 其他命令
| 命令 | 功能描述 |
|---|---|
hdc version | 查看 HDC 的版本信息。 |
hdc help | 查看 HDC 的帮助信息。 |
2. HiLog（鸿蒙日志系统）
HiLog 是鸿蒙系统的日志系统，开发者可以通过 HiLog API 打印日志，并通过命令行工具查看日志。
2.1 日志级别
HiLog 支持以下日志级别：
- DEBUG: 调试信息，用于开发阶段。
- INFO: 普通信息，用于记录程序运行状态。
- WARN: 警告信息，表示潜在问题。
- ERROR: 错误信息，表示程序错误。
- FATAL: 严重错误信息，表示程序无法继续运行。
2.2 常用命令
查看日志
| 命令 | 功能描述 |
|---|---|
hilog | 查看实时日志。 |
hilog -r | 查看实时日志（与 hilog 相同）。 |
hilog -g | 查看历史日志。 |
hilog -x | 清除日志缓存。 |
hilog -f <关键字> | 过滤日志，只显示包含指定关键字的日志。 |
hilog -l <级别> | 按日志级别过滤日志（如 -l D 表示只显示 DEBUG 日志）。 |
hilog -t <标签> | 按日志标签过滤日志。 |
hilog -s <开始时间> | 查看指定时间之后的日志（时间格式：YYYY-MM-DD HH:MM:SS）。 |
hilog -e <结束时间> | 查看指定时间之前的日志（时间格式：YYYY-MM-DD HH:MM:SS）。 |
日志标签
在代码中使用 HiLog API 打印日志时，可以指定日志标签（Tag）。例如：
#include "hilog/log.h"
static constexpr OHOS::HiviewDFX::HiLogLabel LABEL = {LOG_CORE, 0, "MY_TAG"};
OHOS::HiviewDFX::HiLog::Debug(LABEL, "This is a debug log.");
在命令行中可以通过 -t MY_TAG 过滤指定标签的日志。
日志格式
HiLog 的日志格式如下：
<时间> <PID> <TID> <日志级别> <标签> <日志内容>
例如：
2023-10-01 12:34:56.789 1234 5678 D MY_TAG This is a debug log.
总结
HDC 命令
- 设备管理：
list targets、reboot、target mount等。 - 文件操作：
file send、file recv、file list等。 - 应用管理：
install、uninstall、bm list等。 - 日志查看：
log、log -c、log -f等。 - 调试与性能：
shell、top、ps、perfetto等。
HiLog 命令
- 查看日志：
hilog、hilog -r、hilog -g等。 - 过滤日志：
hilog -f、hilog -l、hilog -t等。 - 日志格式：
<时间> <PID> <TID> <日志级别> <标签> <日志内容>。
通过 HDC 和 HiLog 工具，开发者可以方便地调试鸿蒙应用程序，查看日志并分析性能问题。