Referensi NuGet CLI

Artikel
03/08/2024

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.

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.

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.
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.
Untuk menggunakan alat CLI dari mana saja, tambahkan lokasi folder untuk file ke nuget.exe variabel lingkungan PATH Anda.

Perilaku dapat sedikit bervariasi berdasarkan distribusi sistem operasi Anda.

Catatan

Visual Studio untuk Mac dijadwalkan untuk dihentikan pada 31 Agustus 2024 sesuai dengan Kebijakan Siklus Hidup Modern Microsoft. Untuk informasi selengkapnya, lihat Apa yang terjadi pada Visual Studio untuk Mac.

Instal Mono versi 4.4.2 atau yang lebih baru.

Jalankan perintah berikut pada prompt shell:

# Download the latest stable `nuget.exe` to `/usr/local/bin`
sudo curl -o /usr/local/bin/nuget.exe https://dist.nuget.org/win-x86-commandline/latest/nuget.exe

Buat alias dengan menambahkan skrip berikut ke file yang sesuai untuk sistem operasi Anda (biasanya ~/.bash_aliases atau ~/.bash_profile):
```
# Create as alias for nuget
alias nuget="mono /usr/local/bin/nuget.exe"
```
Isi ulang shell. Uji penginstalan dengan memasukkan perintah nuget tanpa parameter. Bantuan NuGet CLI harus ditampilkan.

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.