Ant görevi

Makale
11/29/2021
Okumak için 4 dakika

Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2015

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

Erişim

Yapı aracısının aşağıdaki özelliği olmalıdır:

Apache Ant

YAML kod parçacığı

# Ant
# Build with Apache Ant
- task: Ant@1
  inputs:
    #buildFile: 'build.xml' 
    #options: # Optional
    #targets: # Optional
    #publishJUnitResults: true 
    #testResultsFiles: '**/TEST-*.xml' # Required when publishJUnitResults == True
    #testRunTitle: # Optional
    #codeCoverageToolOptions: 'None' # Optional. Options: none, cobertura, jaCoCo
    #codeCoverageClassFilesDirectories: '.' # Required when codeCoverageToolOptions != None
    #codeCoverageClassFilter: # Optional. Comma-separated list of filters to include or exclude classes from collecting code coverage. For example: +:com.*,+:org.*,-:my.app*.*
    #codeCoverageSourceDirectories: # Optional
    #codeCoverageFailIfEmpty: false # Optional
    #antHomeDirectory: # Optional
    #javaHomeOption: 'JDKVersion' # Options: jDKVersion, path
    #jdkVersionOption: 'default' # Optional. Options: default, 1.11, 1.10, 1.9, 1.8, 1.7, 1.6
    #jdkUserInputDirectory: # Required when javaHomeOption == Path
    #jdkArchitectureOption: 'x64' # Optional. Options: x86, x64

Bağımsız değişkenler

Bağımsız Değişken	Description
`antBuildFile` Ant derleme dosyası	Istenir Depo kökünden ant derleme dosyasına göreli yol. Derleme dosyaları hakkında daha fazla bilgi için bkz. Using Apache Ant Varsayılan değer: build.xml Bağımsız değişken diğer adları: `buildFile`
`options` Seçenekler	Seçim Ant komut satırına geçirmek istediğiniz seçenekler. Kendi özelliklerinizi (örneğin, `-DmyProperty=myPropertyValue` ) sağlayabilir ve ayrıca yerleşik değişkenler (örneğin, `-DcollectionId=$(system.collectionId)` ) kullanabilirsiniz. Alternatif olarak, yerleşik değişkenler derleme sırasında zaten ortam değişkenleri olarak ayarlanmıştır ve doğrudan geçirilebilir (örneğin, `-DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%` ). Bkz. Apache Ant çalıştırma.
`targets` Hedefler	Seçim Bu derleme için ant 'in yürütülmesi için hedef (ler). Bkz. Apache Ant hedeflerini kullanma.

JUnit test sonuçları seçenekleri

Bağımsız Değişken	Description
`publishJUnitResults` Azure Pipelines yayımlama	Istenir Azure Pipelines veya şirket içi Team Foundation Server için Ant derlemesi tarafından üretilen junit test sonuçlarını yayımlamak için bu seçeneği belirleyin. Test Sonuçları dosyalarla eşleşen her test sonuç dosyası bir test çalıştırması olarak yayımlanır. Varsayılan değer: true
`testResultsFiles` Test Sonuçları dosyaları	Istenir Test sonuçları dosyaları yolu. Joker karakterler kullanılabilir. Örneğin, `/TEST-.xml` adı test-ile başlayan tüm XML dosyaları için. " Varsayılan değer: /TEST- .xml
`testRunTitle` Test çalıştırması başlığı	Seçim Bu derleme için JUnit test çalışması sonuçları için bir başlık atayın.

Kod kapsamı seçenekleri

