このページでは、Winscope ウェブ UI を使用してトレースを読み込む方法について説明します。
ウェブ UI を使用してアップロードする
Winscope をローカルで実行することも、ウェブサーバーからアクセスすることもできます。
Winscope にキャプチャしたトレースを読み込むには、[トレースをアップロード] パネルを使用して、保存したトレースをアップロードします。[別のファイルをアップロード] をクリックしてトレースをさらにアップロードするか、[X] をクリックしてアップロードしたトレースを削除します。
図 1. Winscope でトレースをアップロードします。
[トレースを表示] をクリックして、アップロードされたトレースを表示します。各トレースのタブがウィンドウの上部パネルに表示されます。アップロードされたファイルに関連するトレースが含まれている場合、画面録画トレースまたはスクリーンショットのフローティング ビューが画面にオーバーレイされます。
詳細については、トレースを分析するをご覧ください。
警告とエラーを解析する
Winscope では、スナックバーを使用して、データが古いためにトレース ファイルが破棄された場合など、トレース読み込み時に検出された問題を表示します。現在の警告とその意味を次のリストに示します。
| メッセージ | 説明 |
|---|---|
| 破損したアーカイブ | ZIP ファイルを読み込めませんでした。これは通常、ZIP が空（0 バイト）の場合に発生します。 |
<filename>: データが古いため破棄 |
次のトレースが開始される 5 分以上前に終了したトレースは破棄されます。 |
<filename>: データが <time> より古いため破棄 |
検出された最新の単調または起動時間のオフセットに基づいて、オフセットが 5 秒を超えるトレースは無視されます。 |
<filename>: <trace type> タイプの別のトレースによってオーバーライドされている |
同等のトレース（トレースやダンプなど）が同じファイルに存在する場合、Winscope は次のルールを使用します。
|
<filename>: 同じタイプの別のトレースによってオーバーライドされている |
同じタイプのトレースがある同じファイルでは、Winscope は次のルールを使用します。
|
<filename>: サポートされていない形式 |
プロトコルが正しくないか、Winscope パーサーがないため、以前のトレースを解析できません。 |
<parser_name> パーサーを作成できませんでした: <error> |
Winscope はトレース パーサーを特定しましたが、ファイルを解析できませんでした。Winscope バグを報告し、トレースを添付します。 |
| すべてのトレースを可視化できない: タイムライン データを初期化できませんでした。トレースの数を減らしてみてください。 | Winscope がトレースからタイムライン データを解析できませんでした。Winscope バグを報告し、トレースを添付する。 |
フレーム マッピング中にエラーが発生しました: <error> |
Winscope で、ナビゲーションの異なるトレース間の状態のマッピングに失敗しました。Winscope バグを報告し、トレースを添付する。 |
<table> の 1 つ以上のエントリに vsync_id 値がありません |
vsync ID 情報がないため、Perfetto トレースを読み込めませんでした。Winscope バグを報告し、トレースを添付する。 |
重複する SF レイヤ ID <layerId> が見つかりました - 階層に「重複」として追加されます |
SurfaceFlinger トレースには、同じ layerId を持つ 2 つのレイヤが含まれています。SurfaceFlinger のバグを報告し、トレースを添付する。 |
| 画面の録画は、他のトレースと同期されない場合があります。メタデータに経過時間ではなく単調増加時間を含む | 画面録画ファイルが古く、同期できない以前のメタデータ形式を使用している。新しいバージョンの Android の画面録画では、この問題は発生しません。 |
| すべての遷移を解析できない。一部の切り替え効果は、切り替え効果ビューアに表示されない場合があります。 | 以前の遷移トレースを解析できないため、データがビジューアに表示されない可能性があります。 |
<filename>: <error> |
マッピングされていないその他のエラー。Winscope バグを報告し、トレースを添付する。 |