Comando pack (interfaccia della riga di comando di NuGet)

Si applica a: creazione di pacchetti • Versioni supportate: 2.7+

Crea un pacchetto NuGet basato sul file di progetto o con estensione nuspec specificato. Il dotnet pack comando (vedere i comandi dotnet) e msbuild -t:pack (vedere destinazioni MSBuild) può essere usato come alternative.

Utilizzo

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

dove <nuspecPath> e <projectPath> specificare rispettivamente il .nuspec file di progetto o .

Opzioni

• -BasePath

  Imposta il percorso di base dei file definiti nel file con estensione nuspec .

• -Build

  Specifica che il progetto deve essere compilato prima di compilare il pacchetto.

• -ConfigFile

  File di configurazione NuGet da applicare. Se non specificato, %AppData%\NuGet\NuGet.Config viene usato (Windows) o ~/.nuget/NuGet/NuGet.Config~/.config/NuGet/NuGet.Config (Mac/Linux).

• -Exclude

  Specifica uno o più modelli con caratteri jolly da escludere durante la creazione di un pacchetto. Per specificare più modelli, ripetere il flag -Exclude. Vedi l'esempio seguente.

• -ExcludeEmptyDirectories

  Impedisce l'inclusione di directory vuote durante la compilazione del pacchetto.

• -ForceEnglishOutput

  (3.5+) Forza nuget.exe l'esecuzione usando impostazioni cultura invarianti basate sull'inglese.

• -?|-help

  Visualizza le informazioni della Guida per il comando .

• -IncludeReferencedProjects

  Indica che il pacchetto compilato deve includere progetti di riferimento come dipendenze o come parte del pacchetto. Se un progetto a cui si fa riferimento ha un file corrispondente .nuspec con lo stesso nome del progetto, tale progetto a cui si fa riferimento viene aggiunto come dipendenza. In caso contrario, il progetto a cui si fa riferimento viene aggiunto come parte del pacchetto.

• -InstallPackageToOutputPath

  Specificare se il comando deve preparare la directory di output del pacchetto per supportare la condivisione come feed.

• -MinClientVersion

  Impostare l'attributo minClientVersion per il pacchetto creato. Questo valore eseguirà l'override del valore dell'attributo minClientVersion esistente (se presente) nel .nuspec file.

• -MSBuildPath

  (4.0+) Specifica il percorso di MSBuild da usare con il comando , che ha la precedenza su -MSBuildVersion.

• -MSBuildVersion

  (3.2+) Specifica la versione di MSBuild da usare con questo comando. I valori supportati sono 4, 12, 14, 15.1, 15.3, 15.4, 15.5, 15.6, 15.7, 15.8, 15.9. Per impostazione predefinita, MSBuild nel percorso è selezionato. In caso contrario, per impostazione predefinita viene selezionata la versione più recente installata di MSBuild.

• -NoDefaultExcludes

  Impedisce l'esclusione predefinita di file e file e cartelle del pacchetto NuGet a partire da un punto, ad esempio .svn e .gitignore.

• -NonInteractive

  Elimina le richieste di input o conferme dell'utente.

• -NoPackageAnalysis

  Specifica che pack non deve eseguire l'analisi del pacchetto dopo la compilazione di quest'ultimo.

• -OutputDirectory

  Specifica la cartella in cui è archiviato il pacchetto creato. Se non viene specificata alcuna cartella, viene utilizzata la cartella corrente.

• -OutputFileNamesWithoutVersion

  Specificare se il comando deve preparare il nome dell'output del pacchetto senza la versione.

• -PackagesDirectory

  Specifica la cartella packages.

• -p|-Properties

  Dovrebbe essere visualizzato per ultimo nella riga di comando dopo altre opzioni. Specifica un elenco di proprietà che eseguono l'override dei valori nel file di progetto; vedere Proprietà comuni del progetto MSBuild per i nomi delle proprietà. L'argomento Proprietà di seguito è riportato un elenco di coppie token=valore, separate da punto e virgola, in cui ogni occorrenza di $token$ nel .nuspec file verrà sostituita con il valore specificato. I valori possono essere stringhe tra virgolette. Si noti che per la proprietà "Configuration", il valore predefinito è "Debug". Per passare a una configurazione versione, usare -Properties Configuration=Release. In generale, le proprietà devono essere le stesse usate durante la compilazione del progetto corrispondente, per evitare comportamenti potenzialmente strani.

• -SolutionDirectory

  Specifica la directory della soluzione.

• -Suffix

  (3.4.4+) Aggiunge un suffisso al numero di versione generato internamente, in genere usato per l'aggiunta di build o altri identificatori di versione non definitiva. Ad esempio, l'uso -suffix nightly di creerà un pacchetto con un numero di versione come 1.2.3-nightly. I suffissi devono iniziare con una lettera per evitare avvisi, errori e potenziali incompatibilità con versioni diverse di NuGet e nuGet Gestione pacchetti.

• -SymbolPackageFormat

  Quando si crea un pacchetto di simboli, consente di scegliere tra il snupkg formato e symbols.nupkg .

• -Symbols

  Specifica che il pacchetto contiene origini e simboli. Se usato con un .nuspec file, viene creato un normale file di pacchetto NuGet e il pacchetto di simboli corrispondente. Per impostazione predefinita, crea un pacchetto di simboli legacy. Il nuovo formato consigliato per i pacchetti di simboli è l'estensione snupkg. Vedere Creazione di pacchetti di simboli (estensione snupkg).

• -Tool

  Specifica che i file di output del progetto devono essere inseriti nella tools cartella all'interno del pacchetto.

• -Verbosity [normal|quiet|detailed]

  Specifica la quantità di dettagli visualizzati nell'output: normal (impostazione predefinita), quieto detailed.

• -Version

  Esegue l'override del numero di versione dal .nuspec file.

Vedere anche Variabili di ambiente

Esclusione delle dipendenze di sviluppo

Alcuni pacchetti NuGet sono utili come dipendenze di sviluppo, che consentono di creare una libreria personalizzata, ma non sono necessariamente necessarie come dipendenze effettive del pacchetto.

Il pack comando ignorerà package le voci in packages.config con l'attributo developmentDependency impostato su true. Queste voci non verranno incluse come dipendenze nel pacchetto creato.

Si consideri ad esempio il file seguente packages.config nel progetto di origine:

<?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>

Per questo progetto, il pacchetto creato da nuget pack avrà una dipendenza da jQuery e microsoft-web-helpers ma non netfx-Guard.

Eliminazione degli avvisi di pacchetto

Sebbene sia consigliabile risolvere tutti gli avvisi NuGet durante le operazioni del pacchetto, in determinate situazioni è necessario eliminarli.

È possibile ottenere questo risultato nel modo seguente:

nuget.exe pack package.nuspec -Properties NoWarn=NU5104

Esempi

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"