Краткое руководство. Установка и использование пакета с помощью dotnet CLI

  • Статья

Пакеты NuGet содержат скомпилированный двоичный код, который разработчики предоставляют другим разработчикам для использования в своих проектах. Дополнительные сведения см. в разделе "Что такое NuGet". В этом кратком руководстве описывается установка популярного пакета NuGet Newtonsoft.Json в проект .NET с помощью команды dotnet add package .

Вы ссылаетесь на установленные пакеты в коде с директивой using <namespace> , где <namespace> часто используется имя пакета. Затем вы можете использовать API пакета в проекте.

Совет

Просмотрите nuget.org/packages , чтобы найти пакеты, которые можно повторно использовать в собственных приложениях. Вы можете выполнять поиск непосредственно https://nuget.orgпо адресу или находить и устанавливать пакеты из Visual Studio. Дополнительные сведения см. в статье "Поиск и оценка пакетов NuGet" для проекта.

Необходимые компоненты

  • Пакет SDK для .NET, который предоставляет средство командной dotnet строки. Начиная с Visual Studio 2017, dotnet CLI автоматически устанавливается с любыми связанными рабочими нагрузками .NET или .NET Core.

Создание проекта

Пакеты NuGet можно установить в проект .NET. В этом пошаговом руководстве создайте простой проект консоли .NET с помощью dotnet CLI, как показано ниже.

  1. Создайте папку с именем Nuget.Quickstart для проекта.

  2. Откройте командную строку и перейдите в новую папку.

  3. Создайте проект с помощью следующей команды:

    dotnet new console

  4. Используется dotnet run для тестирования приложения. Вы увидите выходные данные Hello, World!.

Добавление пакета NuGet Newtonsoft.Json

  1. Чтобы установить пакет Newtonsoft.json, выполните следующую команду:

    dotnet add package Newtonsoft.Json

  2. После завершения команды откройте файл Nuget.Quickstart.csproj в Visual Studio, чтобы просмотреть добавленную ссылку на пакет NuGet:

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

Использование интерфейса API Newtonsoft.Json в приложении

  1. В Visual Studio откройте файл Program.cs и добавьте следующую строку в верхней части файла:

    using Newtonsoft.Json;

  2. Добавьте следующий код для замены инструкции 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. Сохраните файл, а затем создайте и запустите приложение с помощью dotnet run команды. Выходные данные — это представление Account объекта в коде в формате JSON:

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

Поздравляем! Вы установили пакет NuGet и поработали с ним.

Другие видео о NuGet см. на Channel 9 и YouTube.

Следующие шаги

Дополнительные сведения об установке и использовании пакетов NuGet с помощью dotnet CLI:

Установка и использование пакетов с помощью dotnet CLI