perintah paket (NuGet CLI)

Berlaku untuk: pembuatan paket • Versi yang didukung: 2.7+

Membuat paket NuGet berdasarkan file .nuspec atau proyek yang ditentukan. Perintah dotnet pack (lihat perintah dotnet) dan msbuild -t:pack (lihat target MSBuild) dapat digunakan sebagai alternatif.

Penggunaan

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

di mana <nuspecPath> dan <projectPath> menentukan .nuspec file atau proyek, masing-masing.

Opsi

• -BasePath

  Mengatur jalur dasar file yang ditentukan dalam file .nuspec .

• -Build

  Menentukan bahwa proyek harus dibangun sebelum membangun paket.

• -ConfigFile

  File konfigurasi NuGet yang akan diterapkan. Jika tidak ditentukan, %AppData%\NuGet\NuGet.Config (Windows), atau atau ~/.nuget/NuGet/NuGet.Config~/.config/NuGet/NuGet.Config (Mac/Linux) digunakan.

• -Exclude

  Menentukan satu atau beberapa pola kartubebas untuk dikecualikan saat membuat paket. Untuk menentukan lebih dari satu pola, ulangi bendera -Exclude. Contohnya di bawah.

• -ExcludeEmptyDirectories

  Mencegah penyertaan direktori kosong saat membangun paket.

• -ForceEnglishOutput

  (3.5+) Memaksa nuget.exe untuk berjalan menggunakan budaya berbasis bahasa Inggris yang invarian.

• -?|-help

  Menampilkan informasi bantuan untuk perintah.

• -IncludeReferencedProjects

  Menunjukkan bahwa paket bawaan harus menyertakan proyek yang dirujuk baik sebagai dependensi atau sebagai bagian dari paket. Jika proyek yang dirujuk memiliki file terkait yang memiliki nama yang sama dengan .nuspec proyek, proyek yang dirujuk tersebut ditambahkan sebagai dependensi. Jika tidak, proyek yang dirujuk ditambahkan sebagai bagian dari paket.

• -InstallPackageToOutputPath

  Tentukan apakah perintah harus menyiapkan direktori output paket untuk mendukung berbagi sebagai umpan.

• -MinClientVersion

  Atur atribut minClientVersion untuk paket yang dibuat. Nilai ini akan menggantikan nilai atribut minClientVersion yang ada (jika ada) dalam .nuspec file.

• -MSBuildPath

  (4.0+) Menentukan jalur MSBuild untuk digunakan dengan perintah , lebih diutamakan daripada -MSBuildVersion.

• -MSBuildVersion

  (3.2+) Menentukan versi MSBuild yang akan digunakan dengan perintah ini. Nilai yang didukung adalah 4, 12, 14, 15.1, 15.3, 15.4, 15.5, 15.6, 15.7, 15.8, 15.9. Secara default MSBuild di jalur Anda dipilih, jika tidak, MSBuild default ke versi MSBuild tertinggi yang diinstal.

• -NoDefaultExcludes

  Mencegah pengecualian default file paket NuGet dan file dan folder yang dimulai dengan titik, seperti .svn dan .gitignore.

• -NonInteractive

  Menekan permintaan untuk input atau konfirmasi pengguna.

• -NoPackageAnalysis

  Menentukan bahwa paket tidak boleh menjalankan analisis paket setelah membuat paket.

• -OutputDirectory

  Menentukan folder tempat paket yang dibuat disimpan. Jika tidak ada folder yang ditentukan, folder saat ini akan digunakan.

• -OutputFileNamesWithoutVersion

  Tentukan apakah perintah harus menyiapkan nama output paket tanpa versi .

• -PackagesDirectory

  Menentukan folder paket.

• -p|-Properties

  Akan muncul terakhir pada baris perintah setelah opsi lain. Menentukan daftar properti yang mengambil alih nilai dalam file proyek; lihat Properti Proyek MSBuild umum untuk nama properti. Argumen Properti di sini adalah daftar pasangan token=value, dipisahkan oleh titik koma, di mana setiap kemunculan $token$.nuspec dalam file akan diganti dengan nilai yang diberikan. Nilai dapat berupa string dalam tanda kutip. Perhatikan bahwa untuk properti "Konfigurasi", defaultnya adalah "Debug". Untuk mengubah ke konfigurasi Rilis, gunakan -Properties Configuration=Release. Secara umum, Properti harus sama dengan yang digunakan selama build proyek yang sesuai, untuk menghindari perilaku yang berpotensi aneh.

• -SolutionDirectory

  Menentukan direktori solusi.

• -Suffix

  (3.4.4+) Menambahkan akhiran ke nomor versi yang dihasilkan secara internal, biasanya digunakan untuk menambahkan build atau pengidentifikasi pra-rilis lainnya. Misalnya, menggunakan -suffix nightly akan membuat paket dengan nomor versi seperti 1.2.3-nightly. Akhiran harus dimulai dengan huruf untuk menghindari peringatan, kesalahan, dan potensi ketidakcocokan dengan versi NuGet dan Manajer Paket NuGet yang berbeda.

• -SymbolPackageFormat

  Saat membuat paket simbol, memungkinkan untuk memilih antara snupkg format dan symbols.nupkg .

• -Symbols

  Menentukan bahwa paket berisi sumber dan simbol. Ketika digunakan dengan .nuspec file, ini membuat file paket NuGet reguler dan paket simbol yang sesuai. Secara default membuat paket simbol warisan. Format baru yang direkomendasikan untuk paket simbol adalah .snupkg. Lihat Membuat paket simbol (.snupkg).

• -Tool

  Menentukan bahwa file output proyek harus ditempatkan di folder dalam tools paket.

• -Verbosity [normal|quiet|detailed]

  Menentukan jumlah detail yang ditampilkan dalam output: normal (default), quiet, atau detailed.

• -Version

  Mengambil alih nomor versi dari .nuspec file.

Lihat juga Variabel lingkungan

Tidak termasuk dependensi pengembangan

Beberapa paket NuGet berguna sebagai dependensi pengembangan, yang membantu Anda menulis pustaka Anda sendiri, tetapi belum tentu diperlukan sebagai dependensi paket aktual.

Perintah pack akan mengabaikan package entri di packages.config yang memiliki atribut yang developmentDependency diatur ke true. Entri ini tidak akan disertakan sebagai dependensi dalam paket yang dibuat.

Misalnya, pertimbangkan file berikut packages.config dalam proyek sumber:

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

Untuk proyek ini, paket yang dibuat oleh nuget pack akan memiliki dependensi pada jQuery dan microsoft-web-helpers tetapi tidak netfx-Guard.

Menekan peringatan paket

Meskipun disarankan agar Anda menyelesaikan semua peringatan NuGet selama operasi paket Anda, dalam situasi tertentu menekannya dijaga.

Anda dapat mencapainya dengan cara berikut:

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

Contoh

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"