pack (commande, NuGet CLI)pack command (NuGet CLI)

S’applique à : la création de package • versions prises en charge : 2.7+Applies to: package creation • Supported versions: 2.7+

Crée un package NuGet en fonction du .nuspec ou fichier projet.Creates a NuGet package based on the specified .nuspec or project file. Le dotnet pack commande (consultez commandes dotnet) et msbuild -t:pack (consultez cibles MSBuild) peut être utilisé comme format de remplaçants.The dotnet pack command (see dotnet Commands) and msbuild -t:pack (see MSBuild targets) may be used as alternates.

Important

Création d’un package à partir d’un fichier de projet sous Mono, n’est pas pris en charge.Under Mono, creating a package from a project file is not supported. Vous devez également ajuster les chemins d’accès non locale dans le .nuspec de fichiers pour les chemins de style Unix comme nuget.exe ne convertit pas les chemins d’accès de Windows lui-même.You also need to adjust non-local paths in the .nuspec file to Unix-style paths, as nuget.exe doesn't convert Windows pathnames itself.

UtilisationUsage

nuget pack <nuspecPath | projectPath> [options] [-Properties ...]

<nuspecPath> et <projectPath> spécifier le .nuspec ou projet de fichier, respectivement.where <nuspecPath> and <projectPath> specify the .nuspec or project file, respectively.

OptionsOptions

OptionOption DescriptionDescription
BasePathBasePath Définit le chemin d’accès de base des fichiers définis dans le .nuspec fichier.Sets the base path of the files defined in the .nuspec file.
BuildBuild Spécifie que le projet doit être généré avant de générer le package.Specifies that the project should be built before building the package.
ExcludeExclude Spécifie un ou plusieurs modèles de caractère générique à exclure lors de la création d’un package.Specifies one or more wildcard patterns to exclude when creating a package. Pour spécifier plusieurs modèles, répétez l’exclusion indicateur-.To specify more than one pattern, repeat the -Exclude flag. Voir l’exemple ci-dessous.See example below.
ExcludeEmptyDirectoriesExcludeEmptyDirectories Empêche l’inclusion de répertoires vides lors de la création du package.Prevents inclusion of empty directories when building the package.
ForceEnglishOutputForceEnglishOutput (3.5 +) Force nuget.exe pour exécuter à l’aide d’une culture dite indifférente, en anglais.(3.5+) Forces nuget.exe to run using an invariant, English-based culture.
ConfigFileConfigFile Spécifiez le fichier de configuration de la commande pack.Specify the configuration file for the pack command.
HelpHelp Affiche l’aide de la commande.Displays help information for the command.
IncludeReferencedProjectsIncludeReferencedProjects Indique que le package généré doit inclure les projets référencés en tant que dépendances ou en tant que partie du package.Indicates that the built package should include referenced projects either as dependencies or as part of the package. Si un projet référencé est associée à une .nuspec fichier ayant le même nom que le projet, ce projet référencé est ajouté en tant que dépendance.If a referenced project has a corresponding .nuspec file that has the same name as the project, then that referenced project is added as a dependency. Sinon, le projet référencé est ajouté en tant que partie du package.Otherwise, the referenced project is added as part of the package.
MinClientVersionMinClientVersion Définir le minClientVersion attribut du package.Set the minClientVersion attribute for the created package. Cette valeur remplace la valeur existants minClientVersion attribut (le cas échéant) dans le .nuspec fichier.This value will override the value of the existing minClientVersion attribute (if any) in the .nuspec file.
MSBuildPathMSBuildPath (4.0 +) Spécifie le chemin d’accès de MSBuild à utiliser avec la commande prioritaire -MSBuildVersion.(4.0+) Specifies the path of MSBuild to use with the command, taking precedence over -MSBuildVersion.
MSBuildVersionMSBuildVersion (3.2 +) Spécifie la version de MSBuild à utiliser avec cette commande.(3.2+) Specifies the version of MSBuild to be used with this command. Valeurs prises en charge sont 4, 12, 14, 15.1, 15.3, 15.4, 15.5, 15.6, 15.7, 15.8, 15.9.Supported values are 4, 12, 14, 15.1, 15.3, 15.4, 15.5, 15.6, 15.7, 15.8, 15.9. Par défaut que le MSBuild dans votre chemin d’accès est récupéré, sinon il est par défaut à la version installée la plus élevée de MSBuild.By default the MSBuild in your path is picked, otherwise it defaults to the highest installed version of MSBuild.
NoDefaultExcludesNoDefaultExcludes Empêche d’exclusion par défaut de NuGet package des fichiers et dossiers commençant par un point, tel que .svn et .gitignore.Prevents default exclusion of NuGet package files and files and folders starting with a dot, such as .svn and .gitignore.
NoPackageAnalysisNoPackageAnalysis Spécifie que le pack ne doit pas exécuter d’analyse du package après sa génération.Specifies that pack should not run package analysis after building the package.
OutputDirectoryOutputDirectory Spécifie le dossier dans lequel le package créé est stocké.Specifies the folder in which the created package is stored. Si aucun dossier n’est spécifié, le dossier actif est utilisé.If no folder is specified, the current folder is used.
PropertiesProperties Doit apparaître en dernier sur la ligne de commande après les autres options.Should appear last on the command line after other options. Spécifie une liste de propriétés qui substituent des valeurs dans le fichier projet ; consultez propriétés communes des projets MSBuild pour les noms de propriété.Specifies a list of properties that override values in the project file; see Common MSBuild Project Properties for property names. L’argument des propriétés est une liste de jeton paires = valeur, séparées par des points-virgules, où chaque occurrence de $token$ dans le .nuspec fichier sera remplacé par la valeur donnée.The Properties argument here is a list of token=value pairs, separated by semicolons, where each occurrence of $token$ in the .nuspec file will be replaced with the given value. Les valeurs peuvent être des chaînes entre guillemets.Values can be strings in quotation marks. Notez que pour la propriété « Configuration », la valeur par défaut est « Debug ».Note that for the "Configuration" property, the default is "Debug". Pour modifier une configuration Release, utilisez -Properties Configuration=Release.To change to a Release configuration, use -Properties Configuration=Release.
SuffixSuffix (3.4.4+) Ajoute un suffixe au numéro de version généré en interne, généralement utilisé pour l’ajout de la build ou autres identificateurs de version préliminaire.(3.4.4+) Appends a suffix to the internally generated version number, typically used for appending build or other pre-release identifiers. Par exemple, à l’aide de -suffix nightly va créer un package avec un type de numéro de version 1.2.3-nightly.For example, using -suffix nightly will create a package with a version number like 1.2.3-nightly. Suffixes doivent commencer par une lettre pour éviter les avertissements, les erreurs et identifier les éventuelles incompatibilités avec différentes versions de NuGet et le Gestionnaire de Package NuGet.Suffixes must start with a letter to avoid warnings, errors, and potential incompatibilities with different versions of NuGet and the NuGet Package Manager.
SymbolsSymbols Spécifie que le package contient des sources et des symboles.Specifies that the package contains sources and symbols. Lorsqu’il est utilisé avec un .nuspec fichier, cela crée un fichier de package NuGet normal et le package de symboles correspondants.When used with a .nuspec file, this creates a regular NuGet package file and the corresponding symbols package. Par défaut, il crée un package de symboles hérités.By default it creates a legacy symbol package. Le nouveau format recommandé pour les packages de symboles est .snupkg.The new recommended format for symbol packages is .snupkg. Consultez Création de packages de symboles (.snupkg).See Creating symbol packages (.snupkg).
ToolTool Spécifie que les fichiers de sortie du projet doivent être placés dans le tool dossier.Specifies that the output files of the project should be placed in the tool folder.
VerbosityVerbosity Spécifie la quantité de détails affichés dans la sortie : normal, silencieux, détaillées.Specifies the amount of detail displayed in the output: normal, quiet, detailed.
VersionVersion Remplace le numéro de version à partir de la .nuspec fichier.Overrides the version number from the .nuspec file.

