IBTestConsole コマンド インターフェース

ここでは Incredibuild for Unit Tests を NUnit フレームワークでアセンブリ レベルまたはテスト レベルの分散モードに設定・実行する方法をみていきます。NUnit の分散モードは IBTestConsole コマンドで指定します。

対応フレームワーク

IBTestConsole は次のフレームワークに対応しています。

• NUnit 2

• NUnit 3

• Google Test (Gtest)

実行したフレームワークは自動的に検出されます。ただし、特定のフレームワークを強制的に実行させたい場合は、/test=NUnit3 または/test=NUnit2 CLIコマンドラインオプションを使用します。

IBTestConsole の実行

IBTestConsole を設定し実行するには、まず、Incredibuild のインストールフォルダにあるIBTestConsole.exe ファイルを実行する必要があります。これはパラメーターに応じて、様々な動作モードで Incredibuild for Unit Tests を設定できるコンソール アプリケーションです。

IBTestConsoleは、次のような構文で使用します。

IBTestConsole [command] [options]

• /command: ユニットテスト フレームワークのオリジナルのコマンドです。フラグを追加できます (以下を参照)。

• [Options]: 詳しくは下表をご覧ください。

フレームワークの対応コマンド フラグ

Incredibuild for Unit Tests で利用できるフラグは次の通りです。フレームワークのバージョンによってフラグが異なります。各フラグの詳細については、Nunit 3 CLI リファレンス およびNunit2 CLI リファレンス を参照してください。

NUnit 2 の対応フラグ

• /run
• /runlist
• /include
• /exclude
• /result、/xml
• /noresult、/noxml
• /framework
• /timeout

NUnit 3 コマンド フラグ

• @FILE
• --testlist=FILE
• --where=EXPRESSION
• --config=NAME
• --framework=FRAMEWORK
• --timeout=MILLISECONDS
• --seed=SEED
• --skipnontestassemblies
• --result=SPEC
• --noresult
• --shadowcopy
• --noheader、--noh
• --params | p=PARAMETER
• --dispose-runners

GTest コマンド フラグ

• --gtest_output
• --gtest_filter

IBTestConsole オプション

IBTestConsole コマンドに追加できるオプションは次の通りです。

/help

/logfile=<filename>

/loglevel=<level>

/openmonitor

/targetdir=<path>

/testlevel=<level>

/test={framework}

リターンコード

IBTestConsole は次のリターン コードを返します。