Меню

Package manager console visual studio 2019 как найти

Управление пакетами с помощью консоли диспетчера пакетов Visual Studio (PowerShell)

Консоль диспетчера пакетов в Visual Studio использует команды PowerShell для взаимодействия с пакетами NuGet. Консоль можно использовать, если невозможно выполнить операцию с помощью пользовательского интерфейса диспетчера пакетов. Вы также можете использовать команды dotnet CLI или NuGet CLI в консоли.

В этой статье описывается, как найти, установить, обновить и удалить пакеты NuGet с помощью команд PowerShell в консоли диспетчера пакетов. Полный справочник по команде powerShell консоли диспетчера пакетов см. в справочнике по PowerShell.

Команды и аргументы PowerShell в этой статье относятся к консоли диспетчера пакетов Visual Studio. Эти команды отличаются от команд модуля PackageManagement , которые можно использовать в общей среде PowerShell. В каждой среде есть команды, недоступные в другой среде, и команды с одинаковым именем могут отличаться в своих конкретных аргументах.

Доступность консоли

Начиная с Visual Studio 2017, NuGet и диспетчер пакетов NuGet устанавливаются автоматически при создании любого. Рабочие нагрузки, связанные с NET, в Visual Studio. Кроме того, диспетчер пакетов можно установить, выбравдиспетчер пакетов NuGetотдельных> > компонентов в Visual Studio Installer.

Вы также можете найти расширение диспетчера пакетов NuGet в меню «Расширения инструментов>» и Обновления или «Расширения«. Если вы не можете использовать установщик расширений в Visual Studio, скачайте расширение отсюда: https://dist.nuget.org/index.html.

Консоль диспетчера пакетов встроена в диспетчер пакетов для Visual Studio в Windows. Visual Studio Code и Visual Studio для Mac не включают консоль. Visual Studio для Mac имеет пользовательский интерфейс для управления пакетами NuGet, а эквивалентные команды консоли доступны через интерфейс командной строки NuGet. Дополнительные сведения см. в статье об установке пакетов NuGet и управлении ими в Visual Studio для Mac.

Быстрый поиск и установка пакета

Чтобы быстро найти и установить пакет с помощью консоли диспетчера пакетов, выполните следующие действия.

Откройте проект или решение в Visual Studio и выберите «Сервис>» диспетчерпакетов Диспетчер пакетовNuGet>, чтобы открыть окно консоли диспетчера пакетов.

В консоли введите Find-Package ключевое слово, чтобы найти пакет, который требуется установить. Например, чтобы найти пакеты, содержащие ключевое слово elmah , выполните следующую команду. Если вы уже знаете имя пакета, пропустите этот шаг.

Найдя имя, используйте Install-Package команду для установки пакета. Например, чтобы установить Elmah.MVC пакет, введите:

Дополнительные сведения об этих командах см. в разделах » Поиск пакета » и «Установка пакета «.

Многие операции консоли зависят от наличия решения с именем известного пути, открытого в Visual Studio. Если у вас есть несохраняемое решение или нет решения, вы увидите, что решение об ошибке не открыто или не сохранено. Убедитесь, что у вас есть открытое и сохраненное решение. Чтобы исправить ошибку, создайте и сохраните решение или сохраните несохраненные решения.

Элементы управления консолью

Чтобы открыть консоль диспетчера пакетов в Visual Studio, выберите пункт «Сервис>» диспетчерапакетовNuGet> в верхнем меню. Консоль — это окно Visual Studio, которое можно упорядочить и разместить по мере того, как вам нравится. Дополнительные сведения см. в статье Настройка макетов окон в Visual Studio.

По умолчанию команды консоли работают с определенным источником пакета и проектом, отображаемыми в элементах управления в верхней части окна:

Выбор другого источника пакета или проекта изменяет значения по умолчанию для последующих команд. Чтобы переопределить эти параметры для отдельных команд без изменения значений по умолчанию, большинство команд консоли поддерживают -Source и -ProjectName параметры.

Чтобы управлять источниками пакетов, щелкните значок шестеренки, который открывает диалоговое окно «Параметры>инструментовдиспетчера>пакетов NuGet. Элемент управления рядом с селектором проекта очищает содержимое консоли.

Кнопка в крайнем правом углу прерывает долго выполняющуюся команду. Например, при выполнении Get-Package -ListAvailable -PageSize 500 перечислены 500 доступных пакетов в источнике по умолчанию, например nuget.org, что может занять несколько минут.

Поиск пакета

Чтобы найти пакет в источнике по умолчанию, используйте Find-Package.

Чтобы найти и получить список пакетов, содержащих определенные ключевые слова, выполните следующие действия.

Чтобы найти и получить список пакетов, имена которых начинаются со строки:

По умолчанию Find-Package возвращается список из 20 пакетов. Используется -First для отображения дополнительных пакетов. Например, чтобы отобразить первые 100 пакетов, используйте следующую команду:

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

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

Чтобы установить пакет в проект по умолчанию, используйте Install-Package

. Команда консоли Install-Package выполняет следующие действия:

  • Выполняет действия, описанные в разделе «Что происходит при установке пакета NuGet».
  • Отображает применимые условия лицензии в окне консоли с подразумеваемым соглашением. Если вы не согласны с условиями, удалите пакет.
  • Добавляет ссылку на пакет в файле проекта и в Обозреватель решений в узле «Ссылки«. Перед просмотром изменений в файле проекта необходимо сохранить проект.

По умолчанию добавляет пакет в проект по умолчанию, Install-Package задается окно консоли. Чтобы добавить пакет в проект, который не является значением по умолчанию, используйте -ProjectName этот параметр. Например, чтобы добавить пакет в проект, отличный Elmah.MVC от по умолчанию UtilitiesLib , выполните следующую команду:

Удаление пакета

Чтобы удалить пакет из проекта по умолчанию, используйте Uninstall-Package

. Если вам нужно найти имя пакета, используйте команду Get-Package , чтобы просмотреть все пакеты, установленные в проекте по умолчанию.

Удаление пакета выполняет следующие действия:

  • Удаляет ссылки на пакет из проекта и любые форматы управления. Ссылки больше не отображаются в обозревателе решений Возможно, потребуется перестроить проект, чтобы удалить ссылку в папке bin .
  • Отменяет любые изменения, устанавливающие пакет в app.config или web.config.
  • Удаляются ранее установленные зависимости, если остальные пакеты не используют эти зависимости.

Чтобы удалить пакет и все его неиспользуемые зависимости, выполните следующую команду:

Чтобы удалить пакет, даже если другие пакеты зависят от него, выполните следующую команду:

Обновление пакета

Чтобы обновить пакет, используйте get-Package и Update-Package. Вы можете выполнить следующие команды:

Чтобы проверить наличие новых версий, доступных для всех установленных пакетов, выполните следующие действия.

Чтобы обновить конкретный пакет, выполните указанные действия.

Чтобы обновить все пакеты в проекте, выполните приведенные далее действия.

