1.6 调试代码
调试是开发App的必备技能,毕竟任何一个比较复杂的App都不可能一次编码成功。如果App的效果与自己期望的不同,或由于某些原因导致App异常中断,就需要查找原因,这些都需要调试代码。
调试代码有多种方法,比较常用的两种方式是设置断点和输出日志,本节将详细介绍这两种调试App的方式。
1.6.1 设置断点
如果认为需要跟踪的代码或bug在某行代码的附近,可以单击该行代码前面的部分为该行设置断点,这时在这行代码前面会出现一个红点,如图1-20所示。
然后单击上方工具栏中图1-21所示的调试运行按钮。
图1-20 设置断点
图1-21 调试运行按钮
如果未遇到断点,单击该按钮会正常运行程序,一旦遇到断点,程序运行就会在断点处停止运行。直到按F7或F8键才继续一行一行运行程序,以便监控程序中相关变量的状态。F7键表示Step Into,Step Into表示会跟踪到方法内部,例如,当前正在运行一个方法,按F7键会继续跟踪到方法内部,然后继续一行一行代码运行。F8键表示Step Over,Step Over会将方法当作一行代码运行,不会跟踪到方法内部。所以,如果认为某一个方法肯定没有问题,就按F8键,如果认为该方法可能会有一些问题,就按F7键。
调试代码的过程如图1-22所示。我们可以看到,在下方的Variables视图中会显示相关变量的当前值。
图1-22 调试代码的过程
1.6.2 输出日志
另外一种调试代码的方式是输出日志,可以直接使用System.out.println()将信息输出到Logcat视图中的方式,例如,运行下面的代码,会在Logcat视图中看到图1-23所示的信息。
System.out.println("hello world");
图1-23 在Logcat视图中输出的调试信息
HarmonyOS还提供了另外一种输出日志的方式,这就是HiLog类,该类提供了多个静态方法,用于输出不同级别的日志信息。这些静态方法及功能描述如表1-2所示。
表1-2 HiLog类中用于输出日志信息的方法
这5个方法的参数完全相同,例如,error方法的原型如下:
public static int error(HiLogLabel label, String format, Object... args);
其中,label参数表示输出日志的相关信息,类型是HiLogLabel对象;format参数表示要输出的日志文本(可以包括格式化占位符);args参数表示格式化的参数值,是可选参数。
使用输出日志方法的案例如下:
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视图中输出图1-24所示的日志信息。
图1-24 在HiLog视图中输出日志信息
使用error方法会输出深红色的日志信息,日志的内容与其他方法输出的日志内容相同。不过要注意,使用HiLog的相关方法输出的日志分为5个级别,分别是DEBUG(调试)、INFO(信息)、WARN(警告)、ERROR(错误)、FATAL(致命错误)。这5个级别分别用5个整数表示,这些整数都在HiLog类中定义,代码如下:
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大,所以这两个级别的信息不会被显示。