MSBuild との統合

dotTEST は、MSBuild のビルドスクリプト環境で簡単に dotTEST を実行できるよう、MSBuild との統合をサポートしています。MSBuild スクリプトとの統合は、次のカスタムタスクによって実現されます。

Parasoft.Dottest.MSBuild.Tasks.dll

タスクをデプロイした後、MSBuild スクリプトで次のコードを使用します。

<Import Project="$(MSBuildExtensionsPath)\Parasoft\Parasoft.Dottest.targets"/> 

	<Target Name="Demo"> 
		<Dottest 
			Configuration="builtin://Demo" 
			Solutions="C:\Devel\FooSolution\FooSolution.sln" 
 			Report="C:\Devel\Report" 
 			Out="C:\Devel\Out.txt" /> 
	</Target>

ターゲットファイル

MSBuild スクリプトにターゲットファイルをインポートする必要があります。deploy.exe を使用する場合、次のインポート文を使用できます。

<Import Project="$(MSBuildExtensionsPath)\Parasoft\Parasoft.Dottest.targets"/>

または、インストールディレクトリから直接ターゲットをインポートできます。

<Import 
Project="[INSTALL_DIR]\integration\MSBuild\Parasoft.Dottest.targets\Parasoft.Dottest.targets 
"/>

1 台のマシンで複数の dotTEST を実行している場合、インストールディレクトリから直接ターゲットをインポートできます。

MSBuild タスク

dotTEST を実行するには、ビルドファイルで <Dottest> タスクを使用します。以下の引数がサポートされています。

Configuration: 解析に使用するコンフィギュレーションを定義します。「テストコンフィギュレーションの設定」を参照してください。
Solutions: 解析対象のソリューションを定義します。「静的解析の実行」を参照してください。
Projects: 解析対象のプロジェクトを定義します。「静的解析の実行」を参照してください。
Websites : 解析対象の Web サイトを定義します。「静的解析の実行」を参照してください。
Resources: 解析対象のリソースを定義します。「テストスコープの設定」を参照してください。
Report: レポートのパスを定義します。「結果の参照」を参照してください。
Settings: 設定ファイルのパスを定義します。「設定の概要」を参照してください。
NoBuild: テスト対象ソリューションまたはプロジェクトのビルドを無効にします。
SolutionConfig: ソリューションのビルドアーキテクチャです。「ソリューションおよびプロジェクトのビルド」を参照してください。
TargetPlatform: ソリューションのビルドプラットフォームです。「ソリューションおよびプロジェクトのビルド」を参照してください。
Out: コンソール出力を保存する場所のパスです。
DottestPath: dottestcli.exe ファイルのパスです。このオプションを使用すると、自動検出された dottestcli.exe のパスを上書きできます。1 台のマシンに複数の Static Analysis Engine for .NET がインストールされているケースに対処するために使用できます。

NAnt との統合

dotTEST は、NAnt のビルドスクリプト環境で簡単に Static Analysis Engine for .NETを実行できるよう、NAnt との統合をサポートしています。NAnt にタスクをデプロイした後、NAnt スクリプトで次のコードを使用します。

<target name="analyze">  
	<dottest 
		config="builtin://Demo" 
		report="C:\Devel\Report" 
		out="C:\Devel\Out.txt"> 
		<solutions> 
			<include name ="C:\Devel\FooSolution\FooSolution.sln"> 
		</solutions> 
	</dottest> 
</target>

NAnt タスクライブラリのロード

NAnt スクリプトとの統合は、次のカスタム NAnt タスクによって実現されます。

Parasoft.Dottest.NAnt.Tasks.dll.

NAnt スクリプトが dotTEST タスクを検出できるよう、NAnt.exe と同じディレクトリにこのライブラリを置く必要があります。または、<loadtasks> を使用します。<loadtasks> は 1 台のマシンで複数の dotTEST を実行している場合に便利です。

<project name="sampleProject" default="test"> 
	<target name="test"> 
		<loadtasks> 
			<fileset> 
				<include 
name="[INSTALL_DIR]\integration\NAnt\Parasoft.Dottest.NAnt.Tasks.dll" /> 
			</fileset> 
		</loadtasks> 
	</target>