Чтобы обновить все пакеты в решении, выполните следующие действия.

Использование интерфейса командной строки NuGet в консоли

Вы также можете выполнять большинство операций консоли с помощью интерфейса командной строки NuGet. Однако команды консоли PowerShell работают в контексте сохраненного проекта и решения Visual Studio и часто выполняют больше, чем эквивалентные команды Интерфейса командной строки NuGet. Например, установка пакета с помощью Install-Package добавления ссылки на файл проекта, но команда NuGet CLI не выполняется. По этой причине разработчики, работающие в Visual Studio, обычно предпочитают использовать команды консоли, а не интерфейс командной строки NuGet.

Чтобы использовать команды интерфейса командной строки NuGet в консоли диспетчера пакетов, установите пакет NuGet.CommandLine .

Предыдущая команда устанавливает последнюю версию интерфейса командной строки NuGet. Чтобы установить определенную версию, используйте -Version этот параметр. Например, чтобы установить версию 4.4.1, введите:

После установки NuGet.CommandLine пакета можно выполнить все команды интерфейса командной строки NuGet через консоль диспетчера пакетов.

Расширение консоли диспетчера пакетов

Некоторые пакеты устанавливают новые команды для консоли. Например, создаются такие команды, MvcScaffolding как Scaffold создание ASP.NET контроллеров и представлений MVC:

Настройка профиля PowerShell NuGet

Вы можете создать профиль PowerShell, чтобы сделать часто используемые команды доступными во всех контекстах PowerShell, чтобы не потерять параметры PowerShell между сеансами. NuGet поддерживает профиль NuGet, обычно в %UserProfile%\Documents\WindowsPowerShell\NuGet_profile.ps1.

Чтобы найти расположение профиля пользователя, введите $profile в консоли:

Чтобы определить, существует ли профиль в этом расположении, введите test-path $profile . Если команда возвращается False , необходимо создать профиль с указанным именем в этом расположении. Дополнительные сведения см. в разделе «Профили Windows PowerShell».

Источник статьи: http://learn.microsoft.com/ru-ru/nuget/consume-packages/install-use-packages-powershell

Manage packages with the Visual Studio Package Manager Console (PowerShell)

The Package Manager Console in Visual Studio uses PowerShell commands to interact with NuGet packages. You can use the console when there’s no way to do an operation through the Package Manager UI. You can also use dotnet CLI or NuGet CLI commands in the console.

This article describes how to find, install, update, and uninstall NuGet packages with PowerShell commands in the Package Manager Console. For the complete Package Manager Console PowerShell command reference, see PowerShell reference.

The PowerShell commands and arguments in this article are specific to the Visual Studio Package Manager Console. These commands differ from the PackageManagement module commands you can use in a general PowerShell environment. Each environment has commands that aren’t available in the other, and commands with the same name might differ in their specific arguments.

Console availability

Starting in Visual Studio 2017, NuGet and the NuGet Package Manager install automatically when you create any .NET-related workloads in Visual Studio. You can also install the Package Manager by selecting Individual components > Code tools > NuGet package manager in the Visual Studio Installer.

You can also search for the NuGet Package Manager extension under the Tools > Extensions and Updates or Extensions menus. If you’re unable to use the extensions installer in Visual Studio, you can download the extension directly from https://dist.nuget.org/index.html.

The Package Manager Console is built into the Package Manager for Visual Studio on Windows. Visual Studio Code and Visual Studio for Mac don’t include the console. Visual Studio for Mac has a UI for managing NuGet packages, and the equivalent console commands are available through the NuGet CLI. For more information, see Install and manage NuGet packages in Visual Studio for Mac.

Quickly find and install a package

To use the Package Manager Console to quickly find and install a package:

Open your project or solution in Visual Studio, and select Tools > NuGet Package Manager > Package Manager Console to open the Package Manager Console window.

In the console, enter Find-Package with a keyword to find the package you want to install. For example, to find packages that contain the keyword elmah , run the following command. If you already know the package name you want, skip this step.

Once you find the name, use the Install-Package command to install the package. For example, to install the Elmah.MVC package, enter:

For more details about these commands, see the Find a package and Install a package sections.

Many console operations depend on having a solution with a known path name open in Visual Studio. If you have an unsaved solution, or no solution, you see the error Solution is not opened or not saved. Please ensure you have an open and saved solution. To correct the error, create and save a solution, or save an unsaved solution.

Console controls

To open the Package Manager Console in Visual Studio, select Tools > NuGet Package Manager > Package Manager Console from the top menu. The console is a Visual Studio window that you can arrange and position as you like. For more information, see Customize window layouts in Visual Studio.

By default, console commands operate against the specific package source and project shown in the controls at the top of the window:

Selecting a different package source or project changes the defaults for subsequent commands. To override these settings for single commands without changing the defaults, most console commands support -Source and -ProjectName options.

To manage package sources, select the gear icon, which opens the Tools > Options > NuGet Package Manager > Package Sources dialog box. The control next to the project selector clears the console’s contents.

The button on the far right interrupts a long-running command. For example, running Get-Package -ListAvailable -PageSize 500 lists the top 500 available packages on the default source, such as nuget.org, which could take several minutes.

Find a package

To find a package in the default source, use Find-Package.

To find and list packages that contain certain keywords:

To find and list packages whose name begins with a string:

By default, Find-Package returns a list of 20 packages. Use -First to show more packages. For example, to show the first 100 packages, use:

To list all versions of a certain package:

Install a package

To install a package into the default project, use Install-Package

. The Install-Package console command takes the following actions:

  • Does the steps in What happens when a NuGet package is installed.
  • Displays applicable license terms in the console window with implied agreement. If you don’t agree to the terms, you should uninstall the package.
  • Adds a reference to the package in the project file and in Solution Explorer under the References node. You must save the project before you can see the changes in the project file.

By default, Install-Package adds the package to the default project the console window specifies. To add the package to a project that isn’t the default, use the -ProjectName option. For example, to add the Elmah.MVC package to the non-default UtilitiesLib project, run the following command:

Uninstall a package

To uninstall a package from the default project, use Uninstall-Package

. If you need to find the package name, use Get-Package to see all packages installed in the default project.

Uninstall-Package takes the following actions:

  • Removes references to the package from the project and any management formats. References no longer appear in Solution Explorer. You might need to rebuild the project to remove the reference in the bin folder.
  • Reverses any changes that installing the package made to app.config or web.config.
  • Removes previously-installed dependencies if no remaining packages use those dependencies.

To uninstall a package and all its unused dependencies, run:

To uninstall a package even if other packages depend on it, run:

Update a package

To update a package, use Get-Package and Update-Package. You can run the following commands:

To check if there are newer versions available for any installed packages:

To update a specific package:

To update all packages in a project:

To update all packages in the solution:

Use the NuGet CLI in the console

