イメージのデバッグの簡略化

[アーティクル]
08/14/2007

アンマネージコードをコンパイルするときは、IDE スイッチまたはコマンドラインオプションを使用して、デバッグ用の実行可能イメージを構成できます。たとえば、Visual C++ で /Zi コマンドラインオプションを使用すると、デバッグシンボルファイル (拡張子 .pdb) が生成されます。同様に、/Od コマンドラインオプションを使用すると、コンパイラは最適化処理を無効にします。出力されるコードの処理速度は低下しますが、デバッグは簡単になるため、デバッグ時にはこれらのオプションを指定することをお勧めします。

.NET Framework マネージコードをコンパイルするとき、Visual C++、Visual Basic、C# などのコンパイラは、そのソースプログラムをコンパイルして Microsoft Intermediate Language (MSIL) を生成します。MSIL は、実行される直前にコンパイルされて、ネイティブなマシン語コードになります。アンマネージコードでは、IDE スイッチまたはコマンドラインオプションを設定することにより、デバッグ用の実行可能イメージを構成できます。さらに、ほとんど同じ方法で、デバッグ用の JIT コンパイルを構成することもできます。

このような目的で JIT を構成する場合、次の 2 つの要素が関係してきます。

開発者は、JIT コンパイラに対し、追跡情報を生成するように要求できます。追跡情報を生成すると、デバッガは、MSIL のチェインをマシン語コードの対応部分に対応させたり、ローカル変数と関数の引数が格納される位置を追跡したりできるようになります。.NET Framework バージョン 2.0 では、JIT コンパイラは常に追跡情報を生成します。そのため、要求する必要がありません。
開発者は、JIT コンパイラに対し、出力するマシン語コードを最適化しないように要求できます。

通常、MSIL を生成するコンパイラは、指定された IDE スイッチまたはコマンドラインオプション (/Od など) に基づいて、これらの JIT コンパイラオプションを適切に設定します。

場合によっては、JIT コンパイラが生成するマシン語コードをデバッグしやすくするために、JIT コンパイラの動作の変更が必要となることがあります。たとえば、製品版またはコントロールを最適化するために JIT 追跡情報の生成が必要となる場合などです。このような場合は、初期化 (.ini) ファイルを使用します。

たとえば、MyApp.exe というアセンブリをデバッグする場合は、MyApp.exe と同じフォルダ内に MyApp.ini というテキストファイルを作成します。MyApp.ini ファイルには、次の 3 行を記述します。

[.NET Framework Debugging Control]
GenerateTrackingInfo=1
AllowOptimize=0

各オプションの値として、0 または 1 を設定できます。記述しなかったオプションの値は、既定値の 0 に設定されます。GenerateTrackingInfo を 1 に設定し、AllowOptimize を 0 に設定すると、デバッグが最も簡単になります。

メモ :
.NET Framework Version 2.0 では、JIT コンパイラが `GenerateTrackingInfo` の値に関係なく常に追跡情報を生成しますが、`AllowOptimize` の値は引き続き効力を持ちます。ネイティブイメージジェネレータ (Ngen.exe) を使用して最適化を行わずにネイティブイメージをプリコンパイルする場合は、`AllowOptimze=0` が記述された .ini ファイルが、Ngen.exe 実行時にターゲットフォルダ内に存在している必要があります。最適化を行わずにアセンブリをプリコンパイルした場合は、プリコンパイルされたコードを NGen.exe の /uninstall オプションを使用して削除したうえで、Ngen.exe を再度実行してコードを最適化してプリコンパイルする必要があります。.ini ファイルがフォルダにない場合は、Ngen.exe が既定でコードを最適化してプリコンパイルします。

メモ :

.NET Framework Version 2.0 では、JIT コンパイラが GenerateTrackingInfo の値に関係なく常に追跡情報を生成しますが、AllowOptimize の値は引き続き効力を持ちます。ネイティブイメージジェネレータ (Ngen.exe) を使用して最適化を行わずにネイティブイメージをプリコンパイルする場合は、AllowOptimze=0 が記述された .ini ファイルが、Ngen.exe 実行時にターゲットフォルダ内に存在している必要があります。最適化を行わずにアセンブリをプリコンパイルした場合は、プリコンパイルされたコードを NGen.exe の /uninstall オプションを使用して削除したうえで、Ngen.exe を再度実行してコードを最適化してプリコンパイルする必要があります。.ini ファイルがフォルダにない場合は、Ngen.exe が既定でコードを最適化してプリコンパイルします。

メモ :
アセンブリの設定は、System.Diagnostics.DebuggableAttribute によって制御されます。DebuggableAttribute には、2 つのフィールドがあり、それぞれは、JIT コンパイラが最適化処理を実行するかどうか、および追跡情報を生成するかどうかを設定します。.NET Framework バージョン 2.0 では、JIT コンパイラは常に追跡情報を生成します。

アセンブリの設定は、System.Diagnostics.DebuggableAttribute によって制御されます。DebuggableAttribute には、2 つのフィールドがあり、それぞれは、JIT コンパイラが最適化処理を実行するかどうか、および追跡情報を生成するかどうかを設定します。.NET Framework バージョン 2.0 では、JIT コンパイラは常に追跡情報を生成します。

メモ :
製品版をビルドする場合、コンパイラは DebuggableAttribute のどちらのフィールドも設定しません。JIT コンパイラの既定の動作では、最大のパフォーマンスを達成する、デバッグが最も困難なマシン語コードを生成します。JIT 追跡を有効にすると、パフォーマンスが多少低下します。最適化処理を無効にすると、パフォーマンスは大幅に低下します。

製品版をビルドする場合、コンパイラは DebuggableAttribute のどちらのフィールドも設定しません。JIT コンパイラの既定の動作では、最大のパフォーマンスを達成する、デバッグが最も困難なマシン語コードを生成します。JIT 追跡を有効にすると、パフォーマンスが多少低下します。最適化処理を無効にすると、パフォーマンスは大幅に低下します。

メモ :
DebuggableAttribute は、アセンブリに含まれる個々のモジュールではなく、アセンブリ全体に適用されます。そのため開発ツールでは、アセンブリが既に作成されている場合は、カスタム属性をアセンブリのメタデータトークン、または System.Runtime.CompilerServices.AssemblyAttributesGoHere というクラスに追加できる必要があります。次に、ALink ツールによって、これらの DebuggableAttribute 属性は、各モジュールからこれらのモジュールが構成の一部となるアセンブリへと昇格されます。競合が発生すると、ALink の操作は失敗します。

DebuggableAttribute は、アセンブリに含まれる個々のモジュールではなく、アセンブリ全体に適用されます。そのため開発ツールでは、アセンブリが既に作成されている場合は、カスタム属性をアセンブリのメタデータトークン、または System.Runtime.CompilerServices.AssemblyAttributesGoHere というクラスに追加できる必要があります。次に、ALink ツールによって、これらの DebuggableAttribute 属性は、各モジュールからこれらのモジュールが構成の一部となるアセンブリへと昇格されます。競合が発生すると、ALink の操作は失敗します。

メモ :
.NET Framework Version 1.0 では、/clr および /Zi コンパイラオプションを指定すると、Microsoft Visual C++ コンパイラによって DebuggableAttribute が追加されます。.NET Framework Version 1.1 では、DebuggableAttribute をコードに手動で追加するか、/ASSEMBLYDEBUG リンカオプションを使用する必要があります。

イメージのデバッグの簡略化

参照

概念

その他の技術情報

その他のリソース