Package manager console как найти

Прежде чем приступить к разработке основного демонстрационного проекта, давайте рассмотрим один из инструментов, который поставляется совместно с ASP.NET MVC 3.

Задачи NuGet

Как было было отмечено в прошлой части, ASP.NET MVC 3 использует NuGet для работы с библиотеками. Этот инструмент позволяет упростить процесс их установки, обновления и, при необходимости, удаления.  Используя графический или консольный интерфейс, разработчику всего лишь необходимо дать соответствующую команду. NuGet самостоятельно:

• по названию найдет в интернете нужный установочный пакет;
• загрузит его с учетом зависимостей от других библиотек;
• распакует и проверит целостность;
• добавит в проект ссылки (reference) на сборки;
• при необходимости, модифицирует файлы конфигурации проекта.

Звучит внушительно?

Однако за всей этой простой можно упустить один очевидный, но очень важный момент: при обновлении библиотеки NuGet не проверяет совместимость новой версии и существующего кодом. Поэтому по прежнему необходимо читать описание изменений в библиотеке.

NuGet не является частью ASP.NET MVC 3 и может использоваться в проектах другого типа. При этом он может быть установлен как в Visual Studio 2010, так и в бесплатных версиях: Visual Web Developer 2010, Visual Studio C# Express.

При необходимости установить NuGet без ASP.NET MVC 3, его можно загрузить через менеджер дополнений Visual Studio или с официального сайта: http://nuget.codeplex.com/

Локальное хранилище установочных пакетов

Установленные библиотеки размещаются в отдельных папках, которые располагаются в папке packages. Последняя, в свою очередь, находится в корневой папке решения (solution).

Чтобы избежать повторной загрузки установочных пакетов, NuGet использует локальный кэш. Он создается отдельно для каждого пользователя операционной системы и размещается по адресу:
C:Users%userName%AppDataLocalNuGetCache.

Графический интерфейс «Add Library Package Reference»

Для использования графического интерфейса необходимо открыть диалоговое окно «Add Library Package Reference». Для этого в Solution Explorer или Solution Navigator в контекстном меню проекта нужно выбрать одноименный пункт. Кроме того, он также доступен в через подменю Project в главном меню Visual Studio.

В диалоговом окне NuGet слева расположен перечень раздел��в:

• Installed packages – содержит список установленных библиотек;
• Online – обеспечивает доступ к каталогу установочных пакетов;
• Updates – выводит список обновлений, доступных для установленных библиотек;
• Recent packages – перечисляет последние использованные установочные пакеты.

Для списков Online и Updates доступен выбор источников (т.е. сервера откуда будут взяты данные об установочных пактах). Изменить их перечень можно в окне настройки NuGet.

В центральной части выводится список доступных в данном разделе установочных пакетов. При выборе любого их них, рядом с его названием отображается кнопка действия: установить, обновить или удалить.

Справа доступно описание выбранной библиотеки. Обратите внимание, что кроме названия, автора, версии, рейтинга и описания также содержится список установочных пакетов от которых она зависит. В случае необходимости они также будут загружены вместе с ней.

Консоль «Package Manager Console»

Другим вариантом взаимодействия с NuGet является консоль. Она подойдет тем разработчикам, которым удобнее работать с командой строкой. Кроме того, она предоставляет больше возможностей, чем предыдущий вариант графическим интерфейсом.

Для того, чтобы открыть Package Manager Console можно воспользоваться меню View > Other Windows и выбрать в нем одноименный пункт. Также доступны другие варианты: Tools > Library Package Manager или кнопка на панели инструментов Visual Studio.

После загрузки и инициализации PowerShell, который используется для работы данного интерфейса, окно консоли будет выглядеть следующим образом:

В его верхней части расположены списки для указания источника данных и проекта по умолчанию. При этом для отдельной команды эти значения могут быть переопределены её параметрами.

Стоит отметить, что при вводе поддерживается завершение набранных команд и названий установочных пакетов. Для этого необходимо нажать кнопку Tab и NuGet отобразит список с возможными вариантами. В случае если вариант только один, то он сразу будет подставлен в вводимую строку.

Рассмотрим доступные команды и их параметры:

Вот несколько примеров:

• Get-Package -ListAvailable jQuery – выводит список всех доступных установочных пакетов, у которых в имени или описании есть текст «jQuery».
• Get-Package –ListAvailable -Skip 5 -First 10 jQuery – отображает перечень с 5 по 15 библиотеку, в названии которых содержится слово «jQuery».
• Get-Package -Update -Filter jQuery – отображает список обновлен��й, доступных для установленных проектов в названии которых содержится слово «jQuery».
• Install-Package jQue[нажатие кнопки «Tab»] – откроет окно подсказки с списком библиотек, имена которых начинаются с текста «jQue». Обратите внимание на возможность пропускать указание «–Id».
• Update-Package – обновляет все установочные пакеты во всех проектах текущего решения.
• Update-Package EntityFramework – обновляет пакет EntityFramework во всех проектах решения.
• Update-Package –ProjectName BookCatalog – обновляет все пакеты в проекте BookCatalog.
• Update-Package EntityFramework -ProjectName BookCatalog – обновит библиотеку EntityFramework в только проекте BookCatalog.