You can also do most console operations with the NuGet CLI. However, the PowerShell console commands operate within the context of Visual Studio saved project and solution, and often do more than their equivalent NuGet CLI commands. For example, installing a package through Install-Package adds a reference to the project file, but the NuGet CLI command doesn’t. For this reason, developers working in Visual Studio typically prefer to use the console commands rather than the NuGet CLI.

To use NuGet CLI commands in the Package Manager Console, install the NuGet.CommandLine package.

The preceding command installs the latest version of the NuGet CLI. To install a specific version, use the -Version option. For example, to install Version 4.4.1, enter:

After you install the NuGet.CommandLine package, you can run all NuGet CLI commands through the Package Manager Console.

Extend the Package Manager Console

Some packages install new commands for the console. For example, MvcScaffolding creates commands like Scaffold , which generates ASP.NET MVC controllers and views:

Set up a NuGet PowerShell profile

You can create a PowerShell profile to make your commonly-used commands available in all PowerShell contexts, so you don’t lose your PowerShell settings between sessions. NuGet supports a NuGet-specific profile, usually at %UserProfile%\Documents\WindowsPowerShell\NuGet_profile.ps1.

To find your user profile location, enter $profile in the console:

To determine whether a profile exists at that location, enter test-path $profile . If the command returns False , you need to create the profile with the specified name at that location. For more information, see Windows PowerShell Profiles.

Источник статьи: http://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-powershell

Quickstart: Install and use a NuGet package in Visual Studio (Windows only)

A NuGet package contains reusable code that other developers have made available to you for use in your projects. You can install a NuGet package in a Microsoft Visual Studio project by using the NuGet Package Manager, the Package Manager Console, or the .NET CLI. This article demonstrates how to create a Windows Presentation Foundation (WPF) project with the popular Newtonsoft.Json package. The same process applies to any other .NET or .NET Core project.

After you install a NuGet package, you can then make a reference to it in your code with the using statement, where is the name of package you’re using. After you’ve made a reference, you can then call the package through its API.

The article is for Windows users only. If you’re using Visual Studio for Mac, see Install and use a package in Visual Studio for Mac.

To find a NuGet package, start with nuget.org. Browsing nuget.org is how .NET developers typically find components they can reuse in their own applications. You can do a search of nuget.org directly or find and install packages within Visual Studio as shown in this article. For more information, see Find and evaluate NuGet packages.

Prerequisites

Install Visual Studio 2022 for Windows with the .NET desktop development workload.

You can install the 2022 Community edition for free from visualstudio.microsoft.com, or use the Professional or Enterprise edition.

Create a project

You can install a NuGet package into any .NET project if that package supports the same target framework as the project. However, for this quickstart you’ll create a Windows Presentation Foundation (WPF) Application project.

In Visual Studio, select File > New > Project.

In the Create a new project window, enter WPF in the search box and select C# and Windows in the dropdown lists. In the resulting list of project templates, select WPF Application, and then select Next.

In the Configure your new project window, optionally update the Project name and the Solution name, and then select Next.

In the Additional information window, select .NET 6.0 (or the latest version) for Framework, and then select Create.

Visual Studio creates the project, and it appears in Solution Explorer.

Add the Newtonsoft.Json NuGet package

To install a NuGet package in this quickstart, you can use either the NuGet Package Manager or the Package Manager Console. Depending on your project format, the installation of a NuGet package records the dependency in either your project file or a packages.config file. For more information, see Package consumption workflow.

NuGet Package Manager

To use the NuGet Package Manager to install the Newtonsoft.Json package in Visual Studio, follow these steps:

Select Project > Manage NuGet Packages.

In the NuGet Package Manager page, choose nuget.org as the Package source.

From the Browse tab, search for Newtonsoft.Json, select Newtonsoft.Json in the list, and then select Install.

If you’re prompted to verify the installation, select OK.

Package Manager Console

Alternatively, to use the Package Manager Console in Visual Studio to install the Newtonsoft.Json package, follow these steps:

From Visual Studio, select Tools > NuGet Package Manager > Package Manager Console.

After the Package Manager Console pane opens, verify that the Default project drop-down list shows the project in which you want to install the package. If you have a single project in the solution, it’s preselected.

At the console prompt, enter the command Install-Package Newtonsoft.Json . For more information about this command, see Install-Package.

The console window shows the output for the command. Errors typically indicate that the package isn’t compatible with the project’s target framework.

Use the Newtonsoft.Json API in the app

With the Newtonsoft.Json package in the project, call its JsonConvert.SerializeObject method to convert an object to a human-readable string:

From Solution Explorer, open MainWindow.xaml and replace the existing element with the following code:

Open the MainWindow.xaml.cs file under the MainWindow.xaml node, and insert the following code inside the MainWindow class after the constructor:

To avoid an error for the JsonConvert object in the code (a red squiggle line will appear), add the following statement at the beginning of the code file:

To build and run the app, press F5 or select Debug > Start Debugging.

The following window appears:

Select the Click Me button to see the contents of the TextBlock object replaced with JSON text.

Related video

See also

For more information about NuGet, see the following articles:

Next steps

Congratulations on installing and using your first NuGet package. Advance to the next article to learn more about installing and managing NuGet packages.

Источник статьи: http://learn.microsoft.com/en-us/nuget/quickstart/install-and-use-a-package-in-visual-studio

Name already in use

docs.microsoft.com-nuget.ru-ru / docs / consume-packages / install-use-packages-powershell.md

1 contributor

Users who have contributed to this file

Установка пакетов и управление ими с помощью консоли диспетчера пакетов в Visual Studio (PowerShell)

Консоль диспетчера пакетов NuGet позволяет использовать команды PowerShell NuGet для поиска, установки, удаления и обновления пакетов NuGet. Это удобно, когда пользовательский интерфейс диспетчера пакетов не позволяет выполнять операции. См. подробнее об использовании CLI nuget.exe в консоли.

Консоль встроена в Visual Studio для Windows. Она не включена в Visual Studio для Mac и Visual Studio Code.

[!Important] Перечисленные здесь команды относятся только к консоли диспетчера пакетов в Visual Studio и отличаются от команд модуля «Управление пакетами», доступных в общей среде PowerShell. В частности, в каждой среде есть команды, недоступные в другой среде, а в командах с тем же именем могут отличаться некоторые аргументы. При использовании консоли «Управление пакетами» в Visual Studio применяются команды и аргументы, описанные в этой статье.

Для поиска и установки пакета необходимо выполнить три простых шага:

Откройте проект или решение в Visual Studio, а затем откройте консоль, щелкнув Средства > Диспетчер пакетов NuGet > Консоль диспетчера пакетов.

Найдите пакет, который требуется установить. Если вы уже знакомы с этим процессом, перейдите к шагу 3.

Выполните команду установки:

[!Important] Все операции, доступные в консоли, также можно выполнить с помощью CLI NuGet. Но команды консоли работают в контексте Visual Studio и сохраненного проекта или решения, и область их применения часто шире, чем у их эквивалентов в CLI. Например, при установке пакета с помощью консоли добавляется ссылка на проект, а при использовании команды CLI этого не происходит. По этой причине разработчики, работающие в Visual Studio, обычно предпочитают использовать консоль вместо CLI.

