Megosztás:

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.

Tipp

A feladat előtt használja a NuGetAuthenticate@1 a folyamatban. További információ: Miért hibásodik meg a buildelési folyamat, és miért kéri az egyszeri Sign-On (SSO) hitelesítését?.

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.

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.

További információ az MSBuild és a Visual Studio buildek közötti különbségekről: Visual Studio-buildek és MSBuild.exe-buildek.


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.


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, x64vagy 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 architektúra
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 x86kivá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

Miért hibásodik meg a buildelési folyamat, és miért kéri az egyszeri Sign-On (SSO) hitelesítését?

A buildek meghiúsulhatnak, ha a hitelesítő adatok lejártak. A hibák elkerülése érdekében javasoljuk, hogy a NuGet Authenticate feladattal telepítse újra a hitelesítőadat-szolgáltatót, és automatikusan frissítse a hitelesítő adatokat. Ez biztosítja a megszakítás nélküli hozzáférést a folyamat végrehajtása során.

steps:
# Authenticate with NuGet to ensure credentials are refreshed
- task: NuGetAuthenticate@1 
# Build the solution using VSBuild
- task: VSBuild@1
  inputs:
    solution: '**/*.sln'

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
  • Last updated on