dotCover 2024.3 ヘルプ

外部アプリケーションのカバレッジ分析を開始する

dotCover を使用すると、PDB 情報を持つ .NET アプリケーションおよびプロセスのカバレッジ分析を実行できます。次のタイプのアプリケーションとプロセスのカバレッジを分析できます。

プロセスフィルターの構成

プロファイルされたアプリケーションが多数のプロセスを作成する場合は、プロセスフィルター設定を使用して、プロファイルするプロセスを指定します。事前定義されたフィルターを選択するか、新しいフィルターを作成することができます。

プロセスフィルターは、選択した実行構成で指定されたアプリケーションタイプによって動作が異なることに注意してください。

アプリの種類

説明

スタンドアロン

.NET と .NET Core

Mono

Unity

dotCover は、指定されたフィルターに一致するプロセスに対してのみ分析を実行します。フィルターは、分析されたプロセスのプロセスツリー全体(子プロセスを含む)に適用されます。

例: 多数の子プロセスを作成するマネージドプロセスがあります。メインプロセスだけでなく、名前に service が含まれる子プロセスも分析する必要があります。これを行うには、*service* インクルードフィルターを追加します。

外部 .NET プロセス

このモードでは、カバレッジセッションを開始しても、分析対象のプロセスは開始されません。代わりに、dotCover はオペレーティングシステムで最初に開始された管理対象プロセスを待機し、そのプロセスにアタッチします。特定のプロセスフィルターが選択されると、dotCover はフィルターに一致する最初のプロセスにアタッチします。

例: インクルードフィルターを作成しました: *service*dotCover は、名前に service が含まれるシステムの最初のプロセスに接続します。

IIS

IIS Express

Windows サービス

WCF サービス

WinRT

MAUI

プロセスフィルターは適用されません。

プロセスフィルターを選択するには

  1. カバレッジオプションを指定するで、プロセスフィルターリストを開きます。

  2. 必要なフィルターを選択します。

    dotCover は、2 つの事前定義されたフィルターを提供します。

    • デフォルト : プロセスフィルターは適用されません。

    • プロセスツリー全体 : dotCover は、子プロセスを含むプロセスツリー全体を分析します。.NET プロセス実行構成が選択されている場合、dotCover は、すべての子プロセスを含む、システムで開始された最初の管理対象プロセスに接続して分析します。

    Select a predefined filter

プロセスフィルターを作成するには

  1. カバレッジオプションを指定するで、プロセスフィルターリストを開きます。

  2. フィルターの追加を選択します。

  3. フィルター設定を指定します。

    • 名前 : フィルター名。

    • プロセスツリー全体のプロファイル : 選択すると、dotCover は子プロセスを含むプロセスツリー全体を分析します。このオプションを無効にすることは、.NET プロセス実行構成のフィルターを作成する場合にのみ意味があります。この場合、dotCover はフィルターに一致するシステム内の最初のプロセスを待機してアタッチしますが、このプロセスの子プロセスは分析しません。

    • フィルターマスクを含めるフィルターマスクを除外する : それに応じてフィルターマスクを含めたり除外したりします。マスクは、次のルールに従って適用されます。

      • デフォルトのポリシーは「すべて分析」です。

      • インクルードマスクが最初に適用されます。除外マスクは、包含マスクによってフィルタリングされたプロセスに適用されます。

      • アスタリスク * ワイルドカードを使用できます。

      例: MyService を除く名前に Service が含まれるすべての子プロセスを分析するには、*Service* インクルードマスクと MyService エクスクルードマスクを追加します。

  4. 保存をクリックします。

対象バイナリのシンボルファイル(PDB)を見つけることは、カバレッジを計算するために不可欠です。単体テストスタートアッププロジェクトをカバーする場合、dotCover は現在のソリューションの構造を使用してシンボルファイルを簡単に見つけます。

デフォルトでは、次の場所にあるシンボルファイルを検索します。

  • バイナリファイルが存在するディレクトリと同じディレクトリにあります。

  • バイナリファイル内で指定されたデバッグディレクトリ内 ;

  • _NT_SYMBOL_PATH 環境変数とレジストリで指定されたすべてのディレクトリ

必要に応じて、シンボルファイルを探す他の場所を指定できます。これを行うには、カバレッジ設定ダイアログシンボル検索ポリシーの編集をクリックします。

表示されるシンボル検索ポリシーダイアログでは、以下の方法でシンボルファイルを検索できます。

  • 検索パスフィールドには、シンボルファイルを検索するパスをセミコロンで区切ったリストを指定します。各パスは、ディレクトリパスまたはシンボルサーバーパス (例: srv*C:\LocalSymbols*http://symbolserver:33417/) のいずれかになります。

  • アクセスシンボルサーバーを選択して、検索パスフィールドまたは _NT_SYMBOL_PATH 環境変数で指定された dotCover アクセスシンボルサーバーを許可します。

シンボルファイルを検索するためのデフォルトの方法を無効にすることもできます。