Udostępnij za pośrednictwem

Szybki start: instalowanie i używanie pakietu za pomocą interfejsu wiersza polecenia dotnet

  • Artykuł

Pakiety NuGet zawierają skompilowany kod binarny, który deweloperzy udostępniają innym deweloperom do użycia w swoich projektach. Aby uzyskać więcej informacji, zobacz Co to jest NuGet. W tym przewodniku Szybki start opisano sposób instalowania popularnego pakietu NuGet Newtonsoft.Json w projekcie platformy .NET przy użyciu polecenia dotnet add package .

Odwołujesz się do zainstalowanych pakietów w kodzie z dyrektywą using <namespace> , gdzie <namespace> często jest nazwą pakietu. Następnie możesz użyć interfejsu API pakietu w projekcie.

Napiwek

Przeglądaj nuget.org/packages , aby znaleźć pakiety, których można używać ponownie we własnych aplikacjach. Możesz wyszukiwać bezpośrednio w witrynie https://nuget.orglub znajdować i instalować pakiety z poziomu programu Visual Studio. Aby uzyskać więcej informacji, zobacz Znajdowanie i ocenianie pakietów NuGet dla projektu.

Wymagania wstępne

  • Zestaw .NET SDK, który udostępnia dotnet narzędzie wiersza polecenia. Począwszy od programu Visual Studio 2017, interfejs wiersza polecenia dotnet jest automatycznie instalowany z dowolnymi obciążeniami powiązanymi z platformą .NET lub .NET Core.

Tworzenie projektu

Pakiety NuGet można zainstalować w projekcie platformy .NET. W tym przewodniku utwórz prosty projekt konsoli platformy .NET przy użyciu interfejsu wiersza polecenia dotnet w następujący sposób:

  1. Utwórz folder o nazwie Nuget.Quickstart dla projektu.

  2. Otwórz wiersz polecenia i przejdź do nowego folderu.

  3. Utwórz projekt przy użyciu następującego polecenia:

    dotnet new console

  4. Użyj polecenia dotnet run , aby przetestować aplikację. Powinny zostać wyświetlone dane wyjściowe Hello, World!.

Dodawanie pakietu NuGet Newtonsoft.Json

  1. Użyj następującego polecenia, aby zainstalować Newtonsoft.json pakiet:

    dotnet add package Newtonsoft.Json

  2. Po zakończeniu polecenia otwórz plik Nuget.Quickstart.csproj w programie Visual Studio, aby wyświetlić dodane odwołanie do pakietu NuGet:

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

Korzystanie z interfejsu API Newtonsoft.Json w aplikacji

  1. W programie Visual Studio otwórz plik Program.cs i dodaj następujący wiersz w górnej części pliku:

    using Newtonsoft.Json;

  2. Dodaj następujący kod, aby zastąpić instrukcję Console.WriteLine("Hello, World!"); :

    namespace Nuget.Quickstart
{
    public class Account
    {
        public string? Name { get; set; }
        public string? Email { get; set; }
        public DateTime DOB { get; set; }
    }
    internal class Program
    {
        static void Main(string[] args)
        {
            Account account = new Account
            {
                Name = "John Doe",
                Email = "john@nuget.org",
                DOB = new DateTime(1980, 2, 20, 0, 0, 0, DateTimeKind.Utc),
            };

            string json = JsonConvert.SerializeObject(account, Formatting.Indented);
            Console.WriteLine(json);
        }
    }
}

  3. Zapisz plik, a następnie skompiluj i uruchom aplikację przy użyciu dotnet run polecenia . Dane wyjściowe to reprezentacja Account JSON obiektu w kodzie:

    {
  "Name": "John Doe",
  "Email": "john@nuget.org",
  "DOB": "1980-02-20T00:00:00Z"
}

Gratulacje dotyczące instalowania i używania pierwszego pakietu NuGet!

Więcej filmów NuGet można znaleźć w witrynach Channel 9 i YouTube.

Następne kroki

Dowiedz się więcej o instalowaniu i używaniu pakietów NuGet za pomocą interfejsu wiersza polecenia dotnet:

Instalowanie i używanie pakietów przy użyciu interfejsu wiersza polecenia dotnet