[!Tip] Многие операции консоли зависят от наличия решения, открытого в Visual Studio с использованием известного имени пути. Если у вас нет решения или оно не сохранено, отобразится сообщение об ошибке «Решение не открыто или не сохранено. Убедитесь, что вы открыли и сохранили решение». Это означает, что консоль не может определить папку решения. Эту ошибку можно исправить, сохранив несохраненное решение или создав и сохранив решение, если оно не открыто.

Открытие консоли и элементов управления консоли

Откройте консоль в Visual Studio, щелкнув Средства > Диспетчер пакетов NuGet > Консоль диспетчера пакетов. Консоль — это окно Visual Studio, которое может быть упорядочено и размещено по вашему усмотрению (см. руководство по настройке макетов окон в Visual Studio).

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

Выбор другого источника пакета или проекта изменяет эти значения по умолчанию для последующих команд. Чтобы переопределить эти настройки, не меняя значения по умолчанию, большинство команд поддерживают параметры -Source и -ProjectName .

Чтобы управлять источниками пакетов, щелкните значок шестеренки. Это ярлык для диалогового окна Средства > Параметры > Диспетчер пакетов NuGet > Источники пакетов, как описано на странице, посвященной пользовательскому интерфейсу диспетчера пакетов. Кроме того, элемент управления справа от средства выбора проектов очищает содержимое консоли.

Крайняя правая кнопка прерывает команду, которая выполняется в течение долгого периода времени. Например, выполнение Get-Package -ListAvailable -PageSize 500 перечисляет первые 500 пакетов в источнике по умолчанию (например, nuget.org), что может занять несколько минут.

При установке пакета в консоли выполняются те же действия, которые описаны в руководстве по установке пакета NuGet, со следующими дополнениями:

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

См. подробнее об Uninstall-Package. Если необходимо найти идентификатор, чтобы просмотреть все пакеты, установленные в проекте по умолчанию, используйте команду Get-Package.

При удалении пакета выполняются следующие действия:

  • Удаляются ссылки на пакет из проекта (и любого используемого формата управления). Ссылки больше не отображаются в обозревателе решений (возможно, потребуется перестроить проект, чтобы он был удален из папки Bin).
  • Отменяются все изменения, внесенные в app.config или web.config при установке пакета.
  • Удаляются ранее установленные зависимости, если остальные пакеты не используют эти зависимости.

См. подробнее о Find-Package. В Visual Studio 2013 и более ранних версиях используйте команду Get-Package.

Начиная с Visual Studio 2017, NuGet и диспетчер пакетов NuGet автоматически устанавливаются при выборе рабочей нагрузки, связанной с .NET. Вы также можете установить эти компоненты отдельно, щелкнув Отдельные компоненты > Средства для работы с кодом > Диспетчер пакетов NuGet в установщике Visual Studio.

Кроме того, если у вас нет диспетчера пакетов NuGet в Visual Studio 2015 и более ранних версиях, щелкните Инструменты > Расширения и обновления и найдите расширение диспетчера пакетов NuGet. Если вы не можете использовать установщик расширений в Visual Studio, скачайте расширение отсюда: https://dist.nuget.org/index.html.

Консоль диспетчера пакетов сейчас недоступна в Visual Studio для Mac. Но аналогичные команды доступны через CLI NuGet. В Visual Studio для Mac есть пользовательский интерфейс для управления пакетами NuGet. См. подробнее о включении пакета NuGet в проект.

Консоль диспетчера пакетов не входит в Visual Studio Code.

Расширение консоли диспетчера пакетов

Некоторые пакеты устанавливают новые команды для консоли. Например, MvcScaffolding создает команды, например команду Scaffold (см. ниже), которая, в свою очередь, создает контроллеры и представления ASP.NET MVC.

Настройка профиля PowerShell NuGet

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

Чтобы найти профиль, в консоли введите $profile .

Источник статьи: http://github.com/NuGet/docs.microsoft.com-nuget.ru-ru/blob/live/docs/consume-packages/install-use-packages-powershell.md

Name already in use

docs.microsoft.com-nuget / docs / consume-packages / install-use-packages-powershell.md

5 contributors

Users who have contributed to this file

Manage packages with the Visual Studio Package Manager Console (PowerShell)

The Package Manager Console in Visual Studio uses PowerShell commands to interact with NuGet packages. You can use the console when there’s no way to do an operation through the Package Manager UI. You can also use dotnet CLI or NuGet CLI commands in the console.

This article describes how to find, install, update, and uninstall NuGet packages with PowerShell commands in the Package Manager Console. For the complete Package Manager Console PowerShell command reference, see PowerShell reference.

[!IMPORTANT] The PowerShell commands and arguments in this article are specific to the Visual Studio Package Manager Console. These commands differ from the PackageManagement module commands you can use in a general PowerShell environment. Each environment has commands that aren’t available in the other, and commands with the same name might differ in their specific arguments.

Starting in Visual Studio 2017, NuGet and the NuGet Package Manager install automatically when you create any .NET-related workloads in Visual Studio. You can also install the Package Manager by selecting Individual components > Code tools > NuGet package manager in the Visual Studio Installer.

You can also search for the NuGet Package Manager extension under the Tools > Extensions and Updates or Extensions menus. If you’re unable to use the extensions installer in Visual Studio, you can download the extension directly from https://dist.nuget.org/index.html.

The Package Manager Console is built into the Package Manager for Visual Studio on Windows. Visual Studio Code and Visual Studio for Mac don’t include the console. Visual Studio for Mac has a UI for managing NuGet packages, and the equivalent console commands are available through the NuGet CLI. For more information, see Install and manage NuGet packages in Visual Studio for Mac.

Quickly find and install a package

To use the Package Manager Console to quickly find and install a package:

Open your project or solution in Visual Studio, and select Tools > NuGet Package Manager > Package Manager Console to open the Package Manager Console window.

In the console, enter Find-Package with a keyword to find the package you want to install. For example, to find packages that contain the keyword elmah , run the following command. If you already know the package name you want, skip this step.

Once you find the name, use the Install-Package command to install the package. For example, to install the Elmah.MVC package, enter:

For more details about these commands, see the Find a package and Install a package sections.

[!Tip] Many console operations depend on having a solution with a known path name open in Visual Studio. If you have an unsaved solution, or no solution, you see the error Solution is not opened or not saved. Please ensure you have an open and saved solution. To correct the error, create and save a solution, or save an unsaved solution.

To open the Package Manager Console in Visual Studio, select Tools > NuGet Package Manager > Package Manager Console from the top menu. The console is a Visual Studio window that you can arrange and position as you like. For more information, see Customize window layouts in Visual Studio.

By default, console commands operate against the specific package source and project shown in the controls at the top of the window:

. image type=»content» source=»media/PackageManagerConsoleControls1.png» alt-text=»Screenshot that shows the Package Manager Console controls for package source and project.».

