QML应用程序分析

您可以使用QML性能分析器来找到应用程序中典型性能问题的原因，如速度慢、无响应、界面卡顿。常见原因包括在很小的帧中执行过多的JavaScript。所有JavaScript都必须在GUI线程继续之前返回，如果GUI线程没有准备好，帧将被延迟或丢弃。

导致类似性能问题的另一个常见原因是创建、绘制或更新不可见项，这在GUI线程中会花费时间。

为了找到过度使用JavaScript，请在动画和场景图事件中检查帧率，寻找差距，并检查应用程序是否按预期运行。JavaScript类别显示了函数的运行时间，您应该尝试将其保持在每帧16毫秒以下。

为了找到由处理不可见项引起的问题，寻找丢帧并检查您是否没有使用太多的短绑定或每帧更新的信号处理器。您还可以可视化场景图重绘以检查场景布局，并找出用户永远不会看到的项目，因为这些项目位于屏幕外或被其他可见元素隐藏。

使用QML性能分析器

要在QML性能分析器中监视应用程序的性能

1. 要能够对应用程序进行性能分析，您必须为项目设置QML调试。有关更多信息，请参阅设置QML调试。

   注意：要设备上的应用程序进行性能分析，您必须在设备上安装Qt库。

2. 选择 分析 > QML性能分析器 以对当前应用程序进行性能分析。
3. 选择（开始）按钮从QML分析器启动应用程序。

   注意：如果数据收集没有自动启动，请选择（启用分析）按钮。

当您开始分析应用程序时，应用程序将启动，QML分析器立即开始收集数据。这由已耗时字段中运行的计时器表示。

数据将持续收集，直到您选择启用分析按钮。数据收集需要时间，因此，在数据显示之前可能会有延迟。

请勿使用应用程序命令退出应用程序，因为当您选择启用分析按钮时，数据会发送到QML分析器。应用程序将继续运行几秒钟后自动停止。如果您退出应用程序，数据将不会发送。

选择禁用分析按钮以禁用应用程序启动时的数据收集自动启动。重新选择按钮时将开始数据收集。

要保存所有收集到的数据，请选择分析 > QML分析器选项 > 保存QML跟踪。要查看保存的数据，请选择加载QML跟踪。您还可以与他人共享保存的数据或加载他们保存的数据。

指定刷新设置

您可以为QML分析器指定全局设置，适用于所有项目，或为每个项目单独指定。要指定全局设置，请选择首选项 > 分析器。

要指定特定项目的自定义QML分析器设置，请选择项目 > 运行，然后在QML分析器设置中选择自定义。要恢复项目的全局设置，请选择恢复全局。

选择分析时刷新数据复选框以定期刷新数据而不是在分析停止时刷新所有数据。这可以在目标设备上节省内存并且减少了分析停止和数据显示间的等待时间。

在刷新间隔字段中，设置以毫秒为单位的刷新间隔。间隔越短，刷新次数越多。间隔越长，目标应用程序中需要缓冲的数据越多，这可能会浪费内存。然而，刷新本身也需要时间，这可能会扭曲分析结果。

如果您有多个QML引擎并且您想要将它们产生的所有数据汇总到一个跟踪中，请选择仅当进程结束时处理数据复选框。否则，当其中一个引擎停止时，分析将停止。

附加到运行中的Qt Quick应用程序

您可以对未由Qt设计工作室启动的Qt Quick应用程序进行分析。但是，您必须在项目的构建设置中启用QML调试和分析。更多信息，请参见设置QML调试。

要附加到等待的应用程序

1. 选择分析 > QML分析器（附加到等待应用程序）。

   

2. 在工具包中，选择用于构建应用程序的工具包。
3. 在端口中，指定要监听的端口。
4. 选择确定。

分析收集到的数据

时间线视图显示QML和JavaScript执行的图形表示和所有记录事件的压缩视图。

时间表（6）中的每一行描述了一种已记录的 QML 事件类型。将光标移至行中的事件上，可以看到该事件持续的时间和它在源代码中的调用位置。要仅在选中事件时显示信息，请禁用鼠标悬停时查看事件信息按钮（4）。

概述（10）总结了收集数据的时期。拖动缩放范围（8）或单击概述来在其上移动。您还可以通过选择跳转到前一个事件和跳转到下一个事件按钮（1）在事件之间移动。

