Instalarea pachetelor Nuget

În loc să creăm propriile biblioteci și să definim funcționalitatea noastră, putem utiliza bibliotecile deja create de alți dezvoltatori și să le adăugăm în proiectul nostru. Pentru a gestiona bibliotecile externe sub formă de pachete separate, Microsoft oferă un manager de pachete special numit Nuget.

Fizic, un pachet NuGet reprezintă un singur fișier arhivă cu extensia .nupkg, care conține cod compilat sub formă de biblioteci dll și alte fișiere utilizate în cod. De asemenea, pachetul include o descriere sub formă de număr de versiune și informații auxiliare.

Pentru a simplifica lucrul cu pachetele și distribuirea lor, Microsoft a organizat un depozit global de pachete sub forma serviciului nuget.org. Dacă un dezvoltator dorește să împărtășească realizările sale, poate încărca codul sub formă de pachet Nuget în acest depozit, iar alți dezvoltatori pot descărca acest pachet și să-l utilizeze în programul lor.

Să vedem cum să instalăm pachetele Nuget și să le folosim în proiectul nostru. În primul rând, trebuie menționat că există diferite moduri de a instala pachete. În acest caz, vom examina instalarea pachetelor folosind .NET CLI și Visual Studio.

Instalarea pachetelor nuget folosind .NET CLI

Dacă compilăm aplicația direct folosind .NET CLI fără medii de dezvoltare precum Visual Studio, putem folosi instrumentele încorporate disponibile în .NET SDK.

De exemplu, vom crea un nou proiect de aplicație consolă folosind .NET CLI:

dotnet new console

Pentru exemplu, vom lua un pachet Nuget popular, cum ar fi Newtonsoft.Json, care este destinat lucrului cu codul json. Pentru aceasta, trecem în terminal la locația proiectului și executăm comanda:

dotnet add package Newtonsoft.Json

După comanda dotnet add package se specifică numele pachetului:

Dacă după aceasta deschidem fișierul de configurare a proiectului cu extensia csproj, vom găsi acolo elementul PackageReference, care reprezintă pachetul adăugat:

<ItemGroup>
   <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
</ItemGroup>

Aici vedem atributul Include, care indică numele pachetului pentru includerea în proiect, și atributul Version - versiunea pachetului.

Pachetul a fost adăugat, acum să-l folosim. Pentru aceasta, vom defini următorul cod al programului:

using Newtonsoft.Json;  // includem spațiul de nume din pachetul Newtonsoft.Json

Person tom = new Person("Tom", 38);
// serializăm obiectul tom în cod json
string json = JsonConvert.SerializeObject(tom);
Console.WriteLine(json);

class Person
{
   public string Name {get;set;}
   public int Age {get;set;}
   public Person(string name, int age)
   {
       Name = name;
       Age = age;
   }
}

Prin apelul metodei statice JsonConvert.SerializeObject(tom) serializăm obiectul tom în cod json și apoi afișăm acest cod pe consolă.

Rulăm proiectul cu comanda dotnet run și vedem rezultatul programului:

{"Name":"Tom","Age":38}

Astfel, am instalat pachetul Nuget în proiect și i-am folosit funcționalitatea în programul nostru. Dacă ulterior pachetul nu va mai fi necesar, îl putem elimina cu comanda:

dotnet remove package Newtonsoft.Json

După comanda dotnet remove package se specifică numele pachetului care se va elimina.

Instalarea pachetului în Visual Studio

Visual Studio are un set bogat de funcționalități pentru lucrul cu pachetele nuget. De exemplu, vom lua un simplu proiect de aplicație consolă și vom adăuga același pachet Newtonsoft.Json. Pentru aceasta, facem clic dreapta pe numele proiectului și în meniul contextual selectăm Manage NuGet Packages...:

Se va deschide managerul de pachete Nuget încorporat:

Pentru a simplifica căutarea pachetului dorit, introducem numele pachetului în câmpul de căutare. După aceasta, lista de pachete se va actualiza. De obicei, primul pachet din această listă este cel dorit. Dacă este necesar, în partea dreaptă putem vedea informații despre pachet.

Așadar, facem clic pe butonul Install pentru a-l instala. Apoi poate apărea o fereastră suplimentară pentru vizualizarea pachetelor care vor fi instalate:

După instalare, în structura proiectului va apărea un nod Packages cu pachetul instalat, iar în fișierul de configurare al proiectului va fi adăugată o înregistrare corespunzătoare:

Și acum vom putea folosi funcționalitatea pachetului în program.

Ca alternativă pentru adăugarea pachetelor, putem folosi Package Manager Console. Pentru aceasta, în meniul Visual Studio mergem la Tools -> NuGet Package Manager -> Package Manager Console. Și în fereastra Package Manager Console deschisă în partea de jos a Visual Studio, introducem comanda:

Install-Package Newtonsoft.Json

Formatul: după comanda Install-Package se specifică numele pachetului care se va instala.