Menginstal alat klien untuk NuGet

  • Artikel

Ingin menginstal paket? Lihat Cara menginstal paket NuGet.

Untuk bekerja dengan NuGet sebagai konsumen atau pembuat paket, Anda dapat menggunakan alat antarmuka baris perintah (CLI) dan fitur NuGet di Visual Studio. Artikel ini secara singkat menguraikan kemampuan berbagai alat, cara menginstalnya, dan ketersediaan fitur komparatifnya.

Untuk mulai menggunakan NuGet untuk menggunakan paket, lihat artikel berikut ini:

Untuk mulai membuat paket NuGet, lihat artikel berikut ini:

Alat Deskripsi Unduh
dotnet SDK Alat CLI untuk pustaka .NET Core dan .NET Standard, dan untuk proyek gaya SDK apa pun seperti yang menargetkan .NET Framework. Alat CLI ini disertakan dengan .NET Core SDK dan menyediakan fitur NuGet inti di semua platform. Di Visual Studio 2017 dan yang lebih baru, CLI dotnet secara otomatis diinstal dengan beban kerja terkait .NET Core apa pun. .NET Core SDK
nuget.exe Alat CLI untuk pustaka .NET Framework dan untuk proyek gaya non-SDK apa pun seperti yang menargetkan pustaka .NET Standard. Alat CLI ini menyediakan semua kemampuan NuGet di Windows dan sebagian besar fitur di Mac dan Linux saat berjalan di bawah Mono. nuget.exe
Visual Studio Di Windows, Pengelola Paket NuGet disertakan dengan Visual Studio 2012 dan yang lebih baru. Visual Studio menyediakan UI Manajer Paket dan Konsol Manajer Paket (PowerShell di Windows). Anda dapat menggunakan alat-alat ini untuk menjalankan sebagian besar operasi NuGet. Visual Studio
Visual Studio untuk Mac Di Mac, kemampuan NuGet tertentu dibangun secara langsung. Konsol Manajer Paket saat ini tidak tersedia. Untuk kemampuan lain, gunakan alat dotnet SDK atau nuget.exe CLI. Visual Studio untuk Mac
Visual Studio Code Di Windows, Mac, dan Linux, kemampuan NuGet tersedia melalui ekstensi marketplace, atau menggunakan alat dotnet SDK atau nuget.exe CLI. Visual Studio Code

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.

MSBuild CLI juga memulihkan dan membuat paket. MSBuild bukan alat tujuan umum untuk bekerja dengan NuGet. Alat CLI ini terutama berguna pada server build.

Perintah Package Manager Console hanya berfungsi dalam Visual Studio di Windows dan tidak berfungsi dalam lingkungan PowerShell lainnya.

Visual Studio

Di Visual Studio 2017 dan yang lebih baru, alat penginstal Visual Studio menyertakan Manajer Paket NuGet dengan beban kerja apa pun yang menggunakan .NET.

Anda juga dapat menginstal Manajer Paket secara terpisah atau memverifikasi penginstalan Anda. Jalankan alat penginstal > Visual Studio dan centang pengaturan opsi di bawah Alat > Kode Komponen Individual pengelola paket NuGet. Untuk informasi selengkapnya, lihat Menginstal dan mengelola paket di Visual Studio dengan menggunakan NuGet Package Manager.

Catatan

Untuk versi Visual Studio yang lebih lama, Anda dapat mengunduh ekstensi NuGet di https://dist.nuget.org/index.html.

Alat CLI

