Ant@1 - Ant v1 görevi

2025-06-24

Apache Ant ile derlemek için bu görevi kullanın.

Sözdizimi

# 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.

Girişler

buildFile - Ant derleme dosyası
Giriş diğer adı: antBuildFile. string. Gerekli. Varsayılan değer: build.xml.

Depo kökünden Ant derleme dosyasına göreli yol.

Derleme dosyaları hakkında daha fazla bilgi için bkz. Apache Antkullanma .

options - Seçenekleri
string.

Ant komut satırına geçirmek için seçenekler sağlar. Kendi özelliklerinizi (örneğin, -DmyProperty=myPropertyValue) sağlayabilir ve yerleşik değişkenleri de kullanabilirsiniz (örneğin, -DcollectionId=$(system.collectionId)). Alternatif olarak, yerleşik değişkenler derleme sırasında zaten ortam değişkenleri olarak ayarlanır ve doğrudan geçirilebilir (örneğin, -DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%).

Bkz. Apache Ant çalıştırma.

targets - Hedefleri
string.

İsteğe bağlı, boşlukla ayrılmış bir hedef listesi. Belirtilmezse, default hedefi kullanılır. default hedef tanımlanmadıysa Ant 1.6.0 ve üzeri tüm üst düzey görevleri oluşturur.

Bkz. Apache Ant Hedeflerini Kullanma.

publishJUnitResults - Azure Pipelines'da yayımlama
boolean. Varsayılan değer: true.

Ant derlemesi tarafından üretilen JUnit test sonuçlarını Azure Pipelines'a yayımlamak için bu seçeneği belirleyin. Test Results Files eşleşen her test sonuçları dosyası Azure Pipelines'da bir test çalıştırması olarak yayımlanır.

Test sonuçları dosyalarınıtestResultsFiles -
string. publishJUnitResults = truegerekir. Varsayılan değer: **/TEST-*.xml.

Test sonuçları dosya yolu. Joker karakterler kullanılabilir. Daha fazla bilgi için bkz. dosya eşleştirme desenleri başvurusu. Örneğin, adı **/TEST-*.xmlile başlayan tüm XML dosyaları için TEST-.

çalıştırma başlığını test
string. Opsiyonel. publishJUnitResults = trueolduğunda kullanın.

Test çalıştırması için bir ad sağlar.

codeCoverageToolOptions - Kod kapsamı aracı
Giriş diğer adı: codeCoverageTool. string. İzin verilen değerler: None, Cobertura, JaCoCo. Varsayılan değer: None.

Kod kapsamı aracını seçer.

Microsoft tarafından barındırılan aracılarıkullanıyorsanız, araçlar sizin için ayarlanır. şirket içi Windows aracısınıkullanıyorsanız aracının JaCoco veya Cobertura için ayarlandığından emin olmanız gerekir.

JaCoCo - jacocoant.jar Ant yüklemesinin lib klasöründe kullanılabilir olduğundan emin olun. JaCoCo Ant görevleri hakkında daha fazla bilgi edinin.
Cobertura - bir ortam değişkeninin COBERTURA_HOME Cobertura .jar dosyalarının konumunu işaret etmesini sağlayın. Ant görevleriyle coberturahakkında daha fazla bilgi edinin.

Bu araçlardan birini seçtikten sonra aşağıdaki bağımsız değişkenler görüntülenir:

codeCoverageClassFilesDirectories - Sınıf dosyaları dizinleri
Giriş diğer adı: classFilesDirectories. string. codeCoverageTool != Nonegerekir. Varsayılan değer: ..

Ant derleme dosyasından sınıf dosyalarını ve arşiv dosyalarını (.jar, .warvb.) içeren dizinlere giden göreli yolların virgülle ayrılmış listesi. Bu dizinlerdeki sınıf dosyaları için kod kapsamı bildirilir. Örneğin: target/classes,target/testClasses.

sınıf ekleme/dışlama filtrelericodeCoverageClassFilter -
Giriş diğer adı: classFilter. string. Opsiyonel. codeCoverageTool != Noneolduğunda kullanın.

Sınıfların kod kapsamını toplamasını içerecek veya hariç tutacak filtrelerin virgülle ayrılmış listesi. Örneğin: +:com., +:org., -:my.app*..

kaynak dosya dizinlerinicodeCoverageSourceDirectories -
Giriş diğer adı: srcDirectories. string. Opsiyonel. codeCoverageTool != Noneolduğunda kullanın.

Ant derleme dosyasından kaynak kod dizinlerine göreli yolların virgülle ayrılmış listesi. Kod kapsamı raporları, kaynak kodu vurgulamak için bunları kullanır. Örneğin: src/java,src/Test.

codeCoverageFailIfEmpty - Kod kapsamı sonuçları eksik olduğunda başarısız
Giriş diğer adı: failIfCoverageEmpty. boolean. Opsiyonel. codeCoverageTool != Noneolduğunda kullanın. Varsayılan değer: false.

Kod kapsamı yayımlamak için herhangi bir sonuç üretmediyse derleme başarısız olur.

antHomeDirectory - ANT_HOME yolu ayarla
Giriş diğer adı: antHomeUserInputPath. string.

Ayarlanırsa, mevcut ANT_HOME ortam değişkenlerini verilen yolla geçersiz kılar.

javaHomeOption - göre JAVA_HOME ayarlama
Giriş diğer adı: javaHomeSelection. string. Gerekli. İzin verilen değerler: JDKVersion (JDK Sürümü), Path. Varsayılan değer: JDKVersion.

derlemeler sırasında keşfedilecek bir JDK sürümü seçerek veya el ile JDK yolu girerek JAVA_HOME ayarlar.

JDK sürüm
Giriş diğer adı: jdkVersion. string. Opsiyonel. javaHomeSelection = JDKVersionolduğunda kullanın. İzin verilen değerler: default, 1.11 (JDK 11), 1.10 (JDK 10 (destek dışı)), 1.9 (JDK 9 (destek dışı)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (destek dışı)). Varsayılan değer: default.

Seçili JDK sürümünün yolunu bulmayı dener ve JAVA_HOME buna göre ayarlar.

JDK yolujdkUserInputDirectory -
Giriş diğer adı: jdkUserInputPath. string. javaHomeSelection = Pathgerekir.

JAVA_HOME verilen yola ayarlar.

jdkArchitectureOption - JDK mimarisi
Giriş diğer adı: jdkArchitecture. string. Opsiyonel. jdkVersion != defaultolduğunda kullanın. İzin verilen değerler: x86, x64. Varsayılan değer: x64.

İsteğe bağlı olarak JDK mimarisini (x86, x64) sağlar.

Görev denetimi seçenekleri

Tüm görevlerin, görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz. Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Yok.

Açıklamalar

Apache Ant ile derlemek için bu görevi kullanın.

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır	Agent, DeploymentGroup
Talepleri	Şirket içinde barındırılan aracılar, bu görevi kullanan işleri çalıştırmak için talep aşağıdakilerle eşleşen özelliklere sahip olmalıdır: ant
Özellikleri	Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları	Herhangi bir
Ayarlanabilir değişkenleri	Herhangi bir
Aracı sürümü	1.89.0 veya üzeri
Görev kategorisi	İnşa et