Selecting a different package source or project changes the defaults for subsequent commands. To override these settings for single commands without changing the defaults, most console commands support -Source and -ProjectName options.

To manage package sources, select the gear icon, which opens the Tools > Options > NuGet Package Manager > Package Sources dialog box. The control next to the project selector clears the console’s contents.

. image type=»content» source=»media/PackageManagerConsoleControls2.png» alt-text=»Screenshot that shows the Package Manager Console settings and clear controls.».

The button on the far right interrupts a long-running command. For example, running Get-Package -ListAvailable -PageSize 500 lists the top 500 available packages on the default source, such as nuget.org, which could take several minutes.

. image type=»content» source=»media/PackageManagerConsoleControls3.png» alt-text=»Screenshot that shows the Package Manager Console stop control.».

To find a package in the default source, use Find-Package.

To find and list packages that contain certain keywords:

To find and list packages whose name begins with a string:

By default, Find-Package returns a list of 20 packages. Use -First to show more packages. For example, to show the first 100 packages, use:

To list all versions of a certain package:

To install a package into the default project, use Install-Package

. The Install-Package console command takes the following actions:

  • Does the steps in What happens when a NuGet package is installed.
  • Displays applicable license terms in the console window with implied agreement. If you don’t agree to the terms, you should uninstall the package.
  • Adds a reference to the package in the project file and in Solution Explorer under the References node. You must save the project before you can see the changes in the project file.

By default, Install-Package adds the package to the default project the console window specifies. To add the package to a project that isn’t the default, use the -ProjectName option. For example, to add the Elmah.MVC package to the non-default UtilitiesLib project, run the following command:

To uninstall a package from the default project, use Uninstall-Package

. If you need to find the package name, use Get-Package to see all packages installed in the default project.

Uninstall-Package takes the following actions:

  • Removes references to the package from the project and any management formats. References no longer appear in Solution Explorer. You might need to rebuild the project to remove the reference in the bin folder.
  • Reverses any changes that installing the package made to app.config or web.config.
  • Removes previously-installed dependencies if no remaining packages use those dependencies.

To uninstall a package and all its unused dependencies, run:

To uninstall a package even if other packages depend on it, run:

To update a package, use Get-Package and Update-Package. You can run the following commands:

To check if there are newer versions available for any installed packages:

To update a specific package:

To update all packages in a project:

To update all packages in the solution:

Use the NuGet CLI in the console

You can also do most console operations with the NuGet CLI. However, the PowerShell console commands operate within the context of Visual Studio saved project and solution, and often do more than their equivalent NuGet CLI commands. For example, installing a package through Install-Package adds a reference to the project file, but the NuGet CLI command doesn’t. For this reason, developers working in Visual Studio typically prefer to use the console commands rather than the NuGet CLI.

To use NuGet CLI commands in the Package Manager Console, install the NuGet.CommandLine package.

The preceding command installs the latest version of the NuGet CLI. To install a specific version, use the -Version option. For example, to install Version 4.4.1, enter:

After you install the NuGet.CommandLine package, you can run all NuGet CLI commands through the Package Manager Console.

Extend the Package Manager Console

Some packages install new commands for the console. For example, MvcScaffolding creates commands like Scaffold , which generates ASP.NET MVC controllers and views:

. image type=»content» source=»media/PackageManagerConsoleInstall.png» alt-text=»Screenshot that shows NuGet CLI commands available after installing the NuGet.CommandLine package.».

Set up a NuGet PowerShell profile

You can create a PowerShell profile to make your commonly-used commands available in all PowerShell contexts, so you don’t lose your PowerShell settings between sessions. NuGet supports a NuGet-specific profile, usually at %UserProfile%\Documents\WindowsPowerShell\NuGet_profile.ps1.

To find your user profile location, enter $profile in the console:

To determine whether a profile exists at that location, enter test-path $profile . If the command returns False , you need to create the profile with the specified name at that location. For more information, see Windows PowerShell Profiles.

Источник статьи: http://github.com/NuGet/docs.microsoft.com-nuget/blob/main/docs/consume-packages/install-use-packages-powershell.md

Устанавливайте пакеты и управляйте ими непосредственно в Visual Studio с помощью диспетчера пакетов NuGet.

Пользовательский интерфейс диспетчера пакетов NuGet в Microsoft Visual Studio для Windows позволяет легко устанавливать, удалять и обновлять пакеты NuGet в проектах и решениях.

Эта статья доступна только для пользователей Windows. Если вы используете Visual Studio для Mac, см. статью «Включение пакета NuGet» в проект.

Предварительные требования

Установите Visual Studio 2022 для Windows с любым. Рабочая нагрузка, связанная с NET.

Вы можете установить выпуск Community 2022 бесплатно из visualstudio.microsoft.com или использовать выпуск Professional или Enterprise.

Visual Studio 2017 и более поздних версий автоматически включает диспетчер пакетов NuGet при использовании . Установлена рабочая нагрузка, связанная с NET. Чтобы установить его по отдельности в Visual Studio Installer, выберите вкладку «Отдельные компоненты» и выберите диспетчер пакетов NuGet в разделе «Средства кода«.

Если в Visual Studio 2015 отсутствует диспетчер пакетов NuGet, проверьте расширения средств>и Обновления и найдите расширение диспетчера пакетов NuGet. Если вы не можете использовать установщик расширений в Visual Studio, скачайте расширение отсюда: https://dist.nuget.org/index.html.

Зарегистрируйтесь для получения бесплатной учетной записи на nuget.org, если вы не сделали этого ранее. Перед отправкой пакета NuGet необходимо зарегистрировать и подтвердить ее.

Поиск и установка пакета

Чтобы найти и установить пакет NuGet с помощью Visual Studio, выполните следующие действия.

Загрузите проект в Обозреватель решений и выберите «Управление пакетами NuGetproject>».

Откроется окно Диспетчер пакетов NuGet.

Перейдите на вкладку «Обзор «, чтобы отобразить пакеты по популярности из выбранного источника (см. статью «Источники пакетов»). Чтобы найти конкретный пакет, используйте поле поиска в левом верхнем углу. Выберите пакет из списка, чтобы отобразить его сведения на правой панели, что позволяет выбрать версию для установки.

В правой области выберите версию из раскрывающегося списка. Если вы хотите включить предварительные версии в список версий , выберите «Включить предварительные выпуски«.

Чтобы установить пакет NuGet, нажмите кнопку «Установить«. Возможно, вам будет предложено принять условия лицензионного соглашения или попросить проверить установку.

Visual Studio устанавливает пакет и его зависимости в проекте. По завершении установки добавленные пакеты отображаются на вкладке «Установленные«. Пакеты также можно найти в узле«Пакетызависимостей>» проекта в Обозреватель решений. После установки пакета его можно сослаться на него в проекте с помощью инструкции using .

