Bagikan melalui

Ant@1 - Tugas Ant v1

Gunakan tugas ini untuk membangun dengan Apache Ant.

Sintaksis

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

Masukan

buildFile - file build Ant
Alias input: antBuildFile. string. Dibutuhkan. Nilai default: build.xml.

Jalur relatif dari akar repositori ke file build Ant.

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


Opsi options -
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.


Target targets -
string.

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

Lihat Menggunakan Target Apache Ant.


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

Pilih opsi ini untuk menerbitkan hasil pengujian JUnit yang dihasilkan oleh build Ant ke Azure Pipelines. Setiap file hasil pengujian yang cocok Test Results Files 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. Fakultatif. Gunakan saat publishJUnitResults = true.

Menyediakan nama untuk eksekusi pengujian.


alat cakupan kode codeCoverageToolOptions -
Alias input: codeCoverageTool. string. Nilai yang diizinkan: None, Cobertura, 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:


direktori file Kelas codeCoverageClassFilesDirectories -
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.


filter penyertaan/pengecualian Kelas codeCoverageClassFilter -
Alias input: classFilter. string. Fakultatif. Gunakan saat codeCoverageTool != None.

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


codeCoverageSourceDirectories - Direktori file sumber
Alias input: srcDirectories. string. Fakultatif. 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. Fakultatif. Gunakan saat codeCoverageTool != None. Nilai default: false.

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


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

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


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

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


versi JDK
Alias input: jdkVersion. string. Fakultatif. 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.


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

Mengatur JAVA_HOME ke jalur yang diberikan.


arsitektur JDK
Alias input: jdkArchitecture. string. Fakultatif. 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 tugasnya. Untuk informasi selengkapnya, lihat opsi Kontrol dan properti tugas umum.

Variabel output

Tidak ada.

Komentar

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 berikut menuntut untuk menjalankan pekerjaan yang menggunakan tugas ini: ant
Kemampuan Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan.
pembatasan Perintah Apapun
variabel yang Dapat Diatur Apapun
Versi agen 1.89.0 atau lebih tinggi
Kategori tugas Membangun
  • Last updated on