</project>

NAnt タスクでサポートされる引数

config: 解析に使用するコンフィギュレーションを定義します。｢テストコンフィギュレーションの設定」を参照してください。
solutions: 解析対象のソリューションを定義します。複数のソリューションを解析する場合、ANT 形式のワイルドカードを使用し、セミコロンで区切られたリストを指定できます。
```
<dottest config="builtin://Demo" solutions="C:\Devel\FooSolution\FooSolution.sln;C:\Devel\Bar\**\*.sln" />
```
<solutions> 要素の内側に ANT 形式のワイルドカードを使用した <include> 要素をネストすることもできます。
```
<dottest config="builtin://Demo" > 
	<solutions> 
		<include name="C:\Devel\FooSolution\FooSolution.sln"> 
		<include name="C:\Devel\Bar\**\*.sln"> 
	</solutions> 
</dottest>
```
｢静的解析の実行｣を参照してください。

projects: 解析対象のプロジェクトを定義します。複数のプロジェクトを解析する場合、ANT 形式のワイルドカードを使用し、セミコロンで区切られたリストを指定できます。
```
<dottest config="builtin://Demo" projects="C:\Devel\FooProjects\Qux\Qux.csproj;C:\Devel\BarProjects\**\*.csproj" /> 
```
<projects> 要素の内側に ANT 形式のワイルドカードを使用した <include> 要素をネストすることもできます。
```
<dottest config="builtin://Demo" > 
	<projects> 
		<include name="C:\Devel\Foo\Qux\Qux.csproj"> 
		<include name="C:\Devel\Bar\**\*.csproj"> 
	</projects> 
</dottest>
```
｢静的解析の実行｣を参照してください。
websites : 析対象の Web サイトを定義します。複数のWeb サイトを解析する場合、ANT 形式のワイルドカードを使用し、セミコロンで区切られたリストを指定できます。
```
<dottest config="builtin://Demo" websites="C:\Devel\Foo\WebSite;C:\Devel\Bar\*.WebSite" /> 
```
<websites> 要素の内側に ANT 形式のワイルドカードを使用した <include> 要素をネストすることもできます。
```
<dottest config="builtin://Demo" > 
	<websites> 
		<include name="C:\Foo\WebSite"> 
		<include name="C:\Bar\*.WebSite"> 
	</websites>
</dottest>  
```
｢静的解析の実行｣を参照してください。
resources: 解析対象のリソースを定義します。複数のリソースへのパスはセミコロンで区切ります。
```
<dottest config="builtin://Demo" resources="Foo/Bar/Baz;Foo/Qux/Garply" > 
```
<resources> 要素の内側にパスを指す <res> 要素をネストすることもできます。
```
 <dottest config="builtin://Demo"> 
	... 
	<resources> 
		<res name="Foo/Bar/Baz" /> 
		<res name="Foo/Qux/Garply" /> 
	</resources> 
</dottest> 
```
｢テストスコープの設定｣を参照してください。
report: レポートのパスを定義します。
```
<dottest 
	config="builtin://Demo" 
	report="C:\Foo\Report" > 
	... 
</dottest>
```
｢結果の参照｣を参照してください。
settings: 設定ファイルのパスを指定します。
```
<dottest
	config="builtin://Demo" 
	settings="C:\Foo\settings.properties" >
</dottest>
```
｢設定の概要｣を参照してください。
nobuild: テスト対象ソリューションまたはプロジェクトのビルドを無効にします。
```
<dottest 
	config="builtin://Demo" 
	nobuild="true" >
	. . . 
</dottest>
```
solutionConfig: ソリューションのビルドアーキテクチャです。｢ソリューションおよびプロジェクトのビルド｣を参照してください。
targetPlatform: ソリューションのビルドプラットフォームです。「ソリューションおよびプロジェクトのビルド」を参照してください。
Out: コンソール出力を保存する場所のパスです。
DottestPath: dottestcli.exe ファイルのパスです。このオプションを使用すると、自動検出された dottestcli.exe のパスを上書きできます。1 台のマシンに複数の dotTEST がインストールされているケースに対処するために使用できます。

Page tree

Integrating with Build Systems