(Необязательно) NuGet имеет два формата, в которых проект может использовать пакеты: PackageReference и packages.config. Чтобы задать формат по умолчанию, выберите«Параметрыинструментов>», разверните диспетчер пакетов NuGet, выберите «Общие» и выберите формат управления пакетами по умолчанию. Дополнительные сведения см. в разделе «Выбор формата управления пакетами по умолчанию».

Удаление пакета

Чтобы удалить пакет NuGet, выполните следующие действия.

Загрузите проект в Обозреватель решений, выберите «Управление пакетами NuGet«> и перейдите на вкладку «Установленные«.

Выберите пакет для удаления на левой панели (при необходимости используйте поле поиска , чтобы найти его), а затем выберите » Удалить » в правой области.

Обновление пакета

Чтобы обновить пакет NuGet, выполните следующие действия.

Загрузите проект в Обозреватель решений и выберите «Управление пакетами NuGetproject>». Для проектов веб-сайтов сначала выберите папку Bin .

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

Выберите пакет для обновления. В правой области выберите нужную версию в раскрывающемся списке и нажмите кнопку «Обновить«.

Для некоторых пакетов кнопка «Обновить » отключена, и появляется следующее сообщение: неявно ссылается пакет SDK. Чтобы обновить пакет, обновите пакет SDK, к которому он принадлежит. Это сообщение указывает, что пакет является частью более крупной платформы или пакета SDK и не может обновляться независимо друг от друга. Такие пакеты помечаются внутри . True Например, Microsoft.NETCore.App является частью пакета SDK для .NET Core, а версия пакета отличается от версии платформы среды выполнения, используемой приложением. Чтобы скачать новую версию .NET Core, обновите установку .NET Core. Дополнительные сведения см. в разделе метапакетов .NET Core и управление версиями. Этот сценарий применяется к следующим часто используемым пакетам:

  • Microsoft.AspNetCore.All
  • Microsoft.AspNetCore.App
  • Microsoft.NETCore.App
  • NETStandard.Library

Чтобы обновить несколько пакетов до последних версий, выберите их в списке пакетов NuGet и нажмите кнопку «Обновить«.

Вы также можете обновить отдельный пакет на вкладке «Установленные «. В этом случае можно также выбрать версию и параметр «Включить предварительные выпуски «.

Управление пакетами для решения

Управление пакетами для решения — это удобное средство для одновременной работы с несколькими проектами:

Выберите решение в диспетчере решений и выберите «Сервис>» диспетчер>пакетов NuGet для управления пакетами NuGet для решения.

В окне «Управление пакетами NuGet для решения» выберите проекты, затронутые операциями.

Вкладка «Консолидация»

Разработчики обычно предпочитают не использовать разные версии одного и того же пакета NuGet в разных проектах в одном решении. Visual Studio позволяет использовать общую версию для пакетов NuGet. Для этого используйте вкладку «Консолидация » окна диспетчера пакетов NuGet , чтобы определить, где пакеты с различными номерами версий используются различными проектами в решении.

В этом примере проект ClassLibrary1 использует EntityFramework 6.2.0, а ConsoleApp1 использует EntityFramework 6.1.0. Чтобы консолидировать версии пакетов:

На вкладке «Консолидация » выберите проекты для обновления в списке проектов.

Выберите версию, используемую для всех этих проектов в списке версий .

Выберите пункт Установить.

Диспетчер пакетов NuGet устанавливает выбранную версию пакета во все выбранные проекты, после чего пакет больше не отображается на вкладке «Консолидация «.

Источники пакетов

Visual Studio игнорирует порядок источников пакетов и использует пакет из любого источника для ответа на запрос. Дополнительные сведения см. в разделе «Восстановление пакетов». Сведения о загрузке пакета из определенного источника см. в разделе «Сопоставление источников пакетов».

Чтобы управлять источниками пакетов NuGet, выполните следующие действия.

Чтобы изменить источник, из которого Visual Studio загружает метаданные пакета, выберите источник из селектора источника пакета .

Чтобы управлять источниками пакетов, щелкните значок «Параметры» или выберите«Параметры«.>

В окне «Параметры » разверните узел диспетчера пакетов NuGet и выберите «Источники пакетов«.

Чтобы добавить источник, выберите +, измените имя, введите URL-адрес или путь в источнике и нажмите кнопку «Обновить«.

Теперь источник появится в раскрывающемся списке источника пакета .

Чтобы изменить источник пакета, выберите его, внесите изменения в поля Имя и Источник и щелкните Обновить.

Чтобы отключить источник пакета, снимите флажок слева от имени в списке.

Чтобы удалить источник пакета, выберите его и нажмите кнопку X .

Если источник пакета снова появится после удаления, он может быть указан в файле NuGet.config уровня компьютера или пользователя. Расположение этих файлов см. в общих конфигурациях NuGet. Удалите источник пакета в файлах, изменив их вручную или с помощью команды nuget sources.

Элемент управления «Параметры диспетчера пакетов NuGet»

При выборе пакета диспетчер пакетов NuGet отображает расширяемый элемент управления «Параметры» под селектором версий . Для большинства типов проектов предоставляется только параметр «Показать окно предварительного просмотра «.

В следующих разделах описываются доступные варианты.

Параметры установки и обновления

Эти параметры доступны только для определенных типов проектов:

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

  • Пропускать зависимости пропускает установку зависимостей, которые обычно прерывают установку устанавливаемого пакета.
  • Наименьший [по умолчанию] — устанавливает зависимость с минимальным номером версии, соответствующим требованиям основного выбранного пакета.
  • Наибольший номер исправления — устанавливает версию с теми же основными и дополнительными номерами версий, но с самым большим номером исправления. Например, если указана версия 1.2.2, будет установлена самая высокая версия, которая начинается с 1.2.
  • Наибольший номер дополнительной версии — устанавливает версию с тем же основным номером версии, но с самым большим номером дополнительной версии и номером исправления. Если указана версия 1.2.2, будет установлена самая высокая версия, которая начинается с 1.
  • Наибольший — устанавливает самую высокую доступную версию пакета.

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

  • По приглашению — NuGet спрашивает, следует ли сохранять или перезаписывать существующие пакеты.
  • Пропустить все — NuGet пропускает перезапись существующих пакетов.
  • Перезаписать все — NuGet перезаписывает существующие пакеты.

Параметры удаления

Эти параметры доступны только для определенных типов проектов:

Удаление зависимостей: при выборе удаляет все зависимые пакеты, если они не ссылаются в другом месте проекта.

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

Связанные видео

См. также раздел

Дополнительные сведения о NuGet см. в следующих статьях:

Источник статьи: http://learn.microsoft.com/ru-ru/nuget/consume-packages/install-use-packages-visual-studio

Install NuGet client tools

To work with NuGet, as a package consumer or creator, you can use command-line interface (CLI) tools as well as NuGet features in Visual Studio. This article briefly outlines the capabilities of the different tools, how to install them, and their comparative feature availability. To get started using NuGet to consume packages, see Install and use a package (dotnet CLI) and Install and use a package (Visual Studio). To get started creating NuGet packages, see Create and publish a NET Standard package (dotnet CLI) and Create and publish a NET Standard package (Visual Studio).