Anda dapat menggunakan CLI dotnet atau nuget.exe CLI untuk mendukung fitur NuGet di Visual Studio IDE. CLI dotnet diinstal dengan beberapa beban kerja Visual Studio, seperti .NET Core. nuget.exe CLI harus diinstal secara terpisah seperti yang dijelaskan sebelumnya. Untuk perbandingan fitur alat, lihat bagian ketersediaan fitur.

  • Untuk menargetkan .NET Core atau .NET Standard, gunakan alat dotnet SDK CLI. CLI ini diperlukan untuk format proyek gaya SDK, yang menggunakan atribut SDK.

  • Untuk menargetkan .NET Framework (hanya proyek bergaya non-SDK), gunakan nuget.exe alat CLI. Jika proyek dimigrasikan dari packages.config ke PackageReference, gunakan alat dotnet SDK CLI sebagai gantinya.

dotnet SDK

Dotnet SDK adalah alat CLI .NET Core 2.0, yang berfungsi di semua platform (Windows, Mac, dan Linux) dan menyediakan fitur NuGet inti seperti menginstal, memulihkan, dan menerbitkan paket. Dotnet CLI menyediakan integrasi langsung dengan file proyek .NET Core (seperti .csproj), yang berguna dalam sebagian besar skenario. CLI ini juga dibangun langsung untuk setiap platform dan tidak memerlukan penginstalan Mono.

Menginstal dotnet SDK

Untuk mempelajari cara menggunakan perintah dasar dengan alat dotnet SDK CLI, lihat Menginstal dan mengelola paket NuGet dengan CLI dotnet.

nuget.exe CLI

NuGet CLI, nuget.exe, adalah utilitas baris perintah untuk Windows yang menyediakan semua kemampuan NuGet. CLI ini juga dapat berjalan di Mac OSX dan Linux dengan menggunakan Mono dengan beberapa batasan.

Untuk mempelajari cara menggunakan perintah dasar dengan nuget.exe alat CLI, lihat Mengelola paket NuGet dengan 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.

Ketersediaan fitur

Tabel berikut membandingkan fitur yang tersedia untuk alat dotnet dan nuget.exe CLI untuk platform yang didukung.

Fitur dotnet CLI nuget CLI (Windows) nuget CLI (Mono) Visual Studio (Windows) Visual Studio untuk Mac
Paket pencarian ✔ ✔ ✔ ✔
Pasang/hapus instalan paket ✔ ✔ (1) ✔ ✔ ✔
Perbarui paket ✔ ✔ ✔ ✔
Memulihkan paket ✔ ✔ ✔ (2) ✔ ✔
Mengelola umpan paket (sumber) ✔ ✔ ✔ ✔
Mengelola paket pada umpan ✔ ✔ ✔
Mengatur kunci API untuk umpan ✔ ✔
Membuat paket (3) ✔ ✔ ✔ (4) ✔
Menerbitkan paket ✔ ✔ ✔ ✔
Mereplikasi paket ✔ ✔
Mengelola folder paket global dan cache ✔ ✔ ✔
Mengelola konfigurasi NuGet ✔ ✔

Catatan fitur

  • (1) Tidak memengaruhi file proyek. Gunakan alat dotnet SDK CLI sebagai gantinya.
  • (2) Hanya berfungsi dengan packages.config file dan bukan dengan file solusi (.sln).
  • (3) Berbagai fitur paket tingkat lanjut tersedia melalui CLI hanya karena tidak diwakili dalam alat UI Visual Studio.
  • (4) Bekerja dengan .nuspec file tetapi tidak dengan file proyek.

Fitur yang akan datang

Jika Anda ingin mempratinjau fitur NuGet mendatang, instal Pratinjau Visual Studio, yang berfungsi berdampingan dengan rilis Visual Studio yang stabil. Untuk melaporkan masalah atau berbagi ide untuk pratinjau, buka masalah di repositori NuGet GitHub.

Pengembang yang bekerja di Windows juga dapat menjelajahi NuGet Package Explorer. Aplikasi ini adalah alat mandiri sumber terbuka yang memungkinkan Anda menjelajahi, membuat, dan mengedit paket NuGet secara visual. Sangat membantu untuk banyak skenario, seperti membuat perubahan eksperimental pada struktur paket tanpa membangun kembali paket.