flutter 专题 八十五 Flutter 应用调试

程序调试是程序投入运行之前,使用手工或编译程序等方法进行的测试,z主要用以修正语法错误和逻辑错误。程序调试是保证计算机信息系统正确性的必不可少的步骤。

在Flutter应用开发中,Android Studio和VSCode是两种比较常见的集成开发环境,因此项目调试也围绕这两款IDE进行。Android Studio为Flutter提供完整的集成IDE体验,因此Android的调试技巧对于Flutter来说也是适用的。在 Flutter 中,调试代码主要分为输出日志、断点调试和布局调试 3 类,因此Flutter的调试也将围绕这 3 个主题。

Android Studio

输出日志

为了便于跟踪和记录应用的运行情况,我们在开发时通常会在一些关键步骤输出日志(Log),在Flutter中我们使用 print 函数在控制台打印出相关的上下文信息。通过这些信息,就可以定位代码中可能出现的问题。不过,由于涉及 I/O 操作,使用 print 来打印信息会消耗较多的系统资源。同时,这些输出数据很可能会暴露 App 的执行细节,所以我们在发布正式版时还需要屏蔽掉这些输出。

不过最工程化的做法是读取项目配置文件,根据运行环境来开启日志调试功能。为了根据不同的运行环境来开启日志调试功能,我们可以使用 Flutter 提供的debugPrint 来代替 print。debugPrint 函数同样会将消息打印至控制台,但与 print 不同的是,它提供了定制打印的能力。也就是说,我们可以向 debugPrint 函数,赋值一个函数声明来自定义打印行为。

比如在下面的代码中,我们将 debugPrint 函数定义为一个空函数体,这样就可以实现一键取消打印的功能了。

复制代码
debugPrint = (String message, {int wrapWidth}) {};//空实现

在 Flutter 中,我们可以使用不同的 main 文件来表示不同环境下的入口。同样,在Flutter开发中,可以通过 main.dart 与 main-dev.dart,去分别定义生产环境与开发环境不同的打印日志行为。

在下面的例子中,我们将生产环境的 debugPrint 定义为空实现,将开发环境的 debugPrint 定义为同步打印数据,如下所示。

复制代码
//main.dart
void main() {
  // 将debugPrint指定为空的执行体, 所以它什么也不做
  debugPrint = (String message, {int wrapWidth}) {};
  runApp(MyApp()); 
}

//main-dev.dart
void main() async {
  // 将debugPrint指定为同步打印数据
  debugPrint = (String message, {int wrapWidth}) => debugPrintSynchronously(message, wrapWidth: wrapWidth);
  runApp(MyApp());
}

可以看到,在代码实现上,我们只要将应用内所有的 print 都替换成 debugPrint,就可以满足开发环境下打日志的需求,也可以保证生产环境下应用的执行信息不会被意外打印。

断点调试

输出日志固然方便,但如果要想获取更为详细,或是粒度更细的上下文信息,静态调试的方式非常不方便。这时,我们需要更为灵活的动态调试方法,即断点调试。断点调试可以让代码在目标语句上暂停,让程序逐条执行后续的代码语句,来帮助我们实时关注代码执行上下文中所有变量值的详细变化过程。

Android Studio 提供了断点调试的功能,调试 Flutter 应用与调试原生 Android 代码的方法完全一样,具体可以分为三步,即标记断点、调试应用、查看信息。

下面以 Flutter 默认的计数器应用模板为例,观察代码中 _counter 值的变化,体会断点调试的全过程。

首先是标记断点。既然我们要观察 _counter 值的变化,因此在界面上展示最新的 _counter 值时添加断点,去观察其数值变化是最理想的。因此,我们在行号右侧点击鼠标,可以把断点加载到初始化 Text 控件所示的位置。

在下图的例子中,我们为了观察 _counter 在等于 20 的时候是否正常,还特意设置了一个条件断点 _counter==20,这样调试器就只会在第 20 次点击计数器按钮时暂停下来。

添加断点后,对应的行号将会出现圆形的断点标记,并高亮显示整行代码。到此,断点就添加好了。当然,我们还可以同时添加多个断点,以便更好地观察代码的执行过程。

接下来则是调试应用了。和之前通过点击Run 按钮的运行方式不同,这一次我们需要点击工具栏上的虫子图标,以调试模式启动 App,如下图所示。

等调试器初始化好后,我们的程序就启动了。由于设置了断点,所以当代码运行到了断点位置,自动进入了 Debug 视图模式,如下图所示。

按照功能的不同,可以把 Debug 视图模式划分为 4 个区域,即 A 区控制调试工具、B 区步进调试工具、C 区帧调试窗口、D 区变量查看窗口。

控制调试工具区域主要用来控制调试的执行情况,如下图所示。

我们可以点击继续执行按钮来让程序继续运行、点击终止执行按钮来让程序终止运行、点击重新执行按钮来让程序重新启动,或是在程序正常执行时,点击暂停执行按钮按钮来让程序暂停运行。当然,我们可以点击编辑断点按钮来编辑断点信息,或是点击禁用断点按钮来取消断点。

步进调试工具区域主要用来控制断点的步进情况,如下图所示。

可以点击单步跳过按钮来让程序单步执行(但不会进入方法体内部)、点击单步进入或强制单步进入按钮让程序逐条语句执行,甚至还可以点击运行到光标处按钮让程序执行到在光标处。认为断点所在的方法体已经无需执行时,则可以点击单步跳出按钮让程序立刻执行完当前进入的方法,从而返回方法调用处的下一行。担任,还可以点击表达式计算按钮来通过赋值或表达式方式修改任意变量的值。

C 区用来指示当前断点所包含的函数执行堆栈,D 区则是其堆栈中的函数帧所对应的变量。

布局调试

除了输出日志、断点调试,布局分析也是开发中不可缺少的代码优化手段。借助Flutter提供的Flutter Inspector 可视化工具,可以帮助我们诊断布局问题。打开Android Studio,然后点击工具栏上的"Open DevTools"按钮即可启动 Flutter Inspector,如下图所示。

随后,Android Studio 会打开浏览器,将Flutter应用程序的的 Widget 树结构展示在面板中。可以看到,Flutter Inspector 所展示的 Widget 树结构,与代码中实现的 Widget 层次是一一对应的。

除了进行布局调试外,还可以使用Flutter Inspector进行布局调优。

VSCode

除了Android Studio外,VSCode也是一款比较常见的Flutter应用程序开发工具。使用VSCode提供的图形化调试界面,开发者可以很方便的进行Flutter应用的调试工作。使用VSCode打开Flutter项目,然后点击VSCode的断点调试按钮即可开启调试,如下图所示。

需要说明的是,第一次使用VSCode进行断点调试时,需要先安装并激活Dart DevTools调试工具。如果不确定是否绑定过DevTools工具,可以使用快捷键【command+shift+p】打开VSCode工具栏,然后输入Open DevTools打开调试窗口。

然后,在需要调试的代码处设置断点,点击左上方的开启调试按钮开启调试即可。当代码运行到断点处时,就会停留在断点处,然后就可以进行相关调试操作。

相关推荐
向哆哆10 分钟前
构建跨端健身俱乐部管理系统:Flutter × OpenHarmony 的数据结构与设计解析
数据结构·flutter·鸿蒙·openharmony·开源鸿蒙
不爱吃糖的程序媛33 分钟前
Flutter版本选择指南:3.38.10 发布,Flutter-OH何去何从?
flutter
2601_949809591 小时前
flutter_for_openharmony家庭相册app实战+相册详情实现
javascript·flutter·ajax
灰灰勇闯IT1 小时前
Flutter for OpenHarmony:弹窗与对话框(Dialog)—— 构建清晰的上下文交互
flutter·交互
晚霞的不甘1 小时前
Flutter for OpenHarmony从零到一:构建《冰火人》双人合作闯关游戏
android·flutter·游戏·前端框架·全文检索·交互
2601_949833391 小时前
flutter_for_openharmony口腔护理app实战+饮食记录实现
android·javascript·flutter
jian110582 小时前
Android studio 调试flutter 运行自己的苹果手机上
flutter·智能手机·android studio
向哆哆2 小时前
高校四六级报名管理系统的考试信息模块实现:Flutter × OpenHarmony 跨端开发实践
flutter·开源·鸿蒙·openharmony·开源鸿蒙
jian110582 小时前
Android studio配置flutter,mac Android studio 发现苹果手机设备
android·flutter·android studio
ujainu2 小时前
Flutter + OpenHarmony 实战:《圆环跳跃》——完整游戏架构与视觉优化
flutter·游戏·架构·openharmony