NuGetPackager@0 – NuGet packager v0 task
NuGetPackager@0 ist veraltet. Verwenden Sie stattdessen den NuGet-Task. Es funktioniert mit dem neuen Tool Installer-Framework, sodass Sie problemlos neue Versionen von NuGet verwenden können, ohne auf ein Aufgabenupdate zu warten, bietet eine bessere Unterstützung für authentifizierte Feeds außerhalb dieser organization/Sammlung und verwendet Standardmäßig NuGet 4.
NuGetPackager@0 ist veraltet. Verwenden Sie stattdessen den NuGet-Task. Es funktioniert mit dem neuen Tool Installer-Framework, sodass Sie neue Versionen von NuGet problemlos verwenden können, ohne auf ein Aufgabenupdate zu warten, bietet eine bessere Unterstützung für authentifizierte Feeds außerhalb dieses Kontos/dieser Sammlung und verwendet Standardmäßig NuGet 4.
Syntax
# NuGet packager v0
# Deprecated: use the “NuGet” task instead. It works with the new Tool Installer framework so you can easily use new versions of NuGet without waiting for a task update, provides better support for authenticated feeds outside this organization/collection, and uses NuGet 4 by default.
- task: NuGetPackager@0
inputs:
searchPattern: '**\*.csproj' # string. Required. Path to csproj or nuspec file(s) to pack. Default: **\*.csproj.
#outputdir: # string. Package Folder.
# Pack options
#includeReferencedProjects: false # boolean. Include referenced projects. Default: false.
versionByBuild: 'false' # 'false' | 'byPrereleaseNumber' | 'byEnvVar' | 'true'. Required. Automatic package versioning. Default: false.
#versionEnvVar: # string. Required when versionByBuild = byEnvVar. Environment variable.
#requestedMajorVersion: '1' # string. Required when versionByBuild = byPrereleaseNumber. Major. Default: 1.
#requestedMinorVersion: '0' # string. Required when versionByBuild = byPrereleaseNumber. Minor. Default: 0.
#requestedPatchVersion: '0' # string. Required when versionByBuild = byPrereleaseNumber. Patch. Default: 0.
# Advanced
#configurationToPack: '$(BuildConfiguration)' # string. Configuration to Package. Default: $(BuildConfiguration).
#buildProperties: # string. Additional build properties.
#nuGetAdditionalArgs: # string. NuGet Arguments.
#nuGetPath: # string. Path to NuGet.exe.
# NuGet Packager v0
# Deprecated: use the “NuGet” task instead. It works with the new Tool Installer framework so you can easily use new versions of NuGet without waiting for a task update, provides better support for authenticated feeds outside this account/collection, and uses NuGet 4 by default.
- task: NuGetPackager@0
inputs:
searchPattern: '**\*.csproj' # string. Required. Path to csproj or nuspec file(s) to pack. Default: **\*.csproj.
#outputdir: # string. Package Folder.
# Pack options
#includeReferencedProjects: false # boolean. Include referenced projects. Default: false.
versionByBuild: 'false' # 'false' | 'byPrereleaseNumber' | 'byEnvVar' | 'true'. Required. Automatic package versioning. Default: false.
#versionEnvVar: # string. Required when versionByBuild = byEnvVar. Environment variable.
#requestedMajorVersion: '1' # string. Required when versionByBuild = byPrereleaseNumber. Major. Default: 1.
#requestedMinorVersion: '0' # string. Required when versionByBuild = byPrereleaseNumber. Minor. Default: 0.
#requestedPatchVersion: '0' # string. Required when versionByBuild = byPrereleaseNumber. Patch. Default: 0.
# Advanced
#configurationToPack: '$(BuildConfiguration)' # string. Configuration to Package. Default: $(BuildConfiguration).
#buildProperties: # string. Additional build properties.
#nuGetAdditionalArgs: # string. NuGet Arguments.
#nuGetPath: # string. Path to NuGet.exe.
Eingaben
searchPattern
-
Pfad zu den zu packenden csproj- oder nuspec-Dateien
string
. Erforderlich. Standardwert. **\*.csproj
.
Das Muster, das der Task verwendet, um nach oder nuspec
zu packenden Dateien zu suchencsproj
.
Sie können mehrere Muster durch ein Semikolon trennen, und Sie können ein Muster als negativ festlegen, indem Sie ihm das Präfix -:
voranstellen. Beispiel: **\*.csproj;-:**\*.Tests.csproj
.
outputdir
-
Paketordner
string
.
Der Ordner, in dem die Aufgabe Pakete erstellt. Wenn diese Zeichenfolge leer ist, werden Pakete in dem Ordner erstellt, in dem sich die csproj
Datei oder nuspec
befindet.
includeReferencedProjects
-
Einschließen von Projekten, auf die verwiesen wird
boolean
. Standardwert. false
.
Enthält Projekte, auf die verwiesen wird, entweder als Abhängigkeiten oder als Teil des Pakets. Kann nicht mit der automatischen Paketversionsverwaltung verwendet werden. Wenn ein Projekt, auf das verwiesen wird, über eine entsprechende nuspec
Datei mit demselben Namen wie das Projekt verfügt, wird dieses Projekt, auf das verwiesen wird, als Abhängigkeit hinzugefügt. Andernfalls wird das Projekt, auf das verwiesen wird, als Teil des Pakets hinzugefügt. Erfahren Sie mehr über die Verwendung des Paketbefehls für die NuGet CLI zum Erstellen von NuGet-Paketen.
versionByBuild
-
Automatische Paketversionsverwaltung
string
. Erforderlich. Zulässige Werte: false
(Aus), byPrereleaseNumber
(Datum und Uhrzeit verwenden), byEnvVar
(Verwenden sie eine Umgebungsvariable), true
(Buildnummer verwenden). Standardwert. false
.
Wendet die automatische Paketversionsverwaltung abhängig vom angegebenen Wert an. Diese Zeichenfolge kann nicht mit includeReferencedProjects
verwendet werden. Zulässige Werte sind:
-
byPrereleaseNumber
- Datum und Uhrzeit verwenden: Der Task generiert eine SemVer-kompatible Version, die alsX.Y.Z-ci-datetime
formatiert ist, wobei Sie die Werte von X, Y und Z angeben. -
byEnvVar
- Verwenden einer Umgebungsvariable: Der Task verwendet eine von Ihnen angegebene Umgebungsvariable, die die versionsnummer enthält, die Sie verwenden möchten. -
true
- Verwenden Sie die Buildnummer: Der Task verwendet die Buildnummer, um das Paket zu versionieren.
Hinweis
Legen Sie unter Allgemein das Buildformat auf $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r)
fest.
versionEnvVar
-
Umgebungsvariable
string
. Erforderlich, wenn versionByBuild = byEnvVar
.
Gibt den Variablennamen ohne $
, $env
oder %
an.
requestedMajorVersion
-
Haupt
string
. Erforderlich, wenn versionByBuild = byPrereleaseNumber
. Standardwert. 1
.
Die X
in Version X.Y.Z.
requestedMinorVersion
-
Kleiner
string
. Erforderlich, wenn versionByBuild = byPrereleaseNumber
. Standardwert. 0
.
Die Y
in Version X.Y.Z.
requestedPatchVersion
-
Patch
string
. Erforderlich, wenn versionByBuild = byPrereleaseNumber
. Standardwert. 0
.
Die Z
in Version X.Y.Z.
configurationToPack
-
Konfiguration zum Paket
string
. Standardwert. $(BuildConfiguration)
.
Gibt die Konfiguration an, die bei Verwendung einer csproj
Datei verpackt werden soll.
buildProperties
-
Zusätzliche Buildeigenschaften
string
.
Die durch Semikolons getrennte Liste der Eigenschaften, die zum Erstellen des Pakets verwendet werden.
nuGetAdditionalArgs
-
NuGet-Argumente
string
.
Die zusätzlichen Argumente, die an NuGet.exe pack
übergeben werden. Erfahren Sie mehr über die Verwendung des Paketbefehls für die NuGet CLI zum Erstellen von NuGet-Paketen.
nuGetPath
-
Pfad zu NuGet.exe
string
.
Optional. Gibt den Pfad zu an NuGet.exe
.
Optionen für die Vorgangskontrolle
Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.
Ausgabevariablen
Keine.
Anforderungen
Anforderung | BESCHREIBUNG |
---|---|
Pipelinetypen | YAML, Klassischer Build, klassische Version |
Wird ausgeführt auf | Agent, DeploymentGroup |
Forderungen | Selbstgehostete Agents müssen über Funktionen verfügen, die den folgenden Anforderungen entsprechen , um Aufträge auszuführen, die diese Aufgabe verwenden: Cmd |
Capabilities | Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag. |
Befehlseinschränkungen | Any |
Einstellbare Variablen | Any |
Agent-Version | 1.83.0 oder höher |
Aufgabenkategorie | Paket |