ドキュメント

Unity Engine

Unity Engine

デバッウェブェブ

外部シンボル、JavaScriptScript エラーハンドラー、スタックトレースマッピングを使用して、デプロイされた ウェブ ビルドをデバッグします。
読み終わるまでの所要時間 6 分最終更新 5日前

外部シンボル、JavaScriptScript エラーハンドラー、スタックトレースマッピングを使用して、デプロイされた ウェブ ビルドをデバッグします。
Unity ウェブ ビルドは、ソースレベルのデバッグを完全にはサポートしていません。ただし、一部のデバッグ情報を保持し、ブラウザーエラーレポートを使用して、配備されたビルドのランタイムエラーを調査できます。

外部シンボルの使用

ウェブビルドで外部シンボルを有効にし (メニュー:
プレイヤー設定

?

> 公開設定> デバッグ設定> 外部)、本番スタックトレースに機能名を含めます。外部シンボルを使用してビルドする場合、Unity はメインのビルド出力とは別にシンボルファイルを生成します。
キャッチされない JavaScript 例外が発生した場合、Unity は外部シンボルデータを使用して WebAssembly スタックフレームを IL2CPP が生成した C/C++ 機能名にマップすることができます。これらの名前は、元の Cクラスとメソッドを識別するのに十分な読みやすさがあります。
例えば、
PlayerController.Jump()
などの C# メソッドは、スタックトレースに
PlayerController_Jump_m<hash>
として表示されます。
外部シンボルを使用して、正確なソース行ではなく、エラーが発生した機能を識別します。

スタックトレースをより正確に C# 名にマップ

より正確なマッピングが必要な場合、Unity はビルドプロセス中に
MethodMap.tsv
ファイルも生成します。このファイルは、IL2CPP によって生成されたメソッド名を元の C# メソッド名にマップするヘルプになります。これは特にオーバーロードされたメソッドに役立ちます。
Unity は
MethodMap.tsv
をビルド出力ディレクトリに自動的にコピーしません。以下にあります。
Library/Bee/artifacts/WebGL/il2cppOutput/cpp/Symbols

制限事項

外部シンボルには以下は含まれません。
  • 正確な C# ソースファイル名
  • 正確な C# 行番号
  • 本番 ウェブ ビルドで C# コードを 1 行ずつステップ実行する機能

ビルドサイズとランタイムへの影響

外部シンボル ファイルはエラー調査にのみ必要であるため、Unity はメイン ビルドとは別に保存します。つまり、外部シンボルファイルは、ユーザーの最初のアプリケーションダウンロードには影響しません。
シンボルファイルは通常 1 ~ 2 MB 程度であり、デプロイしたビルドアーティファクトとともに格納できます。
Unity は外部シンボル ファイルをメインのビルド出力とは別に格納するため、このアプローチによる本番ビルドの初期ダウンロード サイズとランタイム パフォーマンスへの影響は最小限です。

ブラウザー エラーのレポート

デプロイされた ウェブ ビルドからエラーレポートを収集するには、Unity コンテンツをホストするページに JavaScript エラーハンドラーを追加し、その結果を Analytics またはクラッシュレポートサービスに送信します。
便利なブラウザー フックには以下が含まれます。
  • window.onerror
  • window.addEventListener('error', ...)
  • console.error
これらのフックは、以下をキャプチャできます。
  • Uncaught JavaScript exceptions
  • 一部の WebAssembly ランタイムエラー
  • ブラウザー エラー レポートに表示される一部のエンジン エラー
これらのレポートを外部シンボルと組み合わせると、本番スタックトレースを読みやすくなります。

追加リソース