TeamCity オンプレミス 2025.11 ヘルプ

FxCop

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

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

FxCop ビルドランナー設定

FxCop のインストール

オプション

説明

FxCop 検出モード

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

自動検出インストール

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

FxCop バージョン

このオプションは、選択すると利用可能になります。ドロップダウンからオプションを 1 つ選択します。ビルドエージェントに複数のバージョンの FxCop がインストールされている場合は、不整合を回避するために、ビルドでインスペクションを実行するために使用する特定のバージョンの FxCop をここで選択することをお勧めします。その結果、エージェント要件が作成されます。フィールドのデフォルト値 (「Any Detected」) のままにすると、TeamCity は FxCop がインストールされている使用可能なエージェントを使用します。この場合、1 つのビルドで使用される 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 ツールをビルドランナーとしてではなくスクリプトから直接呼び出す場合は、importData サービスメッセージを使用して、FxCopCmd ツール(英語)によって生成された XML ファイルを TeamCity にインポートできます。この場合、FxCop ツールの結果は、ビルド結果ページのコードインスペクションタブに表示されます。

サービスメッセージの形式は次のとおりです。

##teamcity[importData type='FxCop' path='<path_to_the_xml_file>']
2025 年 10 月 27 日

関連ページ:

サポートされているプラットフォームと環境

このページでは、TeamCity が動作するソフトウェア関連の環境について説明します。ハードウェア関連の注意事項については、このセクションを参照してください。オペレーティングシステム:TeamCity サーバー TeamCity サーバーは、対応 J2EE サーブレットコンテナー内で実行される Web アプリケーションです。実行するには、Java SE JRE のインストールが必要です。TeamCity サーバーに Java をインストールする方法については、注記を参照してください。サポートされ...

サービスメッセージ

サービスメッセージは、ビルドに関するコマンド / 情報をビルドスクリプトから TeamCity サーバーに渡す特別に構成されたテキストです。TeamCity、それらはビルドの標準出力ストリームに書き込まれる必要があり、ビルドステップから出力またはエコーされますによって処理されます。例:echo ##teamcity[<messageName> 'value']echo

ビルド結果ページ

TeamCity では、ビルドに関するすべての情報 (キューに入っているか、実行中か、完了しているかに関係なく) がビルド結果ページに蓄積されます。ビルド結果を表示するには、任意の構成を選択してビルド履歴を表示し、必要なビルド番号をクリックします。このページには、いくつかの静的タブ (概要、変更、ビルドログ、アーティファクトなど) と、特定の構成機能に応じて表示が決まるコンテキストタブが含まれます。例: 依存関係タブは、親構成がビルドチェーンに属するビルドに対してのみ表示されます。内部ビルド ID...

Gradle

このビルドステップは、Gradle プロジェクトのビルドに合わせて調整されており、およびを含むすべての Gradle ビルド構成をサポートします。前提条件:Gradle でビルドを実行するには、Gradle 0.9-rc-1 以降がすべてのエージェントマシンにインストールされている必要があります。あるいは、Gradle ラッパーを使用する場合は、バージョン管理にチェックインされた Gradle ラッパースクリプトを適切に構成する必要があります。ステップ設定:Gradle ステップ設定のリストと...