调试鸿蒙(HarmonyOS)App源代码的两种方式

2020-11-11 11:09:29 浏览数 (1)

调试是开发App的必备技能,毕竟任何一个比较复杂的App都不可能一次编码成功,如果App的预期与自己期望的不同,或由于某些原因异常中断,就需要查中断的原因,这些都需要调试程序。

调试程序有多种方法,比较常用的有设置断点和输出日志两种方式,本文将详细介绍这两种调试App的方式。

1. 设置断点

如果认为需要跟踪的代码或bug在某行代码的附近,可以单击该行代码前面的部分为该行设置断点,这时会在这行代码前面出现一个红点,如图1所示。

图1 设置断点

然后点击上方工具栏中如图2所示的调试运行按钮。

图2 调试运行按钮

如果未遇到断点,点击该按钮会正常运行程序,一旦遇到断点,程序执行就会在断点处停止执行。知道按F7或F8键才继续一行一行执行程序,以便监控程序中的相关变量的状态。F7表示Step Into,F8表示Step Over。其中Step Into表示会跟踪到方法内部,例如,当前正在执行一个方法,按F7键会继续跟踪到方法内部,然后继续一行一行代码执行。Step Over会将方法当做一行代码执行,不会跟踪到方法内部。所以如果认为某一个方法肯定没有问题,就按F8,如果认为该方法可能会有一些问题,就按F7。

调试过程的效果如图3所示。我们可以看到,在下方的Variables视图中会显示相关变量的当前值。

图3 调试代码

2. 输出日志

另外一种调试代码的方式就是输出日志,可以直接使用System.out.println(...)的方式将信息输出到LogCat视图中,例如,执行下面的代码,会在LogCat视图中看到如图4所示的信息。

代码语言:javascript复制
System.out.println("hello world"); 

图4在LogCat视图中输出的调试信息

HarmonyOS还提供了另外一种输出日志的方式,这就是HiLog类,该类提供了多个静态方法,用于输出不同级别的日志信息。这些静态方法如表1所示。

表1 HiLog类中用于输出日志信息的方法

方法名

功能

debug

用于输出调试日志信息

info

用于输出普通的日志信息

warn

用于输出警告日志信息

error

用于输出普通错误日志信息

fatal

用于输出致命错误日志信息

这5个方法的参数完全相同,例如,error方法的原型如下:

代码语言:javascript复制
public static int error(HiLogLabel label, String format, Object... args);

其中label参数表示输出日志的相关信息,类型是HiLogLabel对象,format表示要输出的日志文本(可以包括格式化占位符),args参数表示格式化的参数值,是可选的参数。

使用输出日志方法的案例如下:

代码语言:javascript复制
HiLogLabel label = new HiLogLabel(HiLog.LOG_APP ,223, "MY_TAG");
HiLog.error(label, "这是一行错误信息,原因:%{private}s","Url不可访问");
HiLog.warn(label,"这是一个警告,原因是:%{public}s", "变量的值可能是负数"); 

其中HiLogLabel构造方法的第1个参数表示日志类型,目前只能是HiLog.LOG_APP,后续会开放更多的日志类型。第2个参数是domain,就是一个整数类型,第3个参数是日志的标签。Domain和日志标签都会以某种形式显示在日志信息上。

在输出日志信息时,运行格式化日志信息,也就是为日志信息指定占位符。占位符需要在%和符号(如s、d)之间加{private}或{public},如果加{private},输出的信息就是<private>,也就是说会隐藏占位符对应的信息,如果加{public},则输出原始的占位符信息。Domain在输出时被转换为十六进制数放到标签的前面,中间用斜杠(/)分隔。

执行这段代码,会在HiLog视图中输出如图5所示的日志信息。

图5 在HiLog视图输出日志信息

使用error方法会输出深红色的日志信息,日志的内容与其他方法输出的日志内容相同。不过要注意,使用HiLog的相关方法输出的日志分为5个级别,分别是DEBUG(调试)、INFO(信息)、WARN(警告)、ERROR(错误)、FATAL(致命错误)。这5个级别分别用5个整数表示,这些整数都在HiLog类中定义,代码如下:

代码语言:javascript复制
public final class HiLog {
    public static final int DEBUG = 3;
    public static final int INFO = 4;
    public static final int WARN = 5;
    public static final int ERROR = 6;
    public static final int FATAL = 7;
    … …
} 

如果要在HiLog视图中过滤这些级别的信息。只有不大于当前级别的信息才会给显示。例如,要过滤WARN信息,只有DEBUG、INFO和WARN这3类信息才会被显示,由于ERROR和FATAL的值逗比WARN大,所以这两类信息不会被显示。

- EOF -

0 人点赞