Referensi NuGet CLI

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

Windows

Selalu instal versi terbaru alat yang mendukung konfigurasi Anda.

nuget.exe Jika alat CLI sudah diinstal, Anda dapat memperbarui alat ke versi terbaru dengan menggunakan perintah nuget update -self.

1. Unduh nuget.exe:

   • Untuk mengunduh versi terbaru yang direkomendasikan, buka https://dist.nuget.org/win-x86-commandline/latest/nuget.exe.
   • Untuk mengunduh versi 2.8.6 yang tidak digunakan lagi, untuk mempertahankan kompatibilitas dengan sistem integrasi berkelanjutan yang lebih lama, buka https://dist.nuget.org/win-x86-commandline/v2.8.6/nuget.exe. Versi 2.8.6 tidak kompatibel dengan Mono.
   • Untuk memilih versi yang akan diunduh, buka nuget.org/downloads.
     • Versi 5.0 dan yang lebih baru memerlukan .NET Framework 4.7.2 atau yang lebih baru.
     • Versi 4.1.0 atau yang lebih baru diperlukan untuk menerbitkan paket ke nuget.org.

2. Saat diminta, simpan file ke folder pilihan Anda. File nuget.exe diunduh secara langsung. File yang diunduh bukan alat penginstal, jadi tidak perlu menjalankan file langsung dari browser.

3. Untuk menggunakan alat CLI dari folder apa pun, tambahkan folder yang berisi file nuget.exe ke variabel lingkungan Anda PATH .

macOS / Linux

Perilaku dapat sedikit bervariasi berdasarkan distribusi sistem operasi Anda.

Nota

Visual Studio untuk Mac dihentikan pada 31 Agustus 2024, sesuai dengan Kebijakan Siklus Hidup Modern Microsoft. Anda dapat terus bekerja dengan Visual Studio untuk Mac, tetapi ada beberapa opsi lain untuk pengembang di macOS, seperti ekstensi C# Dev Kit untuk VS Code.

Untuk informasi selengkapnya tentang garis waktu dukungan dan alternatif, lihat Visual Studio untuk Mac dihentikan 31 Agustus 2024.

1. Instal Mono versi 4.4.2 atau yang lebih baru.

2. Pada perintah shell, jalankan perintah berikut:

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

3. Buat alias dengan menambahkan kode berikut ke file yang digunakan sistem operasi Anda untuk menyimpan alias atau informasi konfigurasi Bash. Biasanya, file ~/.bash_aliases atau ~/.bash_profile digunakan untuk tujuan ini.

   # Create an alias for `nuget`.
   alias nuget="mono /usr/local/bin/nuget.exe"
   

4. Isi ulang shell. Uji penginstalan dengan memasukkan perintah nuget tanpa parameter. Perintah harus mencetak informasi bantuan NuGet CLI ke layar.

Petunjuk / Saran

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

Availability

Lihat ketersediaan fitur untuk detail yang tepat.

• Semua perintah tersedia di Windows.
• Semua perintah bekerja dengan nuget.exe berjalan di Mono kecuali jika ditunjukkan untuk pack, restore, dan update.
• packPerintah , , restoredelete, 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
bungkus	Penciptaan	2.7+	Membuat paket NuGet dari .nuspec file proyek atau . Saat berjalan di Mono, membuat paket dari file proyek tidak didukung.
push	Menerbitkan	All	Menerbitkan paket ke sumber paket.
Config	All	All	Mendapatkan atau mengatur nilai konfigurasi NuGet.
bantuan atau ?	All	All	Menampilkan informasi bantuan atau bantuan untuk sebuah perintah.
Penduduk setempat	Konsumsi	3.3+	Mencantumkan lokasi paket global, http-cache, dan folder sementara dan menghapus konten folder tersebut.
Mengembalikan	Konsumsi	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	All	Menyimpan kunci API untuk sumber paket tertentu saat sumber paket tersebut memerlukan kunci untuk akses.
Spec	Penciptaan	All	Menghasilkan file .nuspec, menggunakan token jika menghasilkan file dari proyek Visual Studio.

Perintah Sekunder	Peran yang Berlaku	Versi NuGet	Deskripsi
add	Menerbitkan	3.3+	Menambahkan paket ke sumber paket non-HTTP menggunakan tata letak hierarkis. Untuk sumber HTTP, gunakan pendorongan.
delete	Menerbitkan	All	Menghapus atau membatalkan daftar paket dari sumber paket.
init	Penciptaan	3.3+	Menambahkan paket dari folder ke sumber paket menggunakan tata letak hierarkis.
pasang	Konsumsi	All	Menginstal paket ke dalam proyek saat ini tetapi tidak mengubah proyek atau file referensi.
daftar	Konsumsi, mungkin Penerbitan	All	Menampilkan paket dari sumber tertentu.
Cermin	Menerbitkan	Tidak digunakan lagi di 3.2+	Mencerminkan paket dan dependensinya dari sumber ke repositori target.
cari	Konsumsi	5.8+	Mencari sumber tertentu menggunakan string kueri yang disediakan.
Sumber	Konsumsi, Penerbitan	All	Mengelola sumber paket dalam file konfigurasi.
memperbarui	Konsumsi	All	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:

Peranan	Perintah
Konsumsi	config, , helpinstall, list, locals, restore, search, setapikey, , sources,update
Penciptaan	config, , helpinit, , pack,spec
Menerbitkan	add, , configdelete, help, list, push, , setapikey,sources

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

Nota

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).

Lokalisasi

NuGet.exepesan kemajuan, peringatan, dan 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.