TeamCity On-Premises 2026.2 Help

FxCop

FxCop ビルドランナーは、.NET アセンブリをインスペクションし、可能な設計、ローカライゼーション、パフォーマンス、セキュリティの改善を報告することを目的としています。 TeamCity で FxCop レポートを表示する場合は、対応するビルドランナーを構成するか、FxCop ツールをスクリプトから直接実行したい場合はサービスメッセージを使用して XML レポートをインポートできます。

サポートされている FxCop バージョンのリストについては、 サポートされているプラットフォームと環境を参照してください。

FxCop ビルドランナー設定

FxCop のインストール

オプション

説明

FxCop 検出モード

ビルドエージェントが起動されると、FxCop がインストールされているかどうかを自動的に検出します。 FxCop が検出された場合、TeamCity は %system.FxCopRoot% エージェントシステムプロパティを定義します。 FxCop のカスタムインストールまたはバージョン管理でチェックインされた use FxCop を使用することもできます。 選択に応じて、以下に表示される設定は異なります。

自動検出インストール

エージェントで FxCop インストールを使用することを選択します。

FxCop バージョン

選択されている場合にこのオプションを使用できます。 ドロップダウンからいずれかのオプションを選択します。 複数のバージョンの FxCop がビルドエージェントにインストールされている場合、不整合を避けるために、ビルドでインスペクションを実行する際に使用する特定の FxCop バージョンをここで選択することをおすすめします。 その結果、エージェント要件が作成されます。 フィールドのデフォルト値 ('Any Detected') のままにすると、TeamCity は FxCop がインストールされている利用可能な任意のエージェントを使用します。 この場合、あるビルドで使用される FxCop のバージョンが前回のビルドで使用されたものと同じでない可能性があるため、検出される新しい問題の数は実際の状態とは異なります。

インストールルートを指定する

(自動検出されたものではなく)FxCop のカスタムインストールを使用するか、ビルドエージェントに FxCop がインストールされていない場合(たとえば、FxCop ツールをソース管理に配置してビルドソースでチェックアウトすることができます))

インストールルート

選択されている場合にこのオプションを使用できます。 エージェントマシン上の FxCop インストールルートへのパス、または ビルドチェックアウトディレクトリ を基準とする FxCop 実行可能ファイルへのパスを入力します。

インスペクション対象

オプション

説明

アセンブリ

インスペクションするアセンブリへのパスを入力します(Ant のようなワイルドカードを使用してマスクでファイルを選択します)。 FxCop はデフォルト設定を使用してインスペクションします。 パスは ビルドチェックアウトディレクトリ を基準にし、スペースで区切る必要があります。 含まれるアセンブリリストを絞り込むには、exclude ワイルドカードを入力します。

コマンドライン文字列の制限(英語)のため、ここで指定できるアセンブリの最大数には制限があります。

FxCop プロジェクトファイル

FxCop プロジェクトへのパスを ビルドチェックアウトディレクトリ からの相対パスとして入力します。

FxCop オプション

オプション

説明

GAC で参照アセンブリを検索する

グローバルアセンブリキャッシュでターゲットによって参照されているアセンブリを検索します。

ディレクトリ内の参照アセンブリを検索する

スペースで区切られた指定されたディレクトリで、ターゲットによって参照されているアセンブリを検索します。

生成コードを無視する

FxCop 1.36 で導入された新しいオプション。 インスペクションをスピードアップします。

XSLT ファイルを報告

ビルドチェックアウトディレクトリ を基準とする XSLT 変換ファイルへの相対パス、またはエージェントマシン上の絶対パス。 ターゲットマシンで検出された FxCop へのパスを使用できます(%system.FxCopRoot%/Xml/FxCopReport.xsl)。 XSLT ファイルを報告 オプションが設定されていると、ビルドランナーは XSLT 変換を FxCop XML 出力に適用し、結果の HTML をビルド結果ページの新しい FxCop タブに表示します。

追加の FxCopCmd オプション

FxCopCmd 実行可能ファイルを呼び出すための追加オプション。 入力したすべてのオプションは、コマンドラインパラメーターの先頭に追加されます。

ビルド失敗条件

指定された分析エラーでビルドを失敗させるには、チェックボックスをオンにします。 ビルド失敗条件をクリックして、エラーの数を定義します。

サービスメッセージの使用

FxCop ツールをビルドランナーとしてではなくスクリプトから直接呼び出したい場合は、 データのインポート サービスメッセージ を使用して、 FxCopCmd ツール によって生成された XML ファイルを TeamCity にインポートできます。 この場合、FxCop ツールの結果は、 ビルド結果 ページの コードインスペクション タブに表示されます。

サービスメッセージ の形式は以下のとおりです:

##teamcity[importData type='FxCop' path='<path_to_the_xml_file>']
2026 年 9 月 11 日