【鸿蒙开发】第三十二章 DevEco Studio - 日志HiLog分析汇总

鸿蒙程序媛

已于 2025-02-18 15:37:40 修改

阅读量1.4k

点赞数 18

分类专栏：鸿蒙理论知识学习文章标签： harmonyos

于 2025-02-14 23:06:31 首次发布

本文链接：https://blog.youkuaiyun.com/wsy18201533604/article/details/145607321

版权

鸿蒙理论知识学习专栏收录该内容

69 篇文章

订阅专栏

1 HiLog界面

DevEco Studio提供了“Log > HiLog”窗口查看设备当前所有应用实时打印的日志信息。

HiLog默认显示的日志为以下6个部分：

第一列	第二列	第三列	第四列	第五列	第六列
Timestamp	PID-TID	Domain/Processname/Tag	PackageName	LogLevel	Message
时间戳	进程ID和线程ID	日志标签	应用包名	日志级别	日志内容

通过设置包名、日志级别和搜索关键词来筛选日志信息，还可以使用自定义日志显示格式、日志导出、显示最新日志等功能。

HiLog窗口左侧各个按钮的作用为：

：单击该按钮可以向上翻页，日志窗口取消自动滚动。
：单击该按钮可以向下翻页，日志窗口取消自动滚动。如果翻页已到底部，日志窗口自动滚动。
：当该按钮处于选中状态时，日志自动换行显示，否则日志按行显示。
：当该按钮处于选中状态时，日志自动滚动到窗口底部，否则停留在当前日志显示处。
：单击该按钮可以重新开启日志接收，会重新加载设备缓存日志。
：单击该按钮可以选择清空窗口日志或清空设备缓存。
: 单击该按钮可以对当前选择的设备屏幕进行截屏，并保存在本地。
: 单击该按钮可以对当前选择的设备进行录屏，并保存在本地。
：单击该按钮可以保存日志缓存到指定文件（在线日志）或保存离线日志文件（离线日志）。
：单击该按钮可以自动选择和切换已连接的设备。
：单击该按钮可以切换日志视图以及自定义日志格式。
：单击该按钮可以关闭当前日志窗口。
：单击该按钮可以跳转到HiLog日志相关的在线帮助文档。

2 过滤日志

按关键字过滤日志

在HiLog搜索框中输入希望过滤的信息，即可过滤显示所有包含此信息的日志。

按钮表示过滤是否区分大小写，按钮表示是否按照正则表达式匹配过滤。

使用默认提供的过滤配置

HiLog提供多种默认的过滤模式，开发者不需要反复输入关键字过滤日志信息，只需要切换相应的过滤项，即可快速过滤所需的日志。

All logs of selected app：按照应用进程过滤日志。
User logs of selected app：按照应用进程过滤用户输出的日志。

当选择All logs of selected app或User logs of selected app时，进程过滤下拉框处于可选状态，可选择相应的选项过滤想查看的进程日志。

说明

由于设备启动时，USB调试开关没有开启，部分系统应用没注册上，Hilog进程列表无法显示未注册上的系统应用，如需查看此部分的日志，可以按关键字过滤查看，或者保持USB调试开关打开的状态，重启设备。

进程选择窗口可输入PID或应用名的关键字搜索要过滤的进程。

按日志级别过滤日志

HiLog提供日志级别过滤以过滤某一级别及以上的日志。日志级别分为Debug、Info、Warn、Error、Fatal五个级别。

如选择Warn级别，则过滤展示Warn级别与Warn级别以上的日志信息，即展示Warn、Error、Fatal3个级别。

按自定义过滤项过滤日志

除默认过滤项外，Hilog还提供配置自定义过滤项的途径以供开发者按照实际需求过滤日志，并保存此过滤配置以供重复使用。

点击Config custom filter时将弹出自定义过滤配置窗口。

先前介绍的过滤选项此处均可配置，同时增加了Package name和Set to all projects配置项。

Set to all projects：此配置当前工程及其他所有工程均可用。
Package name：按应用包名过滤日志。

当配置完后将自动切换至此过滤配置。

切换至此自定义配置时，日志级别过滤窗口和关键字过滤窗口将在此自定义配置过滤出的日志的基础上再进行过滤。

3 自定义日志显示格式

开发者可以通过配置自定义格式，限制每条日志只显示用户关注的信息。

点击左侧图标，将弹出自定义格式窗口。

Standard Views：默认显示所有信息。
Compact Views：默认显示日志级别与日志信息。
Modify Views：进入“Hilog Format”窗口后，可以按照需要自定义日志格式。

在“Hilog Format”中自定义日志格式：

Use as default view for new windows：新建的HiLog窗口以Standard模式显示还是以Compact模式显示，新建后开发者可再自行切换其显示模式。
Show timestamp：是否显示日期时间。
Format：Datetime/Time 显示日期时间/只显示时间。

Show process id：是否显示PID-TID 。
Include thread id：是否显示TID。

Show domain/processname/tags：是否显示domain/processname/tags 。
Tag column width：domain/processname/tags列的最大宽度，超长信息将会缩略显示并以ToolTip形式显示完整信息。

Show package names：是否显示应用包名。
Package column width：包名列的最大宽度，超长信息将会缩略显示并以ToolTip形式显示完整信息。

4 超长日志自动换行

当日志的消息过长时，日志窗口可能不能完整显示日志消息，需要拖动滚动条查看信息。此时开发者可以点击Soft-Warp按钮控制日志消息自动换行。

图1 未开启自动换行

图2 开启自动换行

5 显示最新日志

设备输出的日志信息会实时刷新到HiLog窗口底部，用户可点击Scroll to End按钮使Hilog一直显示底部的最新日志信息。当观察到需要的日志时，点击HiLog窗口，即可停止滚动，停留在当前行，以便查看日志信息。

6 导出日志信息

用户可将经上述步骤过滤后的关键日志信息保存到本地，以便后续的进一步分析。

点击Export HiLog按钮，在弹出的Export HiLog To窗口中选择保存路径。

7 清除日志缓存

与日志相关的缓存有两个：设备端日志缓存、HiLog窗口缓存。

HiLog显示日志信息的流程为：

应用输出日志信息至设备端日志缓存；
Log组件将设备端日志缓存取出，保存在HiLog窗口缓存中；
HiLog窗口根据过滤条件，将HiLog窗口缓存中的消息显示窗口在界面中。

点击Clear按钮，将弹出两个选项Clear Console Log、Clear Device Log。

Clear Console Log：清除HiLog窗口缓存。
此操作只清空HiLog窗口缓存，Log组件将重新从设备端日志缓存读取日志消息，因而执行清除操作前已保存在设备端日志缓存的日志消息会显示到HiLog窗口中。
Clear Device Log：清除设备侧日志缓存。
此操作将清除设备端日志缓存和HiLog窗口缓存。HiLog窗口将显示执行清除操作后，新输出至设备端缓存的日志信息。