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

  • Článek

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:

Instalace a používání balíčků pomocí rozhraní příkazového řádku dotnet