デバッウェブェブ
外部シンボル、JavaScriptScript エラーハンドラー、スタックトレースマッピングを使用して、デプロイされた ウェブ ビルドをデバッグします。
読み終わるまでの所要時間 6 分最終更新 5日前
外部シンボル、JavaScriptScript エラーハンドラー、スタックトレースマッピングを使用して、デプロイされた ウェブ ビルドをデバッグします。
Unity ウェブ ビルドは、ソースレベルのデバッグを完全にはサポートしていません。ただし、一部のデバッグ情報を保持し、ブラウザーエラーレポートを使用して、配備されたビルドのランタイムエラーを調査できます。
外部シンボルの使用
ウェブビルドで外部シンボルを有効にし (メニュー: > 公開設定> デバッグ設定> 外部)、本番スタックトレースに機能名を含めます。外部シンボルを使用してビルドする場合、Unity はメインのビルド出力とは別にシンボルファイルを生成します。
プレイヤー設定
?
キャッチされない JavaScript 例外が発生した場合、Unity は外部シンボルデータを使用して WebAssembly スタックフレームを IL2CPP が生成した C/C++ 機能名にマップすることができます。これらの名前は、元の Cクラスとメソッドを識別するのに十分な読みやすさがあります。
例えば、 などの C# メソッドは、スタックトレースに として表示されます。
PlayerController.Jump()PlayerController_Jump_m<hash>外部シンボルを使用して、正確なソース行ではなく、エラーが発生した機能を識別します。
スタックトレースをより正確に C# 名にマップ
より正確なマッピングが必要な場合、Unity はビルドプロセス中にファイルも生成します。このファイルは、IL2CPP によって生成されたメソッド名を元の C# メソッド名にマップするヘルプになります。これは特にオーバーロードされたメソッドに役立ちます。
MethodMap.tsvUnity はをビルド出力ディレクトリに自動的にコピーしません。以下にあります。
MethodMap.tsvLibrary/Bee/artifacts/WebGL/il2cppOutput/cpp/Symbols制限事項
外部シンボルには以下は含まれません。
- 正確な C# ソースファイル名
- 正確な C# 行番号
- 本番 ウェブ ビルドで C# コードを 1 行ずつステップ実行する機能
ビルドサイズとランタイムへの影響
外部シンボル ファイルはエラー調査にのみ必要であるため、Unity はメイン ビルドとは別に保存します。つまり、外部シンボルファイルは、ユーザーの最初のアプリケーションダウンロードには影響しません。
シンボルファイルは通常 1 ~ 2 MB 程度であり、デプロイしたビルドアーティファクトとともに格納できます。
Unity は外部シンボル ファイルをメインのビルド出力とは別に格納するため、このアプローチによる本番ビルドの初期ダウンロード サイズとランタイム パフォーマンスへの影響は最小限です。
ブラウザー エラーのレポート
デプロイされた ウェブ ビルドからエラーレポートを収集するには、Unity コンテンツをホストするページに JavaScript エラーハンドラーを追加し、その結果を Analytics またはクラッシュレポートサービスに送信します。
便利なブラウザー フックには以下が含まれます。
window.onerrorwindow.addEventListener('error', ...)console.error
これらのフックは、以下をキャプチャできます。
- Uncaught JavaScript exceptions
- 一部の WebAssembly ランタイムエラー
- ブラウザー エラー レポートに表示される一部のエンジン エラー
これらのレポートを外部シンボルと組み合わせると、本番スタックトレースを読みやすくなります。