Jtest を実行する Ant タスクです。

パラメーター(ネストされた要素)

パラメーターの詳細

config

テスト コンフィギュレーション名です。次のタイプがサポートされています。

• ビルトイン テスト コンフィギュレーション 例: "builtin://Recommended Rules"
• DTP テスト コンフィギュレーション 例: "dtp://New Config"
• ユーザー定義テスト コンフィギュレーション 例: "user://Your Config"

ユーザー定義コンフィギュレーションは [INSTALL_DIR]/configs/user ディレクトリに *.properties ファイルとして格納する必要があります。

dataUpdate

ビルドから収集されたコンパイル データを手動で更新できます。

• サポートされるアクション: prepend, append, and set.
• サポートされるデータ型: classpath、bootpath、sourcepath、resourcepath、binarypath、sourcecode (set のみ)、encoding (set のみ)
• スコープ: 収集されたすべてのプロジェクト データが更新されます。

コンパイル データ モデルの詳細については「コンパイル データの手動カスタマイズ」および「コンパイル データ モデル」を参照してください。

exclude

選択されたリソースのうち、解析対象から除外するファイルまたはパッケージのサブセットを指定します。修飾名を指定できます。複数のファイル名に一致する glob パターンを使用できます。

例 1: 次のパターンは、com.parasoft パッケージおよびそのサブパッケージのすべてのファイルを除外します: /com/parasoft/**

例 2: 次のパターンは、com.parasoft.jtest パッケージのすべてのファイルを除外しますが、サブパッケージのファイルは除外しません: /com/parasoft/jtest/*

例 3: 次のパターンは、指定されたディレクトリおよびそのサブディレクトリにあるすべてのファイルを除外します: path:/home/user/project/src/test/java/**

include

選択された リソースの中から、解析対象に含めるファイルまたはパッケージのサブセットを指定します。複数のファイル名に一致する glob パターンを使用できます。

例 1: 次のパターンは、com.parasoft パッケージおよびそのサブパッケージのすべてのファイルを含めます: /com/parasoft/**

例 2: 次のパターンは、com.parasoft.jtest パッケージのすべてのファイルを含めますが、サブパッケージのファイルは含めません: /com/parasoft/jtest/*

例 3: 次のパターンは、指定されたディレクトリおよびそのサブディレクトリにあるすべてのファイルを含めます: path:/home/user/project/src/test/java/**

resource

解析の入力スコープを指定します。リソースが指定されていない場合、ビルドされたすべてのプロジェクトのリソースが解析されます。

次のパターンを使用してパスを指定します: ${ProjectName}/my/src/dir/my/package/file.java"以下のワイルドカードを使用できます。

• ? - 1 文字に一致します。
• * - (パスの区切り文字 / を除く) 0 個以上の文字に一致します 。
• ** - パス区切り文字 / を含むパス全体に一致します。

settings

カスタム設定が保存された *.properties ファイルへの絶対パスまたは相対パスです。

パラメーター

パラメーターの詳細

coverage

デフォルト値:

<jtest> 
  <coverage> 
    <skip>false</skip> 
    <includes> 
      <include>**</include> 
    </includes> 
    <excludes>< excludes> 
    <testIncludes> 
      <testInclude>**/*Test.class</testInclude> 
    </testIncludes> 
    <testExcludes><testExcludes> 
  </coverage> 
 </jtest> 

metadataLocation

デフォルト値: ${basedir}/parasoft/jtest-instrument/metadata.data

property

利用可能なオプションの一覧は「カバレッジ エージェントの構成」を参照してください。 -javaagent への引数として指定されたプロパティは、agent.properties ファイルで設定されたプロパティを上書きします。

runtimeDataLocation

デフォルト値: ${basedir}/parasoft/jtest-instrument/runtimedata.data

ビルドをスキャンして Jtest Java エージェントの設定を生成し、monitorLocation パラメーターで指定された場所にモニター パッケージを作成します。

モニターパッケージには、以下が含まれます。

• static_coverage.xml - 静的カバレッジ データを格納したファイル
• agent.jar - Jtest Java カバレッジ エージェントの jar アーカイブ
• agent.properties - ビルド処理中に生成されたスコープ パラメーターおよびその他の属性を含むエージェント設定ファイル
• agent.sh/agent.bat - アプリケーションのモニタリングに必要な Jtest Java エージェント VM 引数を生成するスクリプト
• opentelemetry-javaagent.jar および jtest-otel-ext.jar - マルチユーザー カバレッジ モードで使用されます。元の OpenTelemetry Java エージェントとそれに対応する Jtest 拡張です。この拡張は、収集されたカバレッジを特定のユーザーに割り当てるのに必要なデータを収集します。これらのファイルは、<INSTALL_DIR>/integration/coverage ディレクトリからコピーされます。

属性

パラメーターの詳細

exclude

選択されたリソースのうち、解析対象から除外するファイルまたはパッケージのサブセットを指定します。修飾名を指定できます。複数のファイル名に一致する glob パターンを使用できます。

例 1: 次のパターンは、com.parasoft パッケージおよびそのサブパッケージのすべてのファイルを除外します: /com/parasoft/**

例 2: 次のパターンは、com.parasoft.jtest パッケージのすべてのファイルを除外しますが、サブパッケージのファイルは除外しません: /com/parasoft/jtest/*

例 3: 次のパターンは、指定されたディレクトリおよびそのサブディレクトリにあるすべてのファイルを除外します: path:/home/user/project/src/test/java/**

include

選択された リソースの中から、解析対象に含めるファイルまたはパッケージのサブセットを指定します。複数のファイル名に一致する glob パターンを使用できます。

例 1: 次のパターンは、com.parasoft パッケージおよびそのサブパッケージのすべてのファイルを含めます: /com/parasoft/**

例 2: 次のパターンは、com.parasoft.jtest パッケージのすべてのファイルを含めますが、サブパッケージのファイルは含めません: /com/parasoft/jtest/*

例 3: 次のパターンは、指定されたディレクトリおよびそのサブディレクトリにあるすべてのファイルを含めます: path:/home/user/project/src/test/java/**

resource

解析の入力スコープを指定します。リソースが指定されていない場合、ビルドされたすべてのプロジェクトのリソースが解析されます。

次のパターンを使用してパスを指定します: ${ProjectName}/my/src/dir/my/package/file.java"以下のワイルドカードを使用できます。

• ? - 1 文字に一致します。
• * - (パスの区切り文字 / を除く) 0 個以上の文字に一致します 。
• ** - パス区切り文字 / を含むパス全体に一致します。

settings

カスタム設定が保存された *.properties ファイルへの絶対パスまたは相対パスです。