选择显示缩放滑块按钮（2）以打开一个滑块，您可以使用它设置缩放级别。您还可以拖动缩放把手（9）。要重置默认缩放级别，右键单击时间表以打开上下文菜单，然后选择重置缩放。

单击时间刻度来向时间表添加垂直方向线（5）。

选择事件范围

您可以选择事件范围（7）以查看事件的帧率，并将其与相似事件的帧率进行比较。选择选择范围按钮（3）以激活选择工具。然后在时间表中单击以指定事件范围的起始位置。拖动选择把手来定义范围的结束。范围的长度表示事件的帧率。

您还可以使用事件范围来测量两个后续事件之间的延迟。在一个事件的结尾和一个事件的开始之间放置范围。时间延迟（毫秒）字段显示事件的延迟。

要放大事件范围，请双击它。

要在时间表、统计信息和火焰图中缩小当前范围的当前范围，右键单击范围并选择分析当前范围。要返回完整范围，请在上下文菜单中选择分析完整范围。

要删除事件范围，请关闭选择对话框。

理解数据

通常，时间视图中的事件表示 QML 或 JavaScript 执行的持续时间。将鼠标悬停在其上以查看详细信息。对于大多数事件，它们包括源代码中的位置、持续时间和源代码本身的相关部分。

您可以通过单击事件来将代码编辑器中的光标移到与事件相关联的代码部分。

以下类型的事件显示在时间视图的一行或多行上。事件类型的可用性取决于应用程序编译时所使用的 Qt 版本以及它所使用的 Qt Quick 版本。

分析场景图事件

为了理解场景图类别，了解 Qt Quick 场景图是如何工作的重要。请参阅Qt Quick 场景图和Qt Quick 场景图默认渲染器获取详细描述。以下事件在场景图类别中报告。并非所有事件都由所有渲染循环生成。在 Windows 和基本渲染循环中，所有操作都在同一个线程中运行，GUI 线程和渲染线程之间的区别没有意义。

如果您设置了环境变量 QSG_RENDER_TIMING，您将获得待分析应用程序类似但略有不同的时间文本输出。以下列出差异，以便于定位。

分析Qt Quick 3D事件

以下是Qt Quick 3D的事件列表。每个渲染帧都由同步、准备和渲染阶段组成，依次完成。同步发生在场景图同步阶段，而准备和渲染则发生在场景图渲染阶段。

设置环境变量 QSG_RENDERER_DEBUG=render 也会提供不同渲染过程渲染调用次数的额外文本输出。这些调用次数在 Render Frame 事件中汇总。

查看统计

统计 视图显示每个绑定、创建、编译、JavaScript 或信号事件被触发的次数及其平均耗时。这允许您检查需要优化的哪个事件。发生次数很多可能表明事件是不必要地被触发的。要查看中位数、最长时间和最短时间，请在上下文菜单中选择 扩展事件统计。

在代码编辑器中点击事件可跳转到源代码中的该事件。

调用者 和 被调用者 面板显示事件之间的依赖关系。它们允许您检查应用程序的内部函数。调用者面板总结了触发绑定的 QML 事件。这告诉您是什么引起绑定发生变化。被调用者面板总结了绑定引发的 QML 事件。这告诉您，如果您更改绑定，哪些 QML 事件受到影响。

在代码编辑器中点击事件可跳转到源代码中的该事件。

当您在 时间轴 视图中选择事件时，相关信息将在 统计 和 火焰图 视图中显示。

要复制一个视图或行的内容到剪贴板，请在上下文菜单中选择 复制表格 或 复制行。

对于使用 Qt Quick 2 并使用 Qt 5.3 或更高版本编译的应用程序，统计视图中仅显示 JavaScript 事件。

将统计分析可视化成火焰图

火焰图 视图显示了 QML 和 JavaScript 执行的更简洁的统计概览。在 总时间 视图中，水平条显示了一定函数所有调用所需的总时间，相对于所有 JavaScript 和 QML 事件的总运行时间。嵌套显示是哪一些函数被哪些其他函数调用。

要查看函数分配的总内存量，请选择下拉菜单中的 内存。

要查看函数执行的内存分配次数，请选择 分配。

双击视图中的项可放大查看。双击视图中的空白区域可再次放大退出。

与时间轴视图不同，火焰图视图不会显示没有任何QML或JavaScript运行时的时段。因此，它不适用于分析每帧执行时间。然而，很容易在那里看到各种QML和JavaScript事件的总影响。