ToolВ В В В В В В В В В В В В В В Description DownloadВ В В В В В В В В
dotnet.exe CLI tool for .NET Core and .NET Standard libraries, and for any SDK-style project such as one that targets .NET Framework. Included with the .NET Core SDK and provides core NuGet features on all platforms. (Starting in Visual Studio 2017, the dotnet CLI is automatically installed with any .NET Core related workloads.) .NET Core SDK
nuget.exe CLI tool for .NET Framework libraries and for any non-SDK-style project such as one that targets .NET Standard libraries. Provides all NuGet capabilities on Windows, provides most features on Mac and Linux when running under Mono. nuget.exe
Visual Studio On Windows, the NuGet Package Manager is included with Visual Studio 2012 and later. Visual Studio provides the Package Manager UI and the Package Manager Console, through which you can run most NuGet operations. Visual Studio
Visual Studio for Mac On Mac, certain NuGet capabilities are built-in directly. Package Manager Console is not presently available. For other capabilities, use the dotnet.exe or nuget.exe CLI tools. Visual Studio for Mac
Visual Studio Code On Windows, Mac, or Linux, NuGet capabilities are available through marketplace extensions, or use the dotnet.exe or nuget.exe CLI tools. Visual Studio Code

The MSBuild CLI also provides the ability to restore and create packages, which is primarily useful on build servers. MSBuild is not a general-purpose tool for working with NuGet.

Package Manager Console commands work only within Visual Studio on Windows and do not work within other PowerShell environments.

Visual Studio

Install on Visual Studio 2017 and newer

Starting in Visual Studio 2017, the installer includes the NuGet Package Manager with any workload that employs .NET. To install separately, or to verify that the Package Manager is installed, run the Visual Studio installer and check the option under Individual Components > Code tools > NuGet package manager.

Install on Visual Studio 2015 and older

NuGet Extensions for Visual Studio 2013 and 2015 can be downloaded from https://dist.nuget.org/index.html.

For Visual Studio 2010 and earlier, install the «NuGet Package Manager for Visual Studio» extension. Note, if you can’t see the extension in the first page of search results, try changing the Sort By dropdown to «Most Downloads», or an alphabetical sort.

CLI tools

You can use either the dotnet CLI or the nuget.exe CLI to support NuGet features in the IDE. The dotnet CLI is installed with some Visual Studio workloads, such as .NET Core. The nuget.exe CLI must be installed separately as described earlier.

The two NuGet CLI tools are dotnet.exe and nuget.exe . See feature availability for a comparison.

  • To target .NET Core or .NET Standard, use the dotnet CLI. The dotnet CLI is required for the SDK-style project format, which uses the SDK attribute.
  • To target .NET Framework (non-SDK-style project only), use the nuget.exe CLI. If the project is migrated from packages.config to PackageReference, use the dotnet CLI.

dotnet.exe CLI

The .NET Core 2.0 CLI, dotnet.exe , works on all platforms (Windows, Mac, and Linux) and provides core NuGet features such as installing, restoring, and publishing packages. dotnet provides direct integration with .NET Core project files (such as .csproj ), which is helpful in most scenarios. dotnet is also built directly for each platform and does not require you to install Mono.

  • On developer computers, install the .NET Core SDK. Starting in Visual Studio 2017, the dotnet CLI is automatically installed with any .NET Core related workloads.
  • For build servers, follow the instructions on Using .NET Core SDK and tools in Continuous Integration.

To learn how to use basic commands with the dotnet CLI, see Install and use packages using the dotnet CLI.

nuget.exe CLI

The nuget.exe CLI, nuget.exe , is the command-line utility for Windows that provides all NuGet capabilities; it can also be run on Mac OSX and Linux using Mono with some limitations.

To learn how to use basic commands with the nuget.exe CLI, see Install and use packages using the nuget.exe CLI.

Windows

NuGet.exe 5.0 and later require .NET Framework 4.7.2 or later to execute.

  1. Visit nuget.org/downloads and select NuGet 3.3 or higher (2.8.6 is not compatible with Mono). The latest version is always recommended, and 4.1.0+ is required to publish packages to nuget.org.
  2. Each download is the nuget.exe file directly. Instruct your browser to save the file to a folder of your choice. The file is not an installer; you won’t see anything if you run it directly from the browser.
  3. Add the folder where you placed nuget.exe to your PATH environment variable to use the CLI tool from anywhere.

macOS/Linux

Behaviors may vary slightly by OS distribution.

Execute the following command at a shell prompt:

