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で始まるすべての XML ファイルを TEST- します。

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) を提供します。

なし。