加载轨迹

本页介绍了如何使用 Winscope Web 界面加载轨迹。

使用网页界面上传

您可以在本地运行 Winscope，也可以通过网络服务器访问它。

如需在 Winscope 中加载捕获的轨迹，请使用上传轨迹面板上传已保存的轨迹。点击上传其他文件以上传更多轨迹，或点击 X 以移除已上传的轨迹。

图 1. 在 Winscope 中上传跟踪记录。

点击查看轨迹可查看已上传的轨迹。每个轨迹的标签页都会显示在窗口的顶部面板上。如果上传的文件包含相关轨迹，屏幕录制的轨迹或屏幕截图的浮动视图会叠加在屏幕上。

如需了解详情，请参阅分析轨迹。

解析警告和错误

Winscope 使用信息条显示加载轨迹时发现的问题，例如当轨迹文件因数据过时而被舍弃时。以下列表包含当前的警告及其含义：

讯息	说明
归档文件损坏	未能加载 ZIP 文件。如果 ZIP 文件为空（0 字节），通常会出现这种情况。
<filename>：因数据过时而被舍弃	如果轨迹在下一个轨迹开始前超过 5 分钟结束，则会被舍弃。
<filename>：由于数据早于 <time>，因此被舍弃	根据最近找到的单调时间偏移或启动时间偏移，系统会舍弃偏移大于 5 秒的所有轨迹。
<filename>：被类型为 <trace type> 的其他轨迹覆盖	当同一文件中存在等效轨迹（例如轨迹和转储）时，Winscope 会使用以下规则： Perfetto 轨迹会替换相同类型的旧版轨迹。 屏幕录制内容会覆盖屏幕截图。
<filename>：被其他同类型的轨迹替换	如果同一文件中存在相同类型的轨迹，Winscope 会使用以下规则： Perfetto 轨迹会替换相同类型的旧版轨迹。 最大的 Perfetto 轨迹会覆盖所有其他 Perfetto 轨迹。 轨迹会替换 WindowManager 和 SurfaceFlinger 的转储。
<filename>：不支持的格式	由于 proto 无效或缺少 Winscope 解析器，因此无法解析旧版轨迹。
未能创建 <parser_name> 解析器：<error>	Winscope 识别了轨迹文件解析器，但无法解析文件。提交 Winscope bug 并附上轨迹文件。
无法可视化所有轨迹：未能初始化时间轴数据。请尝试移除一些轨迹。	Winscope 未能解析轨迹中的时间轴数据。提交 Winscope bug 并附上轨迹。
帧映射中发生错误：<error>	Winscope 未能将导航的不同轨迹之间的状态映射到一起。提交 Winscope bug 并附上轨迹。
<table> 中的一个或多个条目缺少 vsync_id 值	由于缺少 vsync ID 信息，未能加载 Perfetto 轨迹。提交 Winscope bug 并附上轨迹。
发现重复的 SF 图层 ID <layerId> - 将其作为“重复”添加到层次结构中	SurfaceFlinger 轨迹包含两个具有相同 layerId 的层。提交 SurfaceFlinger bug 并附上轨迹。
屏幕录制内容可能无法与其他轨迹同步。元数据包含单调时间，而不是经过的时间	屏幕录制文件已过时，并且使用无法同步的旧版元数据格式。使用较新版本 Android 进行的屏幕录制不应出现此问题。
无法解析所有转场效果。转场效果查看器中可能缺少某些转场效果。	无法解析旧版转场轨迹，因此查看器中可能缺少数据。
<filename>：<error>	其他未映射的错误。提交 Winscope bug 并附上轨迹。