Create an alias by adding the following script to the appropriate file for your OS (typically

Reload the shell. Test the installation by entering nuget with no parameters. NuGet CLI help should display.

Use nuget update -self on Windows to update an existing nuget.exe to the latest version.

The latest recommended NuGet CLI is always available at https://dist.nuget.org/win-x86-commandline/latest/nuget.exe . For compatibility purposes with older continuous integration systems, a previous URL, https://nuget.org/nuget.exe currently provides the deprecated 2.8.6 CLI tool.

Feature availability

Feature dotnet CLI nuget CLI (Windows) nuget CLI (Mono) Visual Studio (Windows) Visual Studio for Mac
Search packages вњ” вњ” вњ” вњ”
Install/uninstall packages вњ” вњ”(1) вњ” вњ” вњ”
Update packages вњ” вњ” вњ” вњ”
Restore packages вњ” вњ” вњ”(2) вњ” вњ”
Manage package feeds (sources) вњ” вњ” вњ” вњ”
Manage packages on a feed вњ” вњ” вњ”
Set API keys for feeds вњ” вњ”
Create packages(3) вњ” вњ” вњ”(4) вњ”
Publish packages вњ” вњ” вњ” вњ”
Replicate packages вњ” вњ”
Manage global-package and cache folders вњ” вњ” вњ”
Manage NuGet configuration вњ” вњ”

(1) Does not affect project files; use dotnet.exe instead.

(2) Works only with packages.config file and not with solution ( .sln ) files.

(3) Various advanced package features are available through the CLI only as they aren’t represented in the Visual Studio UI tools.

(4) Works with .nuspec files but not with project files.

Upcoming Features

If you’d like to preview upcoming NuGet features, install a Visual Studio Preview, which works side-by-side with stable releases of Visual Studio. To report problems or share ideas for previews, open an issue on the NuGet GitHub repository.

Related topics

Developers working on Windows can also explore the NuGet Package Explorer, an open-source, stand-alone tool to visually explore, create, and edit NuGet packages. It’s very helpful, for example, to make experimental changes to a package structure without rebuilding the package.

Источник статьи: http://learn.microsoft.com/en-us/nuget/install-nuget-client-tools

Install and manage packages in Visual Studio using the NuGet Package Manager

The NuGet Package Manager UI in Microsoft Visual Studio for Windows allows you to easily install, uninstall, and update NuGet packages in projects and solutions.

The article is for Windows users only. If you’re using Visual Studio for Mac, see Including a NuGet package in your project.

Prerequisites

Install Visual Studio 2022 for Windows with any .NET-related workload.

You can install the 2022 Community edition for free from visualstudio.microsoft.com, or use the Professional or Enterprise edition.

Visual Studio 2017 and higher automatically includes NuGet Package Manager when a .NET-related workload is installed. To install it individually in Visual Studio Installer, select the Individual components tab, and then select NuGet package manager under Code tools .

For Visual Studio 2015, if you’re missing the NuGet Package Manager, check Tools > Extensions and Updates and search for the NuGet Package Manager extension. If you’re unable to use the extensions installer in Visual Studio, download the extension directly from https://dist.nuget.org/index.html.

Register for a free account on nuget.org if you don’t have one already. You must register and confirm the account before you can upload a NuGet package.

Find and install a package

To find and install a NuGet package with Visual Studio, follow these steps:

Load a project in Solution Explorer, and then select Project > Manage NuGet Packages.

The NuGet Package Manager window opens.

Select the Browse tab to display packages by popularity from the currently selected source (see Package sources). To search for a specific package, use the search box on the upper left. Select a package from the list to display its information on the right pane, which enables you to select a version to install.

In the right pane, select a Version from the dropdown list. If you want to include prerelease versions in the Version list, select Include prerelease.

To install the NuGet package, select Install. You might be asked to accept license terms or prompted to verify the installation.

Visual Studio installs the package and its dependencies in the project. When installation is complete, the added packages appear on the Installed tab. You can also find packages in the Dependencies > Packages node of your project in Solution Explorer. After you install a package, you can refer to it in the project with a using statement.

(Optional) NuGet has two formats in which a project can use packages: PackageReference and packages.config. To set the default format, select Tools > Options, expand NuGet Package Manager, select General, and then choose the Default package management format. For more information, see Choose default package management format.

Uninstall a package

To uninstall a NuGet package, follow these steps:

Load a project in Solution Explorer, select Project > Manage NuGet Packages, and then select the Installed tab.

Select the package to uninstall in the left pane (use the Search box to find it, if necessary), and then select Uninstall from the right pane.

Update a package

To update a NuGet package, follow these steps:

Load a project in Solution Explorer, and then select Project > Manage NuGet Packages. For website projects, select the Bin folder first.

Select the Updates tab to see packages that have available updates from the selected Package source. Select Include prerelease to include prerelease packages in the update list.

Select the package to update. On the right pane, select the desired Version from the dropdown list, and then select Update.

For some packages, the Update button is disabled and the following message appears: Implicitly referenced by an SDK. To update the package, update the SDK to which it belongs. This message indicates that the package is part of a larger framework or SDK and can’t be updated independently. Such packages are internally marked with True . For example, Microsoft.NETCore.App is part of the .NET Core SDK, and the package version is different than the version of the runtime framework used by the application. To download a new version of the .NET Core, update your .NET Core installation. For more information, see .NET Core metapackages and versioning. This scenario applies to the following commonly used packages:

  • Microsoft.AspNetCore.All
  • Microsoft.AspNetCore.App
  • Microsoft.NETCore.App
  • NETStandard.Library

To update multiple packages to their latest versions, choose them in the NuGet package list, and then select Update.

You can also update an individual package from the Installed tab. For this case, you can also select a Version and the Include prerelease option.

Manage packages for the solution

Managing packages for a solution is a convenient means to work with multiple projects simultaneously:

Select a solution in Solution Manager, and then select Tools > NuGet Package Manager > Manage NuGet Packages for Solution.

In the Manage NuGet Packages for Solution window, select the projects that are affected by the operations.

Consolidate tab

Developers typically consider it bad practice to use different versions of the same NuGet package across different projects in the same solution. Visual Studio allows you to use a common version for your NuGet packages. To do so, use the Consolidate tab of the NuGet Package Manager window to discover where packages with distinct version numbers are used by different projects in the solution.

In this example, the ClassLibrary1 project is using EntityFramework 6.2.0, whereas ConsoleApp1 is using EntityFramework 6.1.0. To consolidate package versions, follow these steps:

From the Consolidate tab, select the projects to update in the project list.

Select the version to use for all these projects in the Version list.

Select Install.

The NuGet Package Manager installs the selected package version into all the selected projects, after which the package no longer appears on the Consolidate tab.

Package sources

Visual Studio ignores the order of package sources, and uses the package from whichever source is the first to respond to a request. For more information, see Restore packages. For information about how to load a package from a specific source, see Package source mapping.

To manage NuGet package sources, follow these steps:

To change the source from which Visual Studio loads package metadata, select a source from the Package source selector.

To manage your package sources, select the Settings icon or select Tools > Options.

In the Options window, expand the NuGet Package Manager node and select Package Sources.

To add a source, select +, edit the Name, enter the URL or path in Source, and then select Update.

The source now appears in the Package source dropdown list.

To change a package source, select it, make edits in the Name and Source boxes, and select Update.

To disable a package source, clear the box to the left of the name in the list.

To remove a package source, select it, and then select the X button.

If a package source reappears after you delete it, it might be listed in a computer-level or user-level NuGet.config file. For the location of these files, see Common NuGet configurations. Remove the package source in the files by editing them manually or using the nuget sources command.

NuGet Package Manager Options control

When you select a package, the NuGet Package Manager displays an expandable Options control below the Version selector. For most project types, only the Show preview window option is provided.

The following sections explain the available options.

Install and update options

These options are available only for certain project types:

Dependency behavior: This option configures how NuGet decides which versions of dependent packages to install. It has the following settings:

  • Ignore dependencies skips the installation of dependencies, which typically breaks the package being installed.
  • Lowest [Default] installs the dependency with the minimal version number that meets the requirements of the primary chosen package.
  • Highest Patch installs the version with the same major and minor version numbers, but the highest patch number. For example, if version 1.2.2 is specified then the highest version that starts with 1.2 will be installed
  • Highest Minor installs the version with the same major version number but the highest minor number and patch number. If version 1.2.2 is specified, then the highest version that starts with 1 will be installed
  • Highest installs the highest available version of the package.

File conflict action: This option specifies how NuGet should handle packages that already exist in the project or local machine. It has the following settings:

  • Prompt instructs NuGet to ask whether to keep or overwrite existing packages.
  • Ignore All instructs NuGet to skip overwriting any existing packages.
  • Overwrite All instructs NuGet to overwrite any existing packages.

Uninstall options

These options are available only for certain project types:

Remove dependencies: When selected, removes any dependent packages if they’re not referenced elsewhere in the project.

Force uninstall even if there are dependencies on it: When selected, uninstalls a package even if it’s still being referenced in the project. This option is typically used in combination with Remove dependencies to remove a package and whatever dependencies it installed. Using this option may, however, lead to broken references in the project. In such a case, you might need to reinstall those other packages.

Related video

See also

For more information about NuGet, see the following articles:

Источник статьи: http://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-visual-studio

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *