调试预览指南

本文介绍大屏应用在【调试预览】界面下的详细功能。 大屏支持两种应用预览的模式：【正常预览】和【调试预览】。

• 正常预览：在编辑器右上方单击【预览】图标（），选择正常预览时，不会记录预览可视化应用时的报错和日志。
• 调试预览：在编辑器右上方单击【调试预览】图标（），选择调试预览时，将记录在预览可视化应用时组件和蓝图内的交互日志和报错信息。

说明

• 进入【**调试预览】**界面后，默认开启日志和报错记录。

蓝图日志&报错功能介绍

使用前提：要使用蓝图日志&报错功能，首先需要在蓝图编辑器界面内，将需要被监听的连线选中，并右键单击【记录日志】。 在【**调试预览】**界面产生交互行为时，如果命中记录日志的交互，则记录这次连线交互的上下游节点关系和交互触发时产生的数据快照。 在进入【**调试预览】**界面后，单击左侧边缘的【开启调试】，选择【**蓝图日志&报错】**界面，在当前可进行如下操作：

• 开始记录/暂停记录：单击记录图标，切换到开始记录即可监听蓝图日志和报错或暂停记录模式即可关闭监听。 说明 为了避免日志刷新时影响可视化应用的性能，建议用户在预览调试可视化应用时关闭数据的自动更新，或增加数据自动更新时长。
• 清空记录：单击清空日志图标，即可清除当前界面所有日志或报错内容。
• 渲染日志：点击渲染图标，即可显示日志记录。
• 日志记录：每次新的交互后，将在原来的日志记录的最上方新增一条记录。单击打开某个日志记录，选择日志记录中的连线，右侧会弹出数据快照框，框内将进一步说明报错时的数据、回调ID（如有）、页面临时变量（如有）以及报错堆栈等情况。

记录交互日志没有报错时，连线为蓝色。 说明 在连线左侧的逻辑节点中，若使用了getLocalValue和getCallbackValue，获取到了回调id和临时变量，才会记录在localValue和callbackValue的数据快照中。

组件日志&报错功能介绍

在进入调试预览界面后，单击左侧边缘的开启调试，选择组件日志&报错界面，在当前可进行如下操作：

• 开始记录/暂停记录：单击记录图标，切换到开始记录即可监听组件日志和报错或暂停记录模式即可关闭监听。 说明 为了避免日志刷新时影响可视化应用的性能，建议用户在预览调试可视化应用时关闭数据的自动更新，或增加数据自动更新时长。

• 清空日志：单击清空日志图标，即可清除当前界面所有日志或报错内容。

• 日志记录：当组件请求发生错误时，面板内会将在原来的记录的最上方新增一条报错记录。单击选择一个报错记录，右侧会弹出数据快照框，框内将进一步说明报错时的数据、回调ID（如有）、页面临时变量（如有）以及报错堆栈情况。

• 表 1. 组件日志记录的常见报错类型 | 报错类型 | 类型说明 | | :--- | :--- | | 数据源报错 | 组件请求数据源发生错误时，产生该报错。数据源的请求可能发生在组件首次加载时、组件自动更新时、组件回调id触发更新时、蓝图触发请求数据源动作时。展示报错的组件ID、数据源ID、错误描述。 | | 过滤器报错 | 组件请求数据源成功返回数据后，经过过滤器时产生报错，将记录为过滤器报错。展示报错的组件ID、数据源ID、过滤器ID、错误描述。 | | 组件内部报错 | 组件渲染或执行组件方法时产生的报错。选择组件内部报错，展示报错的组件ID、组件方法。 | | 节点内部报错 | 蓝图节点内代码出现问题时，导致的节点初始化报错等。 |

说明 当调用组件方法时的参数不符合组件声明时，将产生警告信息。

调试窍门

以终为始，用最小粒度记录日志。如遇到当目标组件的交互效果未产生时，可从目标组件的动作开始，往回反查每一步的传入数据是否正确。