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, x64veya 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 releasegibi 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 falsetemizle 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 x86seç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 = truekullanı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ı