Кроме того NuGet позволяет создавать собственные источники и установочные пакеты. Это упрощает размещение своих проектов в интернете и создание локальных репозиториев. Подробно эти возможности рассмотрены в серии статей «Использование NuGet». Ну а в следующей части приступим к разработке демонстрационного проекта.

Официальный сайт проекта: https://www.nuget.org/

NuGet Manager – это инструмент, который помогает разработчику управлять сторонними библиотеками (пакетами) в своем проекте.

Под управлением подразумевается поиск, скачивание, установка, настройка, обновление и удаление файлов сторонних разработчиков у себя в приложении.

Технически NuGet Manager представляет собой расширение для Visual Studio, доступное программисту в процессе работы над своим проектом. Если вы используете «студию» версии 2012 и выше, то NuGet уже заранее предустановлен и готов к работе. В случае версии 2010 его нужно установить вручную. Его можно скачать либо с официального сайта, либо установить напрямую из Visual Studio через менеджер дополнений.

Давайте откроем менеджер. Для этого в Solution Explorer щелкаем правой кнопкой мыши по рабочему проекту и в контекстном меню выбираем пункт «Manage NuGet Packages…»:

NuGet Manager открывается в новой вкладке в текстовом редакторе. Интерфейс у него довольно простой.

Три главные вкладки:

1. Browse. Найти и установить нужные нам пакеты из хранилища NuGet
2. Installed. Список уже установленных в нашем проекте библиотек
3. Updates. Библиотеки в нашем проекте, которые можно обновить до новой версии

Также в интерфейсе менеджера представлены:

1. Строка поиска. Мы можем искать нужную нам библиотеку, начав вводить ее название
2. Кнопка «Обновить состояние окна»
3. Галочка «Включать в выдачу предрелизные версии библиотек», например, какие-то тестовые или экспериментальные
4. Выпадающий список Package source. В каком месте менеджер будет искать нужные нам библиотеки
5. Кнопка «Настройки менеджера»
6. Главная панель с результатами выдачи (слева)
7. Панель с описанием того компонента, который мы выбрали (справа)

Попробуем установить какую-нибудь библиотеку к нам в проект, например, Entity Framework. Для этого переходим во вкладку Browse и в строке поиска начинаем вводить название нужного пакета. Далее выбираем его из списка и нажимаем кнопку Install. При необходимости можно выбрать определенную версию, отличную от стабильной последней, а также ознакомиться с информацией о данном пакете (авторы, лицензия и т.д.).

В зависимости от устанавливаемого пакета NuGet Manager также определит все его зависимости, или, другими словами, все дополнительные библиотеки, которые требуются устанавливаемому пакету для полноценной работы. В случае с Entity Framework таких зависимостей нет.

Теперь давайте более детально посмотрим, что конкретно сделал менеджер при установке этого компонента в наш проект:
1. Он определил, что для данного пакета нет никаких сторонних зависимостей. Если бы они были, то менеджер автоматически их определил и подтянул.
2. NuGet Manager добавил ссылку на установленный компонент в наш проект (References):

3. NuGet разместил скачанные файлы в специальной папке Packages, которая находится в корневой папке нашего приложения. Это очень удобно, ссылки в проекте теперь идут на эту папку:

4. В конфигурационный файл packages.config была добавлена запись о новом пакете:

5. В конфигурационный файл приложения web.config также были внесены необходимые изменения, чтобы подготовить компонент Entity Framework к работе:
 

<entityFramework>
    <defaultConnectionFactory type="System.Data.Entity.Infrastructure.LocalDbConnectionFactory, EntityFramework">
      <parameters>
        <parameter value="mssqllocaldb"/>
      </parameters>
    </defaultConnectionFactory>
    <providers>
      <provider invariantName="System.Data.SqlClient" type="System.Data.Entity.SqlServer.SqlProviderServices, EntityFramework.SqlServer"/>
    </providers>
  </entityFramework>

Вот такие операции происходят, когда NuGet Manager добавляет новую библиотеку к нам в проект.

Подобным образом происходит и обновление, и удаление компонентов из нашего проекта. В случае удаления менеджер также автоматически вносит изменения в файлы нашего проекта – убирает записи из файла packages.config, удаляет соответствующие файлы в папке packages, убирает ссылки на эти библиотеки.

Давайте рассмотрим еще несколько моментов.

С NuGet Manager можно работать не только через графический интерфейс, но и через командную строку (консоль). Чтобы ее открыть, идем Tools -> NuGet Package Manager -> Package Manager Console.

Работа в консоли ничем не отличается от работы в графическом интерфейсе, это дело вкуса.

Управление осуществляется посредством специальных команд. Чтобы вывести в консоль список всех доступных команд нужно написать инструкцию:

