Ant@1 - Tugas Ant v1

Gunakan tugas ini untuk membangun dengan Apache Ant.

Sintaks

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

Input

buildFile - File build Ant
Alias input: antBuildFile. string. Wajib diisi. Nilai default: build.xml.

Jalur relatif dari akar repositori ke file build Ant.

Untuk informasi selengkapnya tentang file build, lihat Menggunakan Apache Ant.

options - Pilihan
string.

Menyediakan opsi untuk meneruskan ke baris perintah Ant. Anda dapat menyediakan properti Anda sendiri (misalnya, -DmyProperty=myPropertyValue) dan juga menggunakan variabel bawaan (misalnya, -DcollectionId=$(system.collectionId)). Atau, variabel bawaan sudah ditetapkan sebagai variabel lingkungan selama build dan dapat diteruskan secara langsung (misalnya, -DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%).

Lihat Menjalankan Apache Ant.

targets - Target
string.

Daftar target opsional yang dipisahkan spasi untuk dibangun. Jika tidak ditentukan, default target akan digunakan. Jika tidak ada default target yang ditentukan, Ant 1.6.0 dan yang lebih baru akan membangun semua tugas tingkat atas.

Lihat Menggunakan Target Apache Ant.

publishJUnitResults - Menerbitkan ke Azure Pipelines
boolean. Nilai default: true.

Pilih opsi ini untuk menerbitkan hasil pengujian JUnit yang dihasilkan oleh build Ant ke Azure Pipelines. Setiap pencocokan Test Results Files file hasil pengujian akan diterbitkan sebagai uji coba di Azure Pipelines.

testResultsFiles - File hasil pengujian
string. Diperlukan saat publishJUnitResults = true. Nilai default: **/TEST-*.xml.

Jalur file hasil pengujian. Wildcard dapat digunakan. Untuk informasi selengkapnya, lihat referensi pola pencocokan file. Misalnya, **/TEST-*.xml untuk semua file XML yang namanya dimulai dengan TEST-.

testRunTitle - Judul uji coba
string. Opsional. Gunakan saat publishJUnitResults = true.

Menyediakan nama untuk eksekusi pengujian.

codeCoverageToolOptions - Alat cakupan kode
Alias input: codeCoverageTool. string. Nilai yang diizinkan: None, Cobertura, dan JaCoCo. Nilai default: None.

Memilih alat cakupan kode.

Jika Anda menggunakan agen yang dihosting Microsoft, maka alat disiapkan untuk Anda. Jika Anda menggunakan agen Windows lokal, Anda harus memastikan agen disiapkan untuk JaCoco atau Cobertura.

• JaCoCo - pastikan bahwa jacocoant.jar tersedia di folder lib penginstalan Ant. Pelajari selengkapnya tentang tugas JaCoCo Ant.
• Cobertura - pastikan bahwa variabel lingkungan COBERTURA_HOME menunjuk ke lokasi file Cobertura .jar. Pelajari selengkapnya tentang Cobertura dengan tugas Ant.

Setelah Anda memilih salah satu alat ini, argumen berikut muncul:

codeCoverageClassFilesDirectories - Direktori file kelas
Alias input: classFilesDirectories. string. Diperlukan saat codeCoverageTool != None. Nilai default: ..

Daftar jalur relatif yang dipisahkan koma dari file build Ant ke direktori yang berisi file kelas dan file arsip (.jar, .war, dll.). Cakupan kode dilaporkan untuk file kelas di direktori ini. Misalnya: target/classes,target/testClasses.

codeCoverageClassFilter - Filter penyertaan/pengecualian kelas
Alias input: classFilter. string. Opsional. Gunakan saat codeCoverageTool != None.

Daftar filter yang dipisahkan koma untuk menyertakan atau mengecualikan kelas dari pengumpulan cakupan kode. Contoh: +:com., +:org., -:my.app*..

codeCoverageSourceDirectories - Direktori file sumber
Alias input: srcDirectories. string. Opsional. Gunakan saat codeCoverageTool != None.

Daftar jalur relatif yang dipisahkan koma dari file build Ant ke direktori kode sumber. Laporan cakupan kode akan menggunakannya untuk menyoroti kode sumber. Misalnya: src/java,src/Test.

codeCoverageFailIfEmpty - Gagal saat hasil cakupan kode hilang
Alias input: failIfCoverageEmpty. boolean. Opsional. Gunakan saat codeCoverageTool != None. Nilai default: false.

Gagal membangun jika cakupan kode tidak menghasilkan hasil apa pun untuk dipublikasikan.

antHomeDirectory - Mengatur jalur ANT_HOME
Alias input: antHomeUserInputPath. string.

Jika diatur, mengambil alih variabel lingkungan ANT_HOME yang ada dengan jalur yang diberikan.

javaHomeOption - Atur JAVA_HOME menurut
Alias input: javaHomeSelection. string. Wajib diisi. Nilai yang diizinkan: JDKVersion (Versi JDK), Path. Nilai default: JDKVersion.

Mengatur JAVA_HOME baik dengan memilih versi JDK yang akan ditemukan selama build atau dengan memasukkan jalur JDK secara manual.

jdkVersionOption - Versi JDK
Alias input: jdkVersion. string. Pilihan. Gunakan saat javaHomeSelection = JDKVersion. Nilai yang diizinkan: default, 1.11 (JDK 11), 1.10 (JDK 10 (di luar dukungan)), 1.9 (JDK 9 (di luar dukungan)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (di luar dukungan)). Nilai default: default.

Mencoba menemukan jalur ke versi JDK yang dipilih dan mengatur JAVA_HOME yang sesuai.

jdkUserInputDirectory - Jalur JDK
Alias input: jdkUserInputPath. string. Diperlukan saat javaHomeSelection = Path.

Mengatur JAVA_HOME ke jalur yang diberikan.

jdkArchitectureOption - Arsitektur JDK
Alias input: jdkArchitecture. string. Pilihan. Gunakan saat jdkVersion != default. Nilai yang diizinkan: x86, x64. Nilai default: x64.

Secara opsional memasok arsitektur (x86, x64) dari JDK.

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugas mereka. Untuk informasi selengkapnya, lihat Opsi kontrol dan properti tugas umum.

Variabel output

Tidak ada.

Keterangan

Gunakan tugas ini untuk membangun dengan Apache Ant.

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Agen yang dihost sendiri harus memiliki kemampuan yang cocok dengan tuntutan berikut untuk menjalankan pekerjaan yang menggunakan tugas ini: ant
Kemampuan	Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	1.89.0 atau lebih tinggi
Kategori tugas	Build