NuGetPackager@0 - Tâche nuGet packager v0

Article
08/20/2024

NuGetPackager@0 est déconseillé. Utilisez plutôt la tâche NuGet. Il fonctionne avec le nouveau framework Du programme d’installation d’outils, ce qui vous permet d’utiliser facilement les nouvelles versions de NuGet sans attendre une mise à jour de tâche, offre une meilleure prise en charge des flux authentifiés en dehors de cette organization/collection et utilise NuGet 4 par défaut.

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.

Entrées

searchPattern - Chemin d’accès aux fichiers csproj ou nuspec à pack
string. Obligatoire. Valeur par défaut : **\*.csproj.

Modèle que la tâche utilise pour csproj rechercher des fichiers ou nuspec à emballer.

Vous pouvez séparer plusieurs modèles avec un point-virgule, et vous pouvez faire un modèle négatif en le préfixant avec -:. Exemple : **\*.csproj;-:**\*.Tests.csproj.

outputdir - Dossier de package
string.

Dossier dans lequel la tâche crée des packages. Si cette chaîne est vide, les packages sont créés dans le dossier où se trouve le csproj fichier ou nuspec .

includeReferencedProjects - Inclure les projets référencés
boolean. Valeur par défaut : false.

Inclut les projets référencés en tant que dépendances ou dans le cadre du package. Ne peut pas être utilisé avec le contrôle de version automatique des packages. Si un projet référencé a un fichier correspondant nuspec portant le même nom que le projet, ce projet référencé est ajouté en tant que dépendance. Sinon, le projet référencé est ajouté dans le cadre du package. En savoir plus sur l’utilisation de la commande pack pour l’interface CLI NuGet pour créer des packages NuGet.

versionByBuild - Contrôle de version automatique des packages
string. Obligatoire. Valeurs autorisées : false (Désactivé), byPrereleaseNumber (Utiliser la date et l’heure), byEnvVar (Utiliser une variable d’environnement), true (Utiliser le numéro de build). Valeur par défaut : false.

Applique le contrôle de version automatique du package en fonction de la valeur spécifiée. Cette chaîne ne peut pas être utilisée avec includeReferencedProjects. Les valeurs autorisées sont les suivantes :

byPrereleaseNumber - Utilisez la date et l’heure : la tâche génère une version conforme SemVer au X.Y.Z-ci-datetimeformat , où vous spécifiez les valeurs de X, Y et Z.
byEnvVar - Utiliser une variable d’environnement : la tâche utilise une variable d’environnement que vous spécifiez et contient le numéro de version que vous souhaitez utiliser.
true - Utiliser le numéro de build : la tâche utilise le numéro de build pour versionner le package.

Notes

Sous Général, définissez le format de build sur $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).

versionEnvVar - Variable d’environnement
string. Nécessaire lorsque versionByBuild = byEnvVar.

Spécifie le nom de la variable sans $, $envou %.

requestedMajorVersion - Majeur
string. Nécessaire lorsque versionByBuild = byPrereleaseNumber. Valeur par défaut : 1.

dans la X version X.Y.Z.

requestedMinorVersion - Mineur
string. Nécessaire lorsque versionByBuild = byPrereleaseNumber. Valeur par défaut : 0.

dans la Y version X.Y.Z.

requestedPatchVersion - Patch
string. Nécessaire lorsque versionByBuild = byPrereleaseNumber. Valeur par défaut : 0.

dans la Z version X.Y.Z.

configurationToPack - Configuration à empaqueter
string. Valeur par défaut : $(BuildConfiguration).

Spécifie la configuration à empaqueter lors de l’utilisation d’un csproj fichier.

buildProperties - Propriétés de build supplémentaires
string.

Liste délimitée par des points-virgules des propriétés utilisées pour générer le package.

nuGetAdditionalArgs - NuGet Arguments
string.

Arguments supplémentaires passés à NuGet.exe pack. En savoir plus sur l’utilisation de la commande pack pour l’interface CLI NuGet pour créer des packages NuGet.

nuGetPath - Chemin d’accès à NuGet.exe
string.

facultatif. Fournit le chemin d’accès à NuGet.exe.

Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Configuration requise

Condition requise	Description
Types de pipelines	YAML, build classique, version classique
S’exécute sur	Agent, DeploymentGroup
Demandes	Les agents auto-hébergés doivent avoir des fonctionnalités qui correspondent aux exigences suivantes pour exécuter des travaux qui utilisent cette tâche : Cmd
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commande	Quelconque
Variables paramétrables	Quelconque
Version de l’agent	1.83.0 ou version ultérieure
Catégorie de la tâche	Package

Partage via