Bağımsız Değişken	Description
`codeCoverageTool` Kod kapsamı aracı	Seçim Kullanmak istediğiniz kod kapsamı aracını seçin. 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ıkullanıyorsanız şunları seçin: JaCoCo, jacocoant. jar 'in, Ant yüklemesinin lib klasöründe kullanılabildiğinden emin olun. Bkz. Jacoco. Cobertura, Cobertura. jar dosyaları konumuna işaret eden COBERTURA_HOME bir ortam değişkeni ayarlayın. Bkz. Cobertura. Bu araçlardan birini seçtikten sonra aşağıdaki bağımsız değişkenler görüntülenir. Varsayılan değer: yok Bağımsız değişken diğer adları: `codeCoverageToolOptions`
`classFilesDirectories` Sınıf dosyaları dizinleri	Istenir Ant yapı dosyasından,. Class dosyalarınızı, arşiv dosyalarını (. jar ve. war gibi) içeren dizinlere, virgülle ayrılmış bir liste belirtin. Dizinlerde bulunan sınıf dosyaları için kod kapsamı raporlanır. Dizinler ve Arşivler, sınıf dosyaları için yinelemeli olarak aranır. Örneğin: hedef/sınıflar, hedef/testClasses. Varsayılan değer:. Bağımsız değişken diğer adları: `codeCoverageClassFilesDirectories`
`classFilter` Sınıf Içerme/dışlama filtreleri	Seçim Kod kapsamının toplanmasını kapsayan sınıfları dahil etmek veya hariç tutmak için bir virgülle ayrılmış filtre listesi belirtin. Örnek: `+:com.,+:org.,-:my.app.` Bağımsız değişken diğer adları: `codeCoverageClassFilter`
`srcDirectories` Kaynak dosyaları dizinleri	Seçim Ant yapı dosyasından kaynak dizinlerinize göreli yolların virgülle ayrılmış bir listesini belirtin. Kod kapsamı raporları, kaynak kodu vurgulamak için bu yolları kullanacaktır. Örneğin: src/Java, src/test. Bağımsız değişken diğer adları: `codeCoverageSourceDirectories`
`failIfCoverageEmpty` Kod kapsamı sonuçları eksik olduğunda başarısız olur	Seçim Kod kapsamı yayımlanacak sonuçları üretmediğinde derlemeyi devreder Varsayılan değer: false Bağımsız değişken diğer adları: `codeCoverageFailIfEmpty`

Gelişmiş seçenekler

Bağımsız Değişken	Description
`antHomeUserInputPath` ANT_HOME yolunu ayarla	Seçim Ayarlanırsa, varolan ANT_HOME ortam değişkenini verilen yol ile geçersiz kılar. Bağımsız değişken diğer adları: `antHomeDirectory`
`javaHomeSelection` JAVA_HOME ayarla	Istenir Derlemeler sırasında keşfedilecek bir JDK sürümü seçerek veya JDK yolunu el ile girerek JAVA_HOME ayarlar. Varsayılan değer: JDKVersion Bağımsız değişken diğer adları: `javaHomeOption`
`jdkVersion` JDK sürümü	Seçim Seçilen JDK sürümünün yolunu bulmaya çalışır ve JAVA_HOME uygun şekilde ayarlanır. Varsayılan değer: varsayılan Bağımsız değişken diğer adları: `jdkVersionOption`
`jdkUserInputPath` JDK yolu	Istenir Verilen yola JAVA_HOME ayarlar Bağımsız değişken diğer adları: `jdkUserInputDirectory`
`jdkArchitecture` JDK mimarisi	Seçim İsteğe bağlı olarak JDK 'nin mimarisini (x86, x64) sağlayın. Varsayılan değer: x64 Bağımsız değişken diğer adları: `jdkArchitectureOption`

Görev denetimi seçenekleri

Açık kaynak

Bu görev GitHubaçık kaynağıdır. Geribildirim ve katılımlar hoş geldiniz.

SSS

Bir aracıya ihtiyacım var mı?

Derlemenizi veya yayınını çalıştırmak için en az bir aracı gerekir.

Sorunlarımız var. Bunları nasıl gidererim?

Bkz. Derleme ve Sürüm Sorunlarını Giderme.

Varsayılan aracı havuzunu seçe değilim ve derlememi veya sürümümi kuyruğa ala bilmiyorum. Nasıl yaparım? düzeltebilir misiniz?

Bkz. Aracı havuzları.

My NuGet görev şu hatayla başarısız oluyor: "Hata: yerel sertifikayı verdiremiyor". Bunu nasıl düzeltebilirim?

Bu, güvenilen bir kök sertifika ekerek düzeltilmiştir. Ortam değişkenini derleme NODE_EXTRA_CA_CERTS=file aracınıza ekleyebilir veya görev değişkenini işlem NODE.EXTRA.CA.CERTS=file hattınıza ebilirsiniz. Bu Node.js hakkında daha fazla bilgi için bkz.Node.js belgeleri. İşlem hattınıza değişken ayarlama hakkında yönergeler için bkz. İşlem hattında değişken ayarlama.

Şirket içi TFS'yi kullanıyor ve bu özelliklerden bazılarını göremiyorum. Neden olmasın?

Bu özelliklerden bazıları yalnızca şirket Azure Pipelines şirket içinde kullanılamaz. TFS'nin en son sürümüne yükseltme yaptıysanız bazı özellikler şirket içinde kullanılabilir.