1.6　调试代码

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

调试代码有多种方法，比较常用的两种方式是设置断点和输出日志，本节将详细介绍这两种调试App的方式。

1.6.1　设置断点

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

然后单击上方工具栏中图1—21所示的调试运行按钮。

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

调试代码的过程如图1—22所示。我们可以看到，在下方的Variables视图中会显示相关变量的当前值。

1.6.2　输出日志

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

System.out.println("hello world");

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

这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所示的日志信息。

使用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大，所以这两个级别的信息不会被显示。 cCqSEjGm4CP+/p015YSeF9867jdkyYbQnnFUAybmFpNOv4w7vjvGjPrmy/XxeqwC