Alur kerja konsumsi paket
Antara galeri paket nuget.org dan privat yang mungkin dibuat organisasi Anda, Anda dapat menemukan puluhan ribu paket yang sangat berguna untuk digunakan di aplikasi dan layanan Anda. Tetapi terlepas dari sumbernya, mengkonsumsi paket mengikuti alur kerja umum yang sama.
* Visual Studio dan dotnet.exe hanya. Perintah nuget install tidak mengubah file proyek atau packages.config file; entri harus dikelola secara manual.
Untuk detail lebih lanjut, lihat Menemukan dan Memilih Paket dan Apa yang terjadi saat paket diinstal?.
NuGet mengingat identitas dan nomor versi dari setiap paket yang diinstal, merekamnya dalam file proyek (menggunakan PackageReference) atau packages.config, tergantung pada jenis proyek dan versi NuGet Anda. Dengan NuGet 4.0+, PackageReference lebih disukai, meskipun ini dapat dikonfigurasi dalam Visual Studio melalui UI Package Manager. Bagaimanapun, Anda dapat melihat file yang sesuai kapan saja untuk melihat daftar lengkap dependensi untuk proyek Anda.
Tip
Sangat bijaksana untuk selalu memeriksa lisensi untuk setiap paket yang ingin Anda gunakan dalam perangkat lunak Anda. Di nuget.org, Anda menemukan tautan Info Lisensi di sisi kanan halaman deskripsi setiap paket. Jika paket tidak menentukan ketentuan lisensi, hubungi pemilik paket secara langsung menggunakan tautan Pemilik kontak di halaman paket. Microsoft tidak melisensikan kekayaan intelektual apa pun kepada Anda dari penyedia paket pihak ketiga dan tidak bertanggung jawab atas informasi yang diberikan oleh pihak ketiga.
Saat menginstal paket, NuGet biasanya memeriksa apakah paket sudah tersedia dari cache-nya. Anda dapat menghapus cache ini secara manual dari baris perintah, seperti yang dijelaskan pada Mengelola paket global dan folder cache.
NuGet juga memastikan bahwa kerangka kerja target yang didukung oleh paket kompatibel dengan proyek Anda. Jika paket tidak berisi rakitan yang kompatibel, NuGet akan menampilkan kesalahan. Lihat Mengatasi kesalahan paket yang tidak kompatibel.
Saat menambahkan kode proyek ke repositori sumber, Anda biasanya tidak menyertakan paket NuGet. Mereka yang kemudian mengkloning repositori atau memperoleh proyek, termasuk agen build pada sistem seperti Visual Studio Team Services, harus memulihkan paket yang diperlukan sebelum menjalankan build:
Pemulihan Paket menggunakan informasi dalam file proyek atau packages.config untuk menginstal ulang semua dependensi. Perhatikan bahwa ada perbedaan dalam proses yang terlibat, seperti yang dijelaskan dalam Resolusi Dependensi. Selain itu, diagram di atas tidak menampilkan perintah pemulihan untuk Konsol Manajer Paket karena jika Anda menggunakan Konsol, Anda sudah dalam konteks Visual Studio, yang biasanya memulihkan paket secara otomatis dan menyediakan perintah tingkat solusi seperti yang ditunjukkan.
Terkadang perlu untuk menginstal ulang paket yang sudah disertakan dalam proyek, yang juga dapat menginstal ulang dependensi. Ini mudah dilakukan menggunakan nuget reinstall perintah atau Konsol Manajer Paket NuGet. Untuk detailnya, lihat Menginstal Ulang dan Memperbarui Paket.
Akhirnya, perilaku NuGet didorong oleh NuGet.Config file. Beberapa file dapat digunakan untuk memusatkan pengaturan tertentu pada tingkat yang berbeda, seperti yang dijelaskan dalam Mengonfigurasi Perilaku NuGet.
Cara menginstal Paket NuGet
Paket NuGet diunduh dan diinstal menggunakan salah satu metode dalam tabel berikut.
| Alat | Platform | Deskripsi |
|---|---|---|
| dotnet CLI | Semua | Alat CLI untuk pustaka .NET Core dan .NET Standard, dan untuk proyek bergaya SDK yang menargetkan .NET Framework (lihat atribut SDK). Mengambil paket yang diidentifikasi oleh <package_name> dan menambahkan referensi ke file proyek. Juga mengambil dan menginstal dependensi. |
| Visual Studio | Windows dan Mac | Menyediakan UI tempat Anda dapat menelusuri, memilih, dan menginstal paket dan dependensinya ke dalam proyek dari sumber paket tertentu. Menambahkan referensi ke paket yang diinstal ke file proyek. |
| Konsol Manajer Paket (Visual Studio) | Khusus Windows | Mengambil dan menginstal paket yang diidentifikasi oleh <package_name> dari sumber yang dipilih ke dalam proyek tertentu dalam solusi, lalu menambahkan referensi ke file proyek. Juga mengambil dan menginstal dependensi. |
| CLInuget.exe | Semua | Alat CLI untuk pustaka .NET Framework dan proyek gaya non-SDK yang menargetkan pustaka .NET Standard. Mengambil paket yang diidentifikasi oleh <package_name> dan memperluas kontennya ke dalam folder di direktori saat ini; juga dapat mengambil semua paket yang packages.config tercantum dalam file. Juga mengambil dan menginstal dependensi, tetapi tidak membuat perubahan pada file proyek atau packages.config. |