Version: 2019.4
言語: 日本語
スタンドアロンの Windows 向けプレイヤービルドバイナリ
WindowsLowIntegrity

Windows のデバッグ

Unity の機能を利用して、Windows でのゲームや、エディタープロセスのフォレンジックやライブのデバッグ作業を簡単に行うことができます。

Native vs. Managed デバッギング

まず、デバッギングに関して説明します。Unity には 2種類のデバッギングがあります。Native C++ デバッギングと C# Managed デバッギングです。IL2CPP をサポートするプラットフォームに関しては、Native デバッギングしかありません。ただし、Managed デバッギングも、エディターの高速反復の目的で使用されます。

Native デバッギング

Native デバッギングでは、連携するバイナリ ファイル (exe か dll) にシンボル (pdb ファイル) を使用できます。

Managed デバッギング

Windows では、標準 .NET が管理するシンボルが pdb ファイルに保管されています。

シンボル

Unity は、シンボル ストア http://symbolserver.unity3d.com/ を提供しています。このサーバー URL は、windbg か VS2012 以降で自動シンボル解決とダウンロードに使用できます (Microsoft のシンボル ストアに類似)。

Windbg 設定

.sympath コマンドを使用すると、簡単に windbg にシンボル ストアを加えることができます。

.sympath+ SRV*c:\\symbols-cache*http://symbolserver.unity3d.com/

細かく見てみましょう。

.sympath+ プラス (+) は既存のシンボルパスを保持し、シンボルストアを追加します。

SRV*c:\symbols-cache

*http://symbolserver.unity3d.com/ フェッチ元のシンボル ストアのパスです。

Visual Studio 設定

注意 VS2010 以前のバージョンは http サーバーシンボルストアに使用できない場合があります。 1. Tools -> Options を選択します 2. デバッギング セクションを広げ、Symbols を選択します 3. キャッシュ ディレクトリを指定します (指定されていない場合) 4. Symbol file (.pdb) location に http://symbolserver.unity3d.com/ を入力します

Live デバッギング

Live デバッギングは、デバッガーを正常作動している処理や、発生した例外の処理に接続して行います。デバッガ―が状態を把握するために、シンボルがビルド内に含まれている必要があります。前出の手順はそのためのものです。ゲームの実行ファイル名は、ゲーム名に基づいています。そのため、もし、名前の変更をした実行ファイルにアクセスできない場合、正しい pdb を見つけられない場合があることに注意してください。

自動例外デバッグの設定

Windows では、アプリケーション キャッシュが自動的に Microsoft に報告される Dr Watson/Error Reporting が Microsoft によって設定されています。ただし、Visual Studio か windbg がインストールされている場合は、かわりに、Microsoft が精通した開発者のために提供したクラッシュのデバッギングを選択できます。 インストールを簡単にするために、こちらのレジストリ ファイルをインストールしてください。

Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AeDebug]
"Auto"="1"
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows NT\CurrentVersion\AeDebug]
 "Auto"="1"

エディター デバッギングのちょっとしたおまけ

Unity.exe -dbgbreak 自動クラッシュ処理が設定されている場合、上記は Unity を起動して、即座にデバッガーを接続します。

Post-Mortem (検死) / フォレンジック デバッギング

Windows にはクラッシュ ダンプ ファイル (.dmp か .mdmp) を検証する機能があります。クラッシュ ダンプのタイプによって、単なるスタック情報やプロセス全体のメモリである場合もあります。内容によって、何がクラッシュの原因となったかを見るとさまざまな可能性があります。通常の場合は、少なくともスタックを検証することができます(有効なスタックである場合)。

ダンプ ファイルを検証するには、Visual Studio か windbg を通じてオプションを起動します。Visual Studio のほうが容易に使えますが、パワーに関しては、windbg よりも少し限られています。

デバッグのヒントとコツ

ネイティブの Managed 例外

NullReferenceException は、しばしば以下のように表示されます。

    \\tmono.dll!mono_jit_runtime_invoke(_MonoMethod * method=0x242bf8b0, void * obj=0x065c3960, void ** params=0x0018cba4, MonoObject * * exc=0x0018cb8c)  Line 4889 + 0xc bytes\\tC

これは、malloc のクラッシュでも mono のクラッシュでもありません。 - 以下の内、いずれかの NullReferenceException です。 * VS デバッガ―で発生した NullReferenceException * ユーザー プレイヤーでハンドルされなかったため、プレイヤーが終了する原因となった NullReferenceException

Managed スタック フレームを見る

前出の例を再度見てみましょう。

    \\tmono.dll!mono_jit_runtime_invoke(_MonoMethod * method=0x242bf8b0, void * obj=0x065c3960, void ** params=0x0018cba4, MonoObject * * exc=0x0018cb8c)  Line 4889 + 0xc bytes\\tC

何も情報がない行は、Managed フレームです。ただし、Managed スタック情報を取得する方法があります。mono にはmono_pmip というビルトイン機能があります。これは、スタックフレームのアドレスを受領し、情報とともに char* を返します。 mono_pmip は Visual Studio のイミディエイトウィンドウで呼び出すことができます。

?(char*)mono.dll!mono_pmip((void*)0x1b45558c)

注意 mono.dll シンボルが適切に読み込まれている場合にのみ作動します。

アプリケーションの強制による、ダンプファイルの作成

デバッガーが接続された状態でアプリケーションがクラッシュしない場合や、デバッガーが使用できないリモートデバイスでアプリケーションがクラッシュする場合があります。 ただし、ダンプファイルを取得できる場合は、有用な情報を得ることができます。ダンプファイルを取得する手順は以下の通りです。

これらの手順は、Windows スタンドアロンとユニバーサル Windows プラットフォーム用 (デスクトップで実行している場合) です。

  • レジストリを開きます。
  • HKEY LOCAL MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting へ移動します
  • LocalDumps フォルダーがなかった場合は作成します。
  • 次のキーを作成します。
    • “DumpFolder”=<FolderPath goes here> , 例えば、C:\Temp
    • “DumpCount”=dword:00000010
    • “DumpType”=dword:00000002
  • アプリケーションを起動します (Windows で実行するものすべて - ユニバーサル Windows プラットフォーム、または、 Windows スタンドアロン実行ファイル)。
  • クラッシュを再現して、ダンプファイルが指定のフォルダーに作られます。ダンプファイルは Visual Studio と WinDbg のどちらでも開けます。

• 2017–05–16 修正されたページ

スタンドアロンの Windows 向けプレイヤービルドバイナリ
WindowsLowIntegrity