コマンド ラインからのコード分析の実行

MSBuild コマンドの構文

コマンド ラインからコード分析を実行するには、MSBuild コマンドを実行してコード分析のパラメーターを指定します。

msbuild [path]MyProject.cblproj [Code-analysis-parameters]

Code-analysis-parameters を指定しない場合、MSBuild は IDE で指定したコード分析の設定とプロジェクトのプロパティで指定したコード分析の設定を使用します。

MSBuild は、コマンド ラインでさまざまなスイッチおよびパラメーターをサポートしています。コード分析を使用するためのスイッチは/p で、次の構文を使用して各種プロパティを指定できます。

msbuild [path]MyProject.cblproj /p:property1=value1;property2=value2;...

または

msbuild [path]MyProject.cblproj /p:property1=value1 /p:property2=value2...

次に例を示します。

msbuild Myproject.cblproj /p:CodeAnalysisResultsAsErrors=true;RunMicroFocusCodeAnalysisAfterBuild=true;ActiveRulesets="Coding Standards"

MSBuild のコード分析プロパティ

Visual COBOL には、MSBuild の/p スイッチとともに使用する次のコード分析プロパティが用意されています。

RunMicroFocusCodeAnalysisAfterBuild=[false|true]

コマンド ラインから MSBuild を使用して実行したビルドの終わりにコード分析を実行するかどうかを指定します。

このプロパティを指定しない場合、MSBuild はプロジェクトのプロパティで設定したコード分析プロパティを使用します。コード分析がプロジェクトで有効になっていない場合、MSBuild はビルドのみを実行し、プロジェクトの分析は実行しません。

このプロパティを指定すると、IDE で設定したコード分析プロパティはすべて無視されます。これにより、IDE 内からのビルドの実行時にコードが構成される方法とは異なるコマンド ライン固有のコード分析ジョブを実行することができます。サポートされているオプションは次のとおりです。

true

MSBuild は、プロジェクトのプロパティでコード分析が有効になっているかどうかに関係なくビルドの終わりにコード分析を実行します。

false

MSBuild は、プロジェクトのプロパティでコード分析が有効になっているかどうかに関係なく、コード分析を実行せずにプロジェクトのビルドのみを行います。

ActiveRulesets=[Ruleset1;Ruleset2;…]

コマンド ラインからコード分析を実行するときに使用する製品とともにインストールされる、またはその製品にインポートされるルール セットを指定します。これにより、IDE のルール セットに対して有効なルールのみが実行されます。

次に例を示します。

/p:ActiveRulesets="Coding Standards;Within Entire Program"

CodeAnalysisResultsAsErrors=[false|true]

コード分析で警告またはエラーを生成するかどうかを指定します。デフォルト値は false です。

コード分析の実行時に Microsoft 独自の MSBuild スイッチおよびプロパティを使用できます。たとえば、次のように /maxcpucount スイッチを使用できます。

/maxcpucount:n

n を 1 を超える値に設定すると、n 個のプロジェクトのビルドおよび分析を並列で実行できます。各プロジェクトの分析結果は、他のプロジェクトの結果とともにコマンド ライン ウィンドウに表示されます。

注記: ビルド プロセスを最適化するために、並列プロジェクト ビルドの最大数が自動的にコンピューターの CPU 数に設定されます。最大数は 32 です。

/p スイッチとともに使用できる Microsoft プロパティの一部を次に示します。

TreatWarningsAsErrors=[false|true]

これをtrueに設定すると、コード分析時にレポートされた問題により、実行が失敗します。その後、メッセージ "Build Failed" が表示されます。

ContinueOnError=value

ここでは、value はWarnAndContinue、ErrorAndContinue またはErrorAndStop.

たとえば、これをErrorAndStop に設定すると、コード分析時に発生したエラー (内部エラーによる分析の失敗) またはエラーとしてレポートされた分析結果 (TreatWarningsAsErrorsを参照) により、実行が停止します。

コマンド ラインからの MSBuild の使用に関する詳細は、Visual Studio のヘルプを参照してください。