VSBuild@1 – A Visual Studio 1-ben való buildelési feladata

Ezzel a feladattal az MSBuild használatával hozhat létre, és beállíthatja a Visual Studio verziótulajdonságát. További információ a Visual Studio-rendszerképek Azure-beli telepítéséről.

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.

Bevitelek

solution - Megoldás
string. Kötelező. Alapértelmezett érték: **\*.sln.

A buildelési folyamat során használni kívánt feladat megoldását adja meg.

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 egymappás helyettesítő karaktereket (*) és rekurzív helyettesítő karaktereket (**). Például **.sln az összes alkönyvtárban megkeresi az összes .sln fájlt.

Győződjön meg arról, hogy a megadott megoldások le vannak töltve ezzel a buildelési folyamattal. 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 és egy ön által létrehozott ágban található.

Tipp

• MSBuild projektfájlokat (.*proj) is létrehozhat.
• Ha testre szabott MSBuild projektfájlt hoz létre, 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 Visual Studio megoldás létrehozásához használt verziójával.

Hozzáadja az /p:VisualStudioVersion={numeric_visual_studio_version} argumentumot a build által futtatott MSBuild parancshoz. Ha például a Visual Studio 2015-öt adja meg, /p:VisualStudioVersion=14.0 a rendszer hozzáadja az MSBuild parancshoz.

Azure Pipelines: Ha csapata a Visual Studiót szeretné használni a Microsoft által üzemeltetett ügynökökkel, válassza a windows-latest lehetőséget 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 MSBuild projektfájlt (.*proj) céloz meg, adja meg AnyCPU a (nincs térköz) értéket.
• Deklaráljon egy buildváltozót, például BuildPlatform a Változók lapon (válassza az Engedélyezés várakozási időben lehetőséget), és hivatkozzon rá itt a következőként: $(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 várakozási időben lehetőséget), és hivatkozzon rá itt a következőként: $(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 a értékre falsevan állítva, a tevékenység növekményes buildet hoz létre. Ez a beállítás csökkentheti a buildelési időt, különösen akkor, ha a kódbázis nagy méretű. Ez a beállítás csak akkor alkalmazható, ha a Clean adattárat is a értékre falseállítja.

Ha a értékre truevan állítva, a feladat újraépíti a kódprojektek összes kódját. Ez az MSBuild /target:clean argumentumnak felel meg.

maximumCpuCount - Párhuzamos buildelés
boolean. Alapértelmezett érték: false.

Választható. Ha az MSBuild célkonfigurációja kompatibilis a párhuzamos építéssel, ellenőrizheti ezt a bemenetet, hogy átadja a kapcsolót az /m MSBuildnek (csak Windows esetén). Ha a célkonfiguráció nem kompatibilis a párhuzamos építéssel, ennek a beállításnak a bejelölése 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-eszköz telepítő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.

Választható. A futtatandó MSBuild architektúráját (x86 vagy x64) biztosítja.

Tipp

Mivel a Visual Studio 32 bites alkalmazásként fut, problémákat tapasztalhat, ha a buildet egy olyan fordítóügynök dolgozza fel, amely a Team Foundation buildszolgáltatás 64 bites verzióját futtatja. Az MSBuild x86lehetőséget választva megoldhatja ezeket a problémákat.

logProjectEvents - Projekt részleteinek rögzítése
boolean. Alapértelmezett érték: true.

Választható. Az egyes projektek ütemtervadatait rögzíti.

createLogFile - Naplófájl létrehozása
boolean. Alapértelmezett érték: false.

Választható. Naplófájlt hoz létre (csak Windows rendszeren).

logFileVerbosity - Naplófájl részletessége
string. Választható. Használja a következőt: createLogFile = true. Engedélyezett értékek: quiet, minimal, normal, detailed, diagnostic. Alapértelmezett érték: normal.

A naplófájlok részletességi szintjét adja meg.

enableDefaultLogger - Alapértelmezett naplózó engedélyezése
boolean. Alapértelmezett érték: true.

Ha a értékre van állítva, trueengedélyezi az MSBuild alapértelmezett naplózóját.

customVersion - Egyéni verzió
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 rendszerben.

Azure Pipelines: Ha csapata a Visual Studio 2022-t szeretné használni a Microsoft által üzemeltetett ügynökökkel, válassza ki windows-2022 az alapértelmezett buildkészletet. 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ési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

További információ a Visual Studio-rendszerképek Azure-beli 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	Ügynök, DeploymentGroup
Igények	A saját üzemeltetésű ügynököknek olyan képességekkel kell rendelkezniük , amelyek megfelelnek az alábbi követelményeknek a feladatot használó feladatok futtatásához: msbuild, visualstudio
Képességek	Ez a feladat nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	1.95.0 vagy újabb
Feladatkategória	Build