VSBuild@1 - Tugas build v1 Visual Studio

Gunakan tugas ini untuk membangun dengan MSBuild dan mengatur properti versi Visual Studio. Pelajari selengkapnya tentang menginstal gambar Visual Studio di Azure.

Sintaks

# Visual Studio build v1
# Build with MSBuild and set the Visual Studio version property.
- task: VSBuild@1
  inputs:
    solution: '**\*.sln' # string. Required. Solution. Default: **\*.sln.
    #vsVersion: 'latest' # 'latest' | '17.0' | '16.0' | '15.0' | '14.0' | '12.0' | '11.0'. Visual Studio Version. Default: latest.
    #msbuildArgs: # string. MSBuild Arguments. 
    #platform: # string. Platform. 
    #configuration: # string. Configuration. 
    #clean: false # boolean. Clean. Default: false.
  # Advanced
    #maximumCpuCount: false # boolean. Build in Parallel. Default: false.
    #restoreNugetPackages: false # boolean. Restore NuGet Packages. Default: false.
    #msbuildArchitecture: 'x86' # 'x86' | 'x64'. MSBuild Architecture. Default: x86.
    #logProjectEvents: true # boolean. Record Project Details. Default: true.
    #createLogFile: false # boolean. Create Log File. Default: false.
    #logFileVerbosity: 'normal' # 'quiet' | 'minimal' | 'normal' | 'detailed' | 'diagnostic'. Optional. Use when createLogFile = true. Log File Verbosity. Default: normal.
    #enableDefaultLogger: true # boolean. Enable Default Logger. Default: true.
    #customVersion: # string. Custom Version.

Input

solution - Solusi
string. Wajib diisi. Nilai default: **\*.sln.

Menentukan solusi untuk tugas yang akan digunakan dalam proses build.

Jika Anda ingin membangun satu solusi, klik tombol ... dan tentukan solusinya.

Jika Anda ingin membangun beberapa solusi, tentukan kriteria pencarian. Anda dapat menggunakan kartubebas folder tunggal (*) dan kartubebas rekursif (**). Misalnya, **.sln mencari semua file .sln di semua subdirektori.

Pastikan solusi yang Anda tentukan diunduh oleh alur build ini. Pada tab Repositori:

• Jika Anda menggunakan TFVC, pastikan bahwa solusinya adalah anak dari salah satu pemetaan pada tab Repositori.
• Jika Anda menggunakan Git, pastikan bahwa proyek atau solusi berada di repositori Git Anda, dan di cabang yang Anda bangun.

Tip

• Anda juga dapat membuat file proyek MSBuild (.*proj).
• Jika Anda membuat file proyek MSBuild yang dikustomisasi, kami sarankan Anda menggunakan tugas MSBuild alih-alih tugas Visual Studio Build.

vsVersion - Versi Visual Studio
string. Nilai yang diizinkan: latest, 17.0 (Visual Studio 2022), 16.0 (Visual Studio 2019), 15.0 (Visual Studio 2017), 14.0 (Visual Studio 2015), 12.0 (Visual Studio 2013), 11.0 (Visual Studio 2012). Nilai default: latest.

Nilai input ini harus cocok dengan versi Visual Studio yang digunakan untuk membuat solusi Anda.

/p:VisualStudioVersion={numeric_visual_studio_version} Menambahkan argumen ke perintah MSBuild yang dijalankan oleh build. Misalnya, jika Anda menentukan Visual Studio 2015, /p:VisualStudioVersion=14.0 ditambahkan ke perintah MSBuild.

Azure Pipelines: Jika tim Anda ingin menggunakan Visual Studio dengan agen yang dihosting Microsoft, pilih windows-latest sebagai kumpulan build default Anda. Lihat Agen yang dihosting Microsoft.

msbuildArgs - Argumen MSBuild
string.

Meneruskan argumen tambahan ke MSBuild. Untuk sintaks, lihat Referensi Command-Line MSBuild.

platform - Platform
string.

Menentukan platform yang ingin Anda buat, seperti Win32, , x86x64, atau any cpu.

Tip

