Ant@1 - Ant v1 görevi

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

Syntax

# 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. Gereklidir. 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 Ant kullanma.

options - Seçenekler
string.

Ant komut satırına geçirmek için seçenekler sağlar. Kendi özelliklerinizi (örneğin, -DmyProperty=myPropertyValue) sağlayabilir ve ayrıca yerleşik değişkenleri (örneğin, -DcollectionId=$(system.collectionId)) kullanabilirsiniz. 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 - Hedefler
string.

İsteğe bağlı, boşlukla ayrılmış bir hedef listesi. Belirtilmezse hedef default 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'da yayımlamak için bu seçeneği belirleyin. Her test sonuçları dosya eşleştirmesi Test Results Files Azure Pipelines'da bir test çalıştırması olarak yayımlanır.

testResultsFiles - Test sonuçları dosyaları
string. olduğunda publishJUnitResults = truegereklidir. 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, **/TEST-*.xml adı ile TEST-başlayan tüm XML dosyaları için.

testRunTitle - Test çalıştırması başlığı
string. İsteğe bağlı. when publishJUnitResults = truekullanı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 - ant yüklemesinin lib klasöründe jacocoant.jar kullanılabilir olduğundan emin olun. JaCoCo Ant görevleri hakkında daha fazla bilgi edinin.
• Cobertura - Bir ortam değişkeninin cobertura .jar dosyalarının konumunu işaret COBERTURA_HOME emin olun. Ant görevleriyle Cobertura hakkı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. olduğunda codeCoverageTool != Nonegereklidir. Varsayılan değer: ..

Ant derleme dosyasından sınıf dosyalarını ve arşiv dosyalarını (.jar, .warvb.) içeren dizinlere 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.

codeCoverageClassFilter - Sınıf ekleme/dışlama filtreleri
Giriş diğer adı: classFilter. string. İsteğe bağlı. when codeCoverageTool != Nonekullanın.

Sınıfları dahil etmek veya kod kapsamını toplamaktan dışlamak için virgülle ayrılmış filtre listesi. Örneğin: +:com., +:org., -:my.app*..

codeCoverageSourceDirectories - Kaynak dosya dizinleri
Giriş diğer adı: srcDirectories. string. İsteğe bağlı. when codeCoverageTool != Nonekullanı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 olur
Giriş diğer adı: failIfCoverageEmpty. boolean. İsteğe bağlı. when codeCoverageTool != Nonekullanı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 yolunu ayarlama
Giriş diğer adı: antHomeUserInputPath. string.

Ayarlanırsa, belirtilen yolla var olan ANT_HOME ortam değişkenlerini geçersiz kılar.

javaHomeOption - JAVA_HOME ayarlama ölçütü:
Giriş diğer adı: javaHomeSelection. string. Gereklidir. İ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ünü seçerek veya JDK yolunu el ile girerek JAVA_HOME ayarlar.

jdkVersionOption - JDK sürümü
Giriş diğer adı: jdkVersion. string. İsteğe bağlı. when javaHomeSelection = JDKVersionkullanı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.

jdkUserInputDirectory - JDK yolu
Giriş diğer adı: jdkUserInputPath. string. olduğunda javaHomeSelection = Pathgereklidir.

Verilen yola JAVA_HOME ayarlar.

jdkArchitectureOption - JDK mimarisi
Giriş diğer adı: jdkArchitecture. string. İsteğe bağlı. olduğunda jdkVersion != defaultkullanı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 denetim seçenekleri

Tüm görevlerde 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ıştırılır	Agent, DeploymentGroup
Talep	Şirket içinde barındırılan aracılar, bu görevi kullanan işleri çalıştırmak için aşağıdaki taleplerle eşleşen özelliklere sahip olmalıdır: ant
Özellikler	Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları	Herhangi biri
Ayarlanabilir değişkenler	Herhangi biri
Aracı sürümü	1.89.0 veya üzeri
Görev kategorisi	Oluşturma