載入追蹤記錄

本頁面說明如何使用 Winscope Web UI 載入追蹤記錄。

使用網頁版 UI 上傳

您可以在本機執行 Winscope，或透過網路伺服器存取 Winscope。

如要在 Winscope 中載入擷取的追蹤記錄，請使用「Upload Traces」面板上傳已儲存的追蹤記錄。點選「上傳其他檔案」即可上傳更多追蹤記錄，或點選「X」移除已上傳的追蹤記錄。

圖 1. 在 Winscope 中上傳追蹤記錄。

按一下「查看追蹤記錄」，查看已上傳的追蹤記錄。每個追蹤記錄的分頁會顯示在視窗頂端面板上。如果上傳的檔案包含相關追蹤記錄，系統會在畫面上疊加螢幕錄製追蹤記錄或螢幕截圖的浮動檢視畫面。

詳情請參閱「分析追蹤記錄」。

剖析警告和錯誤

Winscope 會使用 Snackbar 顯示載入追蹤記錄時發現的問題，例如資料過舊而捨棄追蹤記錄檔的情況。以下清單列出目前的警告及其意義：

訊息	說明
封存檔案毀損	無法載入 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 錯誤並附上追蹤記錄。
無法將所有追蹤記錄轉換為視覺化資料：無法初始化時間軸資料。請嘗試移除部分記錄。	Winscope 無法剖析追蹤記錄中的時間軸資料。回報 Winscope 錯誤並附上追蹤記錄。
影格對應發生錯誤：<error>	Winscope 無法將不同追蹤記錄之間的狀態對應至導覽功能。回報 Winscope 錯誤並附上追蹤記錄。
<table> 中缺少一或多個項目的 vsync_id 值	缺少 vsync ID 資訊，因此無法載入 Perfetto 追蹤記錄。回報 Winscope 錯誤並附上追蹤記錄。
找到重複的 SF 圖層 ID <layerId>，已將其新增至階層並標示為「重複」	SurfaceFlinger 追蹤記錄包含兩個具有相同 layerId 的圖層。回報 SurfaceFlinger 錯誤並附上追蹤記錄。
螢幕錄影可能無法與其他追蹤記錄同步。中繼資料包含單調時間，而非經過時間	螢幕錄製檔案過舊，且採用無法同步的舊版中繼資料格式。較新版本的 Android 螢幕錄影功能不應發生這個問題。
無法剖析所有轉場效果。部分轉場效果可能會在轉場檢視器中缺少。	無法剖析舊版轉場追蹤記錄，因此檢視器可能會缺少資料。
<filename>：<error>	其他未對應的錯誤。回報 Winscope 錯誤並附上追蹤記錄。