Consultez également variables d’environnementAlso see Environment variables

À l’exclusion des dépendances de développementExcluding development dependencies

Certains packages NuGet sont utiles en tant que dépendances de développement, ce qui vous aident à créer votre propre bibliothèque, mais ne sont pas forcément nécessaires en tant que dépendances de package actuel.Some NuGet packages are useful as development dependencies, which help you author your own library, but aren't necessarily needed as actual package dependencies.

Le pack commande ignorera package entrées dans packages.config qui ont le developmentDependency attribut la valeur true.The pack command will ignore package entries in packages.config that have the developmentDependency attribute set to true. Ces entrées n’inclura pas comme un dépendances dans le package créé.These entries will not be include as a dependencies in the created package.

Par exemple, considérez les éléments suivants packages.config fichier dans le projet source :For example, consider the following packages.config file in the source project:

<?xml version="1.0" encoding="utf-8"?>
<packages>
    <package id="jQuery" version="1.5.2" />
    <package id="netfx-Guard" version="1.3.3.2" developmentDependency="true" />
    <package id="microsoft-web-helpers" version="1.15" />
</packages>

Pour ce projet, le package créé par nuget pack ont une dépendance jQuery et microsoft-web-helpers mais pas netfx-Guard.For this project, the package created by nuget pack will have a dependency on jQuery and microsoft-web-helpers but not netfx-Guard.

ExemplesExamples

nuget pack

nuget pack foo.nuspec

nuget pack foo.csproj

nuget pack foo.csproj -Properties Configuration=Release

nuget pack foo.csproj -Build -Symbols -Properties owners=janedoe,xiaop;version="1.0.5"

# Create a package from project foo.csproj, using MSBuild version 12 to build the project
nuget pack foo.csproj -Build -Symbols -MSBuildVersion 12 -Properties owners=janedoe,xiaop;version="1.0.5"

# Create a package from project foo.nuspec and the corresponding symbol package using the new recommended format .snupkg
nuget pack foo.nuspec -Symbols -SymbolPackageFormat snupkg

nuget pack foo.nuspec -Version 2.1.0

nuget pack foo.nuspec -Version 1.0.0 -MinClientVersion 2.5

nuget pack Package.nuspec -exclude "*.exe" -exclude "*.bat"