VSBuild@1 - Visual Studio derleme v1 görevi
MSBuild ile derlemek ve Visual Studio sürüm özelliğini ayarlamak için bu görevi kullanın. Azure'da Visual Studio görüntülerini yükleme hakkında daha fazla bilgi edinin.
Syntax
# 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.
# 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' | '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.
# 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' | '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.
Girişler
solution
- Çözüm
string
. Gereklidir. Varsayılan değer: **\*.sln
.
Derleme işleminde kullanılacak görevin çözümünü belirtir.
Tek bir çözüm oluşturmak istiyorsanız ... düğmesine tıklayın ve çözümü belirtin.
Birden çok çözüm oluşturmak istiyorsanız, arama ölçütlerini belirtin. Tek klasörlü joker karakter (*
) ve özyinelemeli joker karakterler (**
) kullanabilirsiniz. Örneğin, **.sln
tüm alt dizinlerdeki tüm .sln dosyalarını arar.
Belirttiğiniz çözümlerin bu derleme işlem hattı tarafından indirildiğinden emin olun. Depo sekmesinde:
- TFVC kullanıyorsanız, çözümün Depo sekmesindeki eşlemelerden birinin alt öğesi olduğundan emin olun.
- Git kullanıyorsanız, projenin veya çözümün Git deponuzda ve oluşturmakta olduğunuz bir dalda olduğundan emin olun.
İpucu
- MSBuild proje (.*proj) dosyaları da oluşturabilirsiniz.
- Özelleştirilmiş bir MSBuild proje dosyası oluşturuyorsanız, Visual Studio Derleme görevi yerine MSBuild görevini kullanmanızı öneririz.
vsVersion
- Visual Studio Sürümü
string
. İzin verilen değerler: 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). Varsayılan değer: latest
.
Bu girişin değeri, çözümünüzü oluşturmak için kullanılan Visual Studio sürümüyle eşleşmelidir.
/p:VisualStudioVersion={numeric_visual_studio_version}
Derleme tarafından çalıştırılan MSBuild komutuna bağımsız değişkenini ekler. Örneğin, Visual Studio 2015 belirtirseniz MSBuild /p:VisualStudioVersion=14.0
komutuna eklenir.
Azure Pipelines: Ekibiniz Visual Studio'yu Microsoft tarafından barındırılan aracılarla kullanmak istiyorsa varsayılan derleme havuzunuz olarak windows-latest seçeneğini belirleyin. Bkz. Microsoft tarafından barındırılan aracılar.
vsVersion
- Visual Studio Sürümü
string
. İzin verilen değerler: latest
, 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). Varsayılan değer: latest
.
Bu girişin değeri, çözümünüzü oluşturmak için kullanılan Visual Studio sürümüyle eşleşmelidir.
/p:VisualStudioVersion={numeric_visual_studio_version}
Derleme tarafından çalıştırılan MSBuild komutuna bağımsız değişkenini ekler. Örneğin, Visual Studio 2015 belirtirseniz MSBuild /p:VisualStudioVersion=14.0
komutuna eklenir.
Azure Pipelines: Ekibiniz Visual Studio'yu Microsoft tarafından barındırılan aracılarla kullanmak istiyorsa varsayılan derleme havuzunuz olarak windows-latest seçeneğini belirleyin. Bkz. Microsoft tarafından barındırılan aracılar.
msbuildArgs
- MSBuild Bağımsız Değişkenleri
string
.
MSBuild'e ek bağımsız değişkenler geçirir. Söz dizimi için bkz . MSBuild Command-Line Başvurusu.
platform
- Platform
string
.
Oluşturmak istediğiniz platformu belirtir; örneğin Win32
, , x86
, x64
veya any cpu
.
İpucu
- Çözüm yerine bir MSBuild projesi (.*proj) dosyasını hedefliyorsanız belirtin
AnyCPU
(boşluk yok). - Değişkenler sekmesinde (Kuyruk Zamanında İzin Ver'i seçerek) gibi
BuildPlatform
bir derleme değişkeni bildirin ve burada olarak$(BuildPlatform)
başvurun. Bu şekilde, derlemeyi kuyruğa alıp birden çok yapılandırma oluşturmayı etkinleştirdiğinizde platformu değiştirebilirsiniz.
configuration
- Yapılandırma
string
.
veya release
gibi debug
oluşturmak istediğiniz yapılandırmayı belirtir.
İpucu
Değişkenler sekmesinde (Kuyruk Zamanında İzin Ver'i seçerek) gibi BuildConfiguration
bir derleme değişkeni bildirin ve burada olarak $(BuildConfiguration)
başvurun. Bu şekilde, derlemeyi kuyruğa alıp birden çok yapılandırma oluşturmayı etkinleştirdiğinizde platformu değiştirebilirsiniz.
clean
- Temiz
boolean
. Varsayılan değer: false
.
olarak ayarlanırsa false
, görev artımlı bir derleme yapar. Bu ayar, özellikle de kod tabanınız büyükse derleme sürenizi azaltabilir. Bu seçeneğin, Depoyu false
temizle olarak da ayarlamadığınız sürece pratik bir etkisi yoktur.
olarak ayarlanırsa true
, görev kod projelerindeki tüm kodu yeniden oluşturur. Bu, MSBuild /target:clean
bağımsız değişkenine eşdeğerdir.
maximumCpuCount
- Paralel Derleme
boolean
. Varsayılan değer: false
.
İsteğe bağlı. MSBuild hedef yapılandırmanız paralel derlemeyle uyumluysa, anahtarı MSBuild'e geçirmek /m
için bu girişi de kontrol edebilirsiniz (yalnızca Windows). Hedef yapılandırmanız paralel derlemeyle uyumlu değilse, bu seçeneğin denetlenmesi derlemenizin dosya kullanımda hatalarına veya aralıklı veya tutarsız derleme hatalarına neden olabilir.
restoreNugetPackages
- NuGet Paketlerini Geri Yükleme
boolean
. Varsayılan değer: false
.
Bu giriş kullanım dışıdır. NuGet paketlerini geri yüklemek için derlemeden önce bir NuGet Araç Yükleyicisi görevi ekleyin.
msbuildArchitecture
- MSBuild Mimarisi
string
. İzin verilen değerler: x86
(MSBuild x86), x64
(MSBuild x64). Varsayılan değer: x86
.
İsteğe bağlı. Çalıştırılacak MSBuild mimarisini (x86
veya x64
) sağlar.
İpucu
Visual Studio 32 bit uygulama olarak çalıştığından, derlemeniz Team Foundation Derleme Hizmeti'nin 64 bit sürümünü çalıştıran bir derleme aracısı tarafından işlendiğinde sorunlarla karşılaşabilirsiniz. MSBuild'i x86
seçerek bu sorunları çözebilirsiniz.
logProjectEvents
- Proje Ayrıntılarını Kaydet
boolean
. Varsayılan değer: true
.
İsteğe bağlı. Her proje için zaman çizelgesi ayrıntılarını kaydeder.
createLogFile
- Günlük Dosyası Oluştur
boolean
. Varsayılan değer: false
.
İsteğe bağlı. Günlük dosyası oluşturur (yalnızca Windows).
logFileVerbosity
- Günlük Dosyası Ayrıntı Düzeyi
string
. İsteğe bağlı. olduğunda createLogFile = true
kullanın. İzin verilen değerler: quiet
, minimal
, normal
, detailed
, diagnostic
. Varsayılan değer: normal
.
Günlük dosyalarındaki ayrıntı düzeyini belirtir.
enableDefaultLogger
- Varsayılan Günlükçü'leri Etkinleştir
boolean
. Varsayılan değer: true
.
olarak ayarlanırsa true
, MSBuild için varsayılan günlükçü'leri etkinleştirir.
customVersion
- Özel Sürüm
string
.
Visual Studio'nun özel bir sürümünü ayarlar. Örnekler: 15.0
, 16.0
, 17.0
. Gerekli Visual Studio sürümü sisteme yüklenmelidir.
Azure Pipelines: Ekibiniz Visual Studio 2022'yi Microsoft tarafından barındırılan aracılarla kullanmak istiyorsa varsayılan derleme havuzu olarak seçin windows-2022
. Daha fazla bilgi için bkz. Microsoft tarafından barındırılan aracı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
Azure'da Visual Studio görüntülerini yükleme hakkında daha fazla bilgi edinin.
Önemli
Bu görev yalnızca Windows çalıştıran aracılarda desteklenir.
Gereksinimler
Gereksinim | Açıklama |
---|---|
İşlem hattı türleri | YAML, Klasik derleme |
Ü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: msbuild, visualstudio |
Ö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.95.0 veya üzeri |
Görev kategorisi | Yapı |