本頁面說明如何使用 Winscope 網頁介面載入追蹤記錄。
使用網頁版 UI 上傳
您可以在本機執行 Winscope，也可以透過網路伺服器存取。
如要在 Winscope 中載入擷取的追蹤記錄，請使用「Upload Traces」面板上傳已儲存的追蹤記錄。按一下「上傳其他檔案」即可上傳更多追蹤記錄，或按一下「X」移除已上傳的追蹤記錄。
圖 1. 在 Winscope 中上傳追蹤記錄。
按一下「查看追蹤」，即可查看上傳的追蹤記錄。每個追蹤記錄的分頁都會顯示在視窗頂端面板。如果上傳的檔案包含相關追蹤記錄，畫面上會疊加顯示螢幕錄影追蹤記錄或螢幕截圖的浮動檢視畫面。
詳情請參閱「分析追蹤記錄」。
剖析警告和錯誤
Winscope 會使用 Snackbar 顯示載入追蹤記錄時發現的問題，例如因資料過舊而捨棄追蹤記錄檔案。以下列出目前的警告及其意義：
| 訊息 | 說明 |
|---|---|
| 封存檔已損毀 | 無法載入 ZIP 檔案。如果 ZIP 檔案為空 (0 位元組)，通常會發生這種情況。 |
<filename>：因資料過舊而遭到捨棄 |
如果追蹤記錄在下一個追蹤記錄開始前 5 分鐘以上完成，系統就會捨棄該記錄。 |
<filename>：已捨棄，因為資料早於 <time> |
根據最近一次找到的單調或開機時間偏移，系統會捨棄偏移大於 5 秒的任何追蹤記錄。 |
<filename>：遭其他類型為 <trace type> 的追蹤記錄覆寫 |
如果同一個檔案中存在等效的追蹤記錄 (例如追蹤記錄和傾印)，Winscope 會使用下列規則：
|
<filename>：由相同類型的其他追蹤記錄覆寫 |
如果同一個檔案中存在相同類型的追蹤記錄，Winscope 會使用下列規則：
|
<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 錯誤並附上追蹤記錄。 |