Ant@1 - Ant v1 タスク
このタスクを使用して Apache Ant を使用してビルドします。
構文
# Ant v1
# Build with Apache Ant.
- task: Ant@1
inputs:
buildFile: 'build.xml' # string. Alias: antBuildFile. Required. Ant build file. Default: build.xml.
#options: # string. Options.
#targets: # string. Target(s).
# JUnit Test Results
#publishJUnitResults: true # boolean. Publish to Azure Pipelines. Default: true.
testResultsFiles: '**/TEST-*.xml' # string. Required when publishJUnitResults = true. Test results files. Default: **/TEST-*.xml.
#testRunTitle: # string. Optional. Use when publishJUnitResults = true. Test run title.
# Code Coverage
#codeCoverageToolOptions: 'None' # 'None' | 'Cobertura' | 'JaCoCo'. Alias: codeCoverageTool. Code coverage tool. Default: None.
codeCoverageClassFilesDirectories: '.' # string. Alias: classFilesDirectories. Required when codeCoverageTool != None. Class files directories. Default: ..
#codeCoverageClassFilter: # string. Alias: classFilter. Optional. Use when codeCoverageTool != None. Class inclusion/exclusion filters.
#codeCoverageSourceDirectories: # string. Alias: srcDirectories. Optional. Use when codeCoverageTool != None. Source files directories.
#codeCoverageFailIfEmpty: false # boolean. Alias: failIfCoverageEmpty. Optional. Use when codeCoverageTool != None. Fail when code coverage results are missing. Default: false.
# Advanced
#antHomeDirectory: # string. Alias: antHomeUserInputPath. Set ANT_HOME path.
javaHomeOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: javaHomeSelection. Required. Set JAVA_HOME by. Default: JDKVersion.
#jdkVersionOption: 'default' # 'default' | '1.11' | '1.10' | '1.9' | '1.8' | '1.7' | '1.6'. Alias: jdkVersion. Optional. Use when javaHomeSelection = JDKVersion. JDK version. Default: default.
#jdkUserInputDirectory: # string. Alias: jdkUserInputPath. Required when javaHomeSelection = Path. JDK path.
#jdkArchitectureOption: 'x64' # 'x86' | 'x64'. Alias: jdkArchitecture. Optional. Use when jdkVersion != default. JDK architecture. Default: x64.
入力
Ant ビルド ファイルのを buildFile - する
入力エイリアス: antBuildFile。
string. 必須。 既定値: build.xml.
リポジトリ ルートから Ant ビルド ファイルへの相対パス。
ビルド ファイルの詳細については、「Apache Antの使用」を参照してください。
options
-
オプションの
string.
Ant コマンド ラインに渡すオプションを提供します。 独自のプロパティ (-DmyProperty=myPropertyValueなど) を指定したり、組み込みの変数 (-DcollectionId=$(system.collectionId)など) を使用したりできます。 または、組み込み変数はビルド中に環境変数として既に設定されており、直接渡すことができます (たとえば、-DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%)。
Apache Ant の実行を参照してください。
targets
-
ターゲットの
string.
ビルドするターゲットのスペース区切りリスト (省略可能)。 指定しない場合は、default ターゲットが使用されます。
default ターゲットが定義されていない場合、Ant 1.6.0 以降はすべての最上位タスクをビルドします。
Apache Ant ターゲット の使用に関するを参照してください。
Azure Pipelinesへの発行の publishJUnitResults -
boolean. 既定値: true.
Ant ビルドによって生成された JUnit テスト結果を Azure Pipelines に発行するには、このオプションを選択します。
Test Results Files に一致する各テスト結果ファイルは、Azure Pipelines でテスト実行として発行されます。
testResultsFiles
-
テスト結果ファイル
string.
publishJUnitResults = trueする場合に必要です。 既定値: **/TEST-*.xml.
テスト結果ファイルのパス。 ワイルドカードを使用することができます。 詳細については、ファイル 一致パターンのリファレンスを参照してください。 たとえば、名前が TEST-で始まるすべての XML ファイルを **/TEST-*.xml します。
testRunTitle
-
テストの実行タイトル
string. 任意
publishJUnitResults = trueするときに使用します。
テスト実行の名前を指定します。
codeCoverageToolOptions
-
コード カバレッジ ツールの
入力エイリアス: codeCoverageTool。
string. 使用できる値: None、Cobertura、JaCoCo。 既定値: None.
コード カバレッジ ツールを選択します。
Microsoft がホストするエージェントを使用している場合は、ツールが設定されます。 オンプレミスの Windows エージェントを使用している場合は、エージェントが JaCoco または Cobertura 用に設定されていることを確認する必要があります。
- JaCoCo - jacocoant.jarが Ant インストールの lib フォルダーで使用できることを確認します。 JaCo Ant タスク の詳細を確認してください。
- Cobertura - 環境変数COBERTURA_HOMEが Cobertura .jar ファイルの場所を指していることを確認します。 Ant タスク Cobertura の詳細を確認します。
これらのツールのいずれかを選択すると、次の引数が表示されます。
codeCoverageClassFilesDirectories
-
クラス ファイルディレクトリ
入力エイリアス: classFilesDirectories。
string.
codeCoverageTool != Noneする場合に必要です。 既定値: ..
Ant ビルド ファイルからクラス ファイルとアーカイブ ファイル (.jar、.warなど) を含むディレクトリへの相対パスのコンマ区切りの一覧。 これらのディレクトリ内のクラス ファイルのコード カバレッジが報告されます。 (例: target/classes,target/testClasses)。
codeCoverageClassFilter
-
クラスの包含/除外フィルターの
入力エイリアス: classFilter。
string. 任意
codeCoverageTool != Noneするときに使用します。
コード カバレッジの収集に含める、またはクラスを除外するフィルターのコンマ区切りの一覧。 たとえば、 +:com.、 +:org.、 -:my.app*.。
ソース ファイル ディレクトリを codeCoverageSourceDirectories - する
入力エイリアス: srcDirectories。
string. 任意
codeCoverageTool != Noneするときに使用します。
Ant ビルド ファイルからソース コード ディレクトリへの相対パスのコンマ区切りの一覧。 コード カバレッジ レポートでは、これらを使用してソース コードが強調表示されます。 (例: src/java,src/Test)。
codeCoverageFailIfEmpty
-
コード カバレッジの結果が見つからない場合に失敗
入力エイリアス: failIfCoverageEmpty。
boolean. 任意
codeCoverageTool != Noneするときに使用します。 既定値: false.
コード カバレッジで発行する結果が生成されなかった場合、ビルドは失敗します。
antHomeDirectory
-
パス ANT_HOME設定する
入力エイリアス: antHomeUserInputPath。
string.
設定されている場合は、既存のANT_HOME環境変数を指定されたパスでオーバーライドします。
javaHomeOption
-
でJAVA_HOMEを設定する
入力エイリアス: javaHomeSelection。
string. 必須。 使用できる値: JDKVersion (JDK バージョン)、Path。 既定値: JDKVersion.
ビルド中に検出される JDK バージョンを選択するか、JDK パスを手動で入力して、JAVA_HOMEを設定します。
JDK バージョンの を
入力エイリアス: jdkVersion。
string. 任意
javaHomeSelection = JDKVersionするときに使用します。 使用できる値: default、1.11 (JDK 11)、1.10 (JDK 10 (サポート対象外))、1.9 (JDK 9 (サポート対象外))、1.8 (JDK 8)、1.7 (JDK 7)、1.6 (JDK 6 (サポート対象外))。 既定値: default.
選択した JDK バージョンへのパスの検出を試み、それに応じてJAVA_HOMEを設定します。
JDK パスを jdkUserInputDirectory - する
入力エイリアス: jdkUserInputPath。
string.
javaHomeSelection = Pathする場合に必要です。
JAVA_HOMEを指定したパスに設定します。
jdkArchitectureOption
-
JDK アーキテクチャの
入力エイリアス: jdkArchitecture。
string. 任意
jdkVersion != defaultするときに使用します。 使用できる値: x86、x64。 既定値: x64.
必要に応じて、JDK のアーキテクチャ (x86、x64) を提供します。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。
注釈
このタスクを使用して Apache Ant を使用してビルドします。