Bagikan melalui

Referensi NuGet CLI

  • Artikel

NuGet Command Line Interface (CLI), nuget.exe, menyediakan tingkat penuh fungsionalitas NuGet untuk menginstal, membuat, menerbitkan, dan mengelola paket tanpa membuat perubahan apa pun pada file proyek.

Untuk menggunakan perintah apa pun, buka jendela perintah atau shell bash, lalu jalankan nuget diikuti oleh perintah dan opsi yang sesuai, seperti nuget help pack (untuk melihat bantuan pada perintah paket).

Dokumentasi ini mencerminkan versi terbaru NuGet CLI. Untuk detail pasti untuk versi tertentu yang Anda gunakan, jalankan nuget help untuk perintah yang diinginkan.

Untuk mempelajari cara menggunakan perintah dasar dengan nuget.exe CLI, lihat Menginstal dan menggunakan paket menggunakan CLI nuget.exe.

Menginstal nuget.exe

Selalu instal versi terbaru alat yang mendukung konfigurasi Anda.

  • Anda dapat mengunduh versi terbaru yang direkomendasikan di https://dist.nuget.org/win-x86-commandline/latest/nuget.exe.
  • Jika Anda sudah menginstal nuget.exe alat CLI, Anda dapat memperbarui alat ke versi terbaru dengan perintah nuget update -self.
  • Untuk kompatibilitas dengan sistem integrasi berkelanjutan yang lebih lama, URL sebelumnya, https://nuget.org/nuget.exe saat ini menyediakan alat CLI versi 2.8.6 yang tidak digunakan lagi.

  1. Kunjungi nuget.org/downloads dan unduh NuGet versi 3.3 atau yang lebih baru.

    • Versi 5.0 dan yang lebih baru memerlukan .NET Framework versi 4.7.2 atau yang lebih baru.
    • Versi 4.1.0 dan yang lebih baru diperlukan untuk menerbitkan paket ke nuget.org.
    • Versi 2.8.6 tidak kompatibel dengan Mono.

  2. Setiap unduhan adalah file secara nuget.exe langsung. Instruksikan browser Anda untuk menyimpan file ke folder pilihan Anda. File unduhan bukan alat penginstal, jadi Anda tidak melihat apa pun jika Anda menjalankan file langsung dari browser.

  3. Untuk menggunakan alat CLI dari mana saja, tambahkan lokasi folder untuk file ke nuget.exe variabel lingkungan PATH Anda.

Tip

Untuk membuat NuGet CLI tersedia dalam Package Manager Console di Visual Studio, lihat Menggunakan nuget.exe CLI di konsol.

Ketersediaan

Lihat ketersediaan fitur untuk detail yang tepat.

  • Semua perintah tersedia di Windows.
  • Semua perintah bekerja dengan nuget.exe berjalan pada Mono kecuali jika ditunjukkan untuk pack, restore, dan update.
  • packPerintah , , deleterestore, locals, dan push juga tersedia di Mac dan Linux melalui dotnet CLI.

Perintah dan penerapan

Perintah dan penerapan yang tersedia untuk pembuatan paket, konsumsi paket, dan/atau penerbitan paket ke host:

Perintah Umum Peran yang Berlaku Versi NuGet Deskripsi
pack Pembuatan 2.7+ Membuat paket NuGet dari .nuspec file proyek atau . Saat berjalan di Mono, membuat paket dari file proyek tidak didukung.
Mendorong Menerbitkan Semua Menerbitkan paket ke sumber paket.
config Semua Semua Mendapatkan atau mengatur nilai konfigurasi NuGet.
bantuan atau ? Semua Semua Menampilkan informasi bantuan atau bantuan untuk sebuah perintah.
Penduduk setempat Consumption 3.3+ Mencantumkan lokasi paket global, http-cache, dan folder sementara dan menghapus konten folder tersebut.
Mengembalikan Consumption 2.7+ Memulihkan semua paket yang dirujuk oleh format manajemen paket yang digunakan. Saat berjalan pada Mono, memulihkan paket menggunakan format PackageReference tidak didukung.
setapikey Penerbitan, Konsumsi Semua Menyimpan kunci API untuk sumber paket tertentu saat sumber paket tersebut memerlukan kunci untuk akses.
Spec Pembuatan Semua .nuspec Menghasilkan file, menggunakan token jika menghasilkan file dari proyek Visual Studio.
Perintah Sekunder Peran yang Berlaku Versi NuGet Deskripsi
penambahan Menerbitkan 3.3+ Menambahkan paket ke sumber paket non-HTTP menggunakan tata letak hierarkis. Untuk sumber HTTP, gunakan pendorongan.
hapus Menerbitkan Semua Menghapus atau membatalkan daftar paket dari sumber paket.
init Pembuatan 3.3+ Menambahkan paket dari folder ke sumber paket menggunakan tata letak hierarkis.
Menginstal Consumption Semua Menginstal paket ke dalam proyek saat ini tetapi tidak mengubah proyek atau file referensi.
daftar Konsumsi, mungkin Penerbitan Semua Menampilkan paket dari sumber tertentu.
Cermin Menerbitkan Tidak digunakan lagi di 3.2+ Mencerminkan paket dan dependensinya dari sumber ke repositori target.
cari Consumption 5.8+ Mencari sumber tertentu menggunakan string kueri yang disediakan.
sumber Konsumsi, Penerbitan Semua Mengelola sumber paket dalam file konfigurasi.
memperbarui Consumption Semua Memperbarui paket proyek ke versi terbaru yang tersedia. Tidak didukung saat berjalan pada Mono.

Perintah yang berbeda menggunakan berbagai variabel Lingkungan.

Perintah NuGet CLI dengan peran yang berlaku:

Peran Perintah
Consumption config, , helpinstall, list, locals, restore, search, setapikey, , sources,update
Pembuatan config, , helpinit, , pack,spec
Menerbitkan add, , deleteconfig, help, list, push, , setapikey,sources

Pengembang hanya berkaitan dengan mengkonsumsi paket, misalnya, hanya perlu memahami bahwa subset perintah NuGet.

Catatan

Nama opsi perintah tidak peka huruf besar/kecil. Opsi yang tidak digunakan lagi tidak disertakan dalam referensi ini, seperti NoPrompt (digantikan oleh NonInteractive) dan Verbose (digantikan oleh Verbosity).

Pelokalan

NuGet.exe kemajuan, peringatan, dan pesan kesalahan diterjemahkan ke dalam lokal yang sama dengan Visual Studio. NuGet.exe dikirim sebagai exe tunggal, dan karena pertimbangan ukuran, hanya pesan yang paling umum muncul yang diterjemahkan dalam semua bahasa.