VSBuild@1 – A Visual Studio 1. buildelési feladata
Ezzel a feladattal létrehozhatja az MSBuild alkalmazást, és beállíthatja a Visual Studio verziótulajdonságát. További információ Visual Studio-rendszerképek Azure-való telepítéséről.
Szinopszis
# 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.
Bemenetek
solution
-
megoldás
string
. Szükséges. Alapértelmezett érték: **\*.sln
.
Megadja a buildelési folyamat során használni kívánt feladat megoldását.
Ha egyetlen megoldást szeretne létrehozni, kattintson a ... gombra, és adja meg a megoldást.
Ha több megoldást szeretne létrehozni, adja meg a keresési feltételeket. Használhat egy egymappás helyettesítő karaktert (*
) és rekurzív helyettesítő karaktereket (**
). Például **.sln
minden alkönyvtárban megkeresi az összes .sln fájlt.
Győződjön meg arról, hogy a megadott megoldásokat a buildelési folyamat tölti le. Az Adattár lapon:
- Ha TFVC-t használ, győződjön meg arról, hogy a megoldás az Adattár lap egyik leképezésének gyermeke.
- Ha a Gitet használja, győződjön meg arról, hogy a projekt vagy a megoldás a Git-adattárban, valamint az ön által létrehozott ágban található.
Tipp
- MSBuild projektfájlokat (.*proj) is létrehozhat.
- Ha testre szabott MSBuild projektfájlt készít, javasoljuk, hogy a Visual Studio Build feladat helyett az MSBuild feladatot használja.
vsVersion
-
Visual Studio-verzió
string
. Engedélyezett értékek: 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). Alapértelmezett érték: latest
.
A bemenet értékének meg kell egyeznie a Megoldás létrehozásához használt Visual Studio verziójával.
Hozzáadja a /p:VisualStudioVersion={numeric_visual_studio_version}
argumentumot a build által futtatott MSBuild parancshoz. Ha például Visual Studio 2015ad meg, /p:VisualStudioVersion=14.0
lesz hozzáadva az MSBuild parancshoz.
Azure Pipelines: Ha csapata a Visual Studiót a Microsoft által üzemeltetett ügynökökkel szeretné használni, válassza windowsos legújabb alapértelmezett buildkészletként. Lásd: Microsoft által üzemeltetett ügynökök.
vsVersion
-
Visual Studio-verzió
string
. Engedélyezett értékek: 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). Alapértelmezett érték: latest
.
A bemenet értékének meg kell egyeznie a Megoldás létrehozásához használt Visual Studio verziójával.
Hozzáadja a /p:VisualStudioVersion={numeric_visual_studio_version}
argumentumot a build által futtatott MSBuild parancshoz. Ha például Visual Studio 2015ad meg, /p:VisualStudioVersion=14.0
lesz hozzáadva az MSBuild parancshoz.
Azure Pipelines: Ha csapata a Visual Studiót a Microsoft által üzemeltetett ügynökökkel szeretné használni, válassza windowsos legújabb alapértelmezett buildkészletként. Lásd: Microsoft által üzemeltetett ügynökök.
msbuildArgs
-
MSBuild argumentumok
string
.
További argumentumokat ad át az MSBuildnek. Szintaxis: MSBuild Command-Line Referencia.
platform
-
platform
string
.
Megadja a létrehozni kívánt platformot, például Win32
, x86
, x64
vagy any cpu
.
Tipp
- Ha megoldás helyett EGY MSBuild projektfájlt (.*proj) céloz meg, adja meg a
AnyCPU
(nincs szóköz). - Deklaráljon egy buildváltozót, például
BuildPlatform
a Változók lapon (válassza az Engedélyezés az üzenetsor idején lehetőséget), és hivatkozzon rá itt$(BuildPlatform)
. Így módosíthatja a platformot, amikor várólistára állítja a buildet, és lehetővé teszi több konfiguráció összeállítását.
configuration
-
konfigurációs
string
.
Megadja a létrehozni kívánt konfigurációt, például debug
vagy release
.
Tipp
Deklaráljon egy buildváltozót, például BuildConfiguration
a Változók lapon (válassza az Engedélyezés az üzenetsor idején lehetőséget), és hivatkozzon rá itt $(BuildConfiguration)
. Így módosíthatja a platformot, amikor várólistára állítja a buildet, és lehetővé teszi több konfiguráció összeállítását.
clean
-
Tiszta
boolean
. Alapértelmezett érték: false
.
Ha false
értékre van állítva, a tevékenység növekményes buildet készít. Ez a beállítás csökkentheti a buildelési időt, különösen akkor, ha a kódbázis nagy. Ez a beállítás csak akkor gyakorol gyakorlati hatást, ha a Tiszta adattárat is false
értékre állítja.
Ha true
értékre van állítva, a feladat újraépíti a kódprojektek összes kódját. Ez egyenértékű az MSBuild /target:clean
argumentumával.
maximumCpuCount
-
párhuzamos buildelés
boolean
. Alapértelmezett érték: false
.
Opcionális. Ha az MSBuild célkonfigurációja kompatibilis a párhuzamos építéssel, akkor ellenőrizheti ezt a bemenetet, hogy átadja a /m
kapcsolót az MSBuildnek (csak Windows esetén). Ha a célkonfiguráció nem kompatibilis a párhuzamos építéssel, a beállítás ellenőrzése miatt a build fájlhasználati hibákat vagy időszakos vagy inkonzisztens buildhibákat okozhat.
restoreNugetPackages
-
NuGet-csomagok visszaállítása
boolean
. Alapértelmezett érték: false
.
Ez a bemenet elavult. A NuGet-csomagok visszaállításához adjon hozzá egy NuGet Tool Installer- feladatot a buildelés előtt.
msbuildArchitecture
-
MSBuild Architecture
string
. Engedélyezett értékek: x86
(MSBuild x86), x64
(MSBuild x64). Alapértelmezett érték: x86
.
Opcionális. Biztosítja az MSBuild architektúráját (x86
vagy x64
) a futtatáshoz.
Tipp
Mivel a Visual Studio 32 bites alkalmazásként fut, problémákat tapasztalhat, ha a buildet egy olyan buildügynök dolgozza fel, amely a Team Foundation buildszolgáltatás 64 bites verzióját futtatja. Az MSBuild x86
kiválasztásával megoldhatja ezeket a problémákat.
logProjectEvents
-
Projekt részleteinek rögzítése
boolean
. Alapértelmezett érték: true
.
Opcionális. Az egyes projektek ütemtervadatait rögzíti.
createLogFile
-
Naplófájl létrehozása
boolean
. Alapértelmezett érték: false
.
Opcionális. Naplófájlt hoz létre (csak Windows rendszeren).
logFileVerbosity
-
naplófájl részletességi
string
. Opcionális. Használja a createLogFile = true
. Engedélyezett értékek: quiet
, minimal
, normal
, detailed
, diagnostic
. Alapértelmezett érték: normal
.
Meghatározza a naplófájlok részletességi szintjét.
enableDefaultLogger
-
Alapértelmezett naplózó engedélyezése
boolean
. Alapértelmezett érték: true
.
Ha true
értékre van állítva, engedélyezi az MSBuild alapértelmezett naplózójának használatát.
customVersion
-
egyéni verziós
string
.
Beállítja a Visual Studio egyéni verzióját. Példák: 15.0
, 16.0
, 17.0
. A Visual Studio szükséges verzióját telepíteni kell a rendszerbe.
Azure Pipelines: Ha csapata a Visual Studio 2022-t szeretné használni a Microsoft által üzemeltetett ügynökökkel, válassza a windows-2022
alapértelmezett buildkészletként. További információ: Microsoft által üzemeltetett ügynökök.
Feladatvezérlési lehetőségek
Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlők és gyakori feladattulajdonságok.
Kimeneti változók
Nincs.
Megjegyzések
További információ Visual Studio-rendszerképek Azure-való telepítéséről.
Fontos
Ez a feladat csak Windows rendszerű ügynökök esetén támogatott.
Követelmények
Követelmény | Leírás |
---|---|
Folyamattípusok | YAML, klasszikus build |
Futtatás bekapcsolva | Ügynök, DeploymentGroup |
Követelmények | A saját üzemeltetésű ügynököknek olyan képességekkel kell rendelkezniük, amelyek megfelelnek az alábbi követelményeknek, kell futtatniuk a feladatot használó feladatokat: msbuild, visualstudio |
képességek | Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek. |
parancskorlátozások | Bármely |
Változók beállítása | Bármely |
Ügynök verziója | 1.95.0 vagy újabb |
Tevékenységkategória | Épít |