Freigeben über


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 includeReferencedProjectsverwendet werden. Zulässige Werte sind:

  • byPrereleaseNumber - Datum und Uhrzeit verwenden: Der Task generiert eine SemVer-kompatible Version, die als X.Y.Z-ci-datetimeformatiert 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 $, $envoder %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