Команд достаточно много, и описание каждой можно найти в официальной документации на сайте. Вот пример использования наиболее популярных команд.

Добавляем пакет Entity Framework в текущий проект:

Обновляем ранее установленный пакет:

Переустанавливаем ВСЕ пакеты во всех проектах в данном решении:

Вы также можете создать и опубликовать свой собственный пакет в репозиторий nuget.org, тем самым сделав его публичным и доступным через NuGet Manager. Для этого нужно соблюсти ряд правил и условий, а также правильно подготовить свой проект к публикации. Опять же всю информацию об этом можно найти в официальной документации.

Подведем краткий итог. NuGet – это просто незаменимый инструмент для разработчика на сегодняшний день. Он автоматизирует весь процесс работы с пакетами в проекте, а именно поиск, скачивание, установка, настройка, обновление и удаление файлов.

В видео версии этого урока более подробно и наглядно показана работа с этим инструментом.

Последнее обновление: 12.11.2022

Вместо создания своих собственных библиотек и определения своего собственного функционала мы можем использовать уже ранее созданные другими разработчиками библиотеки и
добавить их свой проект. Для управления внешними библиотеками в виде отдельных пакетов Microsoft предоставляет специальный менеджер пакетов под названием Nuget.

Физически NuGet-пакет представляет единый архивный файл с расширением .nupkg, который содержит скомпилированный код в виде библиотек dll и других файлов, используемых в коде.
Также пакет включает некоторое описание в виде номера версии и вспомогательной информации.

Для упрощения работы с пакетами, их распространенния Microsoft организовал глобальный репозиторий пакетов в виде сервиса nuget.org. И если разработчик хочет поделиться
своими наработками, он может загрузить свой код в виде Nuget-пакета в этот репозиторий, а другие разработчики могут скачать этот пакет и использовать его в свой программе.
Посмотрим, как устанавливать Nuget-пакеты и использовать их в своем проекте. Прежде всего стоит отметить, что есть различные способы установки пакетов. В данном случае рассмотрим установку пакетов
с помощью .NET CLI и в Visual Studio.

Установка nuget-пакетов с помощью .NET CLI

Если мы компилируем приложение непосредственно с помощью .NET CLI без каких-нибудь сред разработки типа Visual Studio, то мы можем воспользоваться встроенными инструментами,
которые имеются в .NET SDK.

Для примера создадим с помощью .NET CLI новый проект консольного приложения:

Для примера возьмем такой популярный Nuget-пакет как Newtonsoft.Json, который предназначен для работы с кодом json. Для этого перейдем в терминале к расположению проекта и выполним команду:

dotnet add package Newtonsoft.Json

После команды dotnet add package указывается имя пакета:

если после этого мы откроем файл конфигурации проекта с расширением csproj, то встретим там элемент
PackageReference, который представляет добавленный пакет

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

Здесь мы видим атрибут Include, который указывает на название пакета для включения в проект, и атрибут Version — версию пакета.

Пакет добавили, теперь используем его. Для этого определим следующий код программы:

using Newtonsoft.Json;  // подключаем пространство имен из пакета Newtonsoft.Json

Person tom = new Person("Tom", 38);
// сериализуем объект tom в код 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;
    }
}

С помощью вызова статического метода JsonConvert.SerializeObject(tom) сериализуем объект tom в код json и потом этот код выводим на консоль.

Запустим проект командой dotnet run и посмотрим на результат программы:

Таким образом, мы установили в проект Nuget-пакет и использовали его функциональность в своей программе. Если впоследствии пакет станет не нужен,
то его можно удалить командой:

dotnet remove package Newtonsoft.Json

После команды dotnet remove package указывается название удаляемого пакета.

Установка пакета в Visual Studio

Visual Studio обладает богатым функционалом в плане работы с nuget-пакетами. Так, возьмем также простейший проект консольного приложения и добавим в него тот же пакет
Newtonsoft.Json. Для этого нажмем правой кнопкой на название проекта и в контекстном меню выберем Manage NuGet Packages…:

Нам откроется встроенный менеджер пакетов Nuget:

Для упрощения поиска нужного пакета введем название пакета в поле поиска. После этого список пакетов обновится. И обычно первый пакет в этом списке тот, который нужен.
При необходимости в правой части мы можем посмотреть информацию о пакете.

Итак, нажмем на кнопку Install для его установки. Далее может отобразиться дополнительное окно для просмотра пакетов, которые непосредственно будут установлены:

После установки в структуре проекта появится узел Packages с установленным пакетом, и соответствующая запись будет внесена в файл конфигурации проекта:

И теперь мы также сможем использовать функциональность пакета в программе.

В качестве альтернативы для добавления пакетов можно использовать Package Manager Console.
Для этого в меню Visual Studio перейдем к пункту Tools -> NuGet Package Manager -> Package Manager Console. И в открывшемся внизу в
Visual Studio окне Package Manager Console введем команду:

Install-Package Newtonsoft.Json

Формат: после команды Install-Package указывается название устанавливаемого пакета.