• Jika Anda menargetkan file proyek MSBuild (.*proj) alih-alih solusi, tentukan AnyCPU (tanpa spasi kosong).
• Deklarasikan variabel build seperti BuildPlatform pada tab Variabel (memilih Izinkan pada Waktu Antrean) dan referensikan di sini sebagai $(BuildPlatform). Dengan cara ini Anda dapat memodifikasi platform saat mengantre build dan mengaktifkan pembuatan beberapa konfigurasi.

configuration - Konfigurasi
string.

Menentukan konfigurasi yang ingin Anda buat, seperti debug atau release.

Tip

Deklarasikan variabel build seperti BuildConfiguration pada tab Variabel (memilih Izinkan pada Waktu Antrean) dan referensikan di sini sebagai $(BuildConfiguration). Dengan cara ini Anda dapat memodifikasi platform saat mengantre build dan mengaktifkan pembuatan beberapa konfigurasi.

clean - Bersih
boolean. Nilai default: false.

Jika diatur ke false, tugas membuat build inkremental. Pengaturan ini dapat mengurangi waktu build Anda, terutama jika basis kode Anda besar. Opsi ini tidak memiliki efek praktis kecuali Anda juga mengatur repositori Bersih ke false.

Jika diatur ke true, tugas membangun kembali semua kode dalam proyek kode. Ini setara dengan argumen MSBuild /target:clean .

maximumCpuCount - Bangun secara Paralel
boolean. Nilai default: false.

Opsional. Jika konfigurasi target MSBuild Anda kompatibel dengan pembuatan secara paralel, Anda dapat memeriksa input ini untuk meneruskan /m sakelar ke MSBuild (khusus Windows). Jika konfigurasi target Anda tidak kompatibel dengan pembuatan secara paralel, memeriksa opsi ini dapat menyebabkan build Anda mengakibatkan kesalahan penggunaan file, atau kegagalan build yang terputus-putus atau tidak konsisten.

restoreNugetPackages - Pulihkan Paket NuGet
boolean. Nilai default: false.

Input ini tidak digunakan lagi. Untuk memulihkan paket NuGet, tambahkan tugas Alat Penginstal NuGet sebelum build.

msbuildArchitecture - Arsitektur MSBuild
string. Nilai yang diizinkan: x86 (MSBuild x86), x64 (MSBuild x64). Nilai default: x86.

Pilihan. Memasok arsitektur (x86 atau x64) MSBuild untuk dijalankan.

Tip

Karena Visual Studio berjalan sebagai aplikasi 32-bit, Anda mungkin mengalami masalah saat build Anda diproses oleh agen build yang menjalankan Team Foundation Build Service versi 64-bit. Dengan memilih MSBuild x86, Anda dapat mengatasi masalah ini.

logProjectEvents - Catat Detail Proyek
boolean. Nilai default: true.

Pilihan. Merekam detail garis waktu untuk setiap proyek.

createLogFile - Buat File Log
boolean. Nilai default: false.

Pilihan. Membuat file log (khusus Windows).

logFileVerbosity - Log File Verbosity
string. Opsional. Gunakan saat createLogFile = true. Nilai yang diizinkan: quiet, minimal, normal, detailed, diagnostic. Nilai default: normal.

Menentukan tingkat verbositas dalam file log.

enableDefaultLogger - Aktifkan Pencatat Default
boolean. Nilai default: true.

Jika diatur ke true, mengaktifkan pencatat default untuk MSBuild.

customVersion - Versi Kustom
string.

Mengatur versi kustom Visual Studio. Contoh: 15.0, 16.0, 17.0. Versi Visual Studio yang diperlukan harus diinstal dalam sistem.

Azure Pipelines: Jika tim Anda ingin menggunakan Visual Studio 2022 dengan agen yang dihosting Microsoft, pilih windows-2022 sebagai kumpulan build default Anda. Untuk informasi selengkapnya, lihat Agen yang dihosting Microsoft.

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

Pelajari selengkapnya tentang menginstal gambar Visual Studio di Azure.

Penting

Tugas ini hanya didukung pada agen yang menjalankan Windows.

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build 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: msbuild, visualstudio
Kemampuan	Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	1.95.0 atau lebih tinggi
Kategori tugas	Build