Sdílet prostřednictvím


Rychlý start: Instalace a použití balíčku s rozhraním příkazového řádku dotnet

Balíčky NuGet obsahují zkompilovaný binární kód, který vývojáři zpřístupní ostatním vývojářům, aby je mohli používat ve svých projektech. Další informace najdete v tématu Co je NuGet. Tento rychlý start popisuje, jak pomocí příkazu dotnet add package nainstalovat oblíbený balíček NuGet Newtonsoft.Json do projektu . NET.

Odkazujete na nainstalované balíčky v kódu pomocí using <namespace> direktivy, kde <namespace> je často název balíčku. Pak můžete ve svém projektu použít rozhraní API balíčku.

Tip

Projděte si nuget.org/packages a vyhledejte balíčky, které můžete opakovaně používat ve svých vlastních aplikacích. Balíčky můžete vyhledat přímo v https://nuget.orgsadě Visual Studio nebo vyhledat a nainstalovat balíčky. Další informace najdete v tématu Vyhledání a vyhodnocení balíčků NuGet pro váš projekt.

Požadavky

  • Sada .NET SDK, která poskytuje nástroj příkazového dotnet řádku. Počínaje sadou Visual Studio 2017 se rozhraní příkazového řádku dotnet automaticky nainstaluje s libovolnými úlohami souvisejícími s .NET nebo .NET Core.

Vytvoření projektu

Balíčky NuGet můžete nainstalovat do projektu .NET. Pro účely tohoto názorného postupu vytvořte jednoduchý projekt konzoly .NET pomocí rozhraní příkazového řádku dotnet následujícím způsobem:

  1. Vytvořte složku s názvem Nuget.Quickstart pro projekt.

  2. Otevřete příkazový řádek a přepněte do nové složky.

  3. Pomocí následujícího příkazu vytvořte projekt:

    dotnet new console
    
  4. Slouží dotnet run k otestování aplikace. Měl by se zobrazit výstup Hello, World!.

Přidání balíčku NuGet Newtonsoft.Json

  1. K instalaci Newtonsoft.json balíčku použijte následující příkaz:

    dotnet add package Newtonsoft.Json
    
  2. Po dokončení příkazu otevřete soubor Nuget.Quickstart.csproj v sadě Visual Studio a podívejte se na přidaný odkaz na balíček NuGet:

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

Použití rozhraní API Newtonsoft.Json v aplikaci

  1. V sadě Visual Studio otevřete soubor Program.cs a do horní části souboru přidejte následující řádek:

    using Newtonsoft.Json;
    
  2. Přidejte následující kód pro nahrazení Console.WriteLine("Hello, World!"); příkazu:

    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. Uložte soubor a pak aplikaci sestavte a spusťte pomocí dotnet run příkazu. Výstupem je reprezentace objektu Account v kódu JSON:

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

Blahopřejeme k instalaci a použití prvního balíčku NuGet!

Další videa NuGet najdete na Webu Channel 9 a YouTube.

Další kroky

Další informace o instalaci a používání balíčků NuGet pomocí rozhraní příkazového řádku dotnet: