Instalación y administración de paquetes en Visual Studio con el Administrador de paquetes

  • Artículo

La interfaz de usuario del Administrador de paquetes NuGet en Microsoft Visual Studio de Windows le permite instalar, desinstalar y actualizar fácilmente paquetes NuGet en proyectos y soluciones.

Este artículo es solo para usuarios de Windows. Si utiliza Visual Studio para Mac, consulte Incluir un paquete NuGet en el proyecto.

Requisitos previos

  • Instale Visual Studio 2022 para Windows con cualquier carga de trabajo relacionada con .NET.

    Puede instalar la edición 2022 Community de forma gratuita desde visualstudio.microsoft.com, o utilizar la edición Professional o Enterprise.

    Visual Studio 2017 y las versiones superiores incluyen automáticamente el Administrador de paquetes NuGet cuando se instala una carga de trabajo relacionada con .NET. Para instalarlo individualmente en Instalador de Visual Studio, seleccione la pestaña Componentes individuales y, a continuación, seleccione Administrador de paquetes NuGet en Herramientas de código.

    Para Visual Studio 2015, si le falta el Administrador de paquetes NuGet, revise Herramientas>Extensiones y actualizaciones y busque la extensión Administrador de paquetes NuGet. Si no puede usar el instalador de extensiones en Visual Studio, descargue la extensión directamente de https://dist.nuget.org/index.html.

  • Registrar una cuenta gratuita en nuget.org si aún no tiene uno. Debe registrarse y confirmar la cuenta antes de poder cargar un paquete NuGet.

Búsqueda e instalación de un paquete

Para buscar e instalar un paquete NuGet con Visual Studio, siga estos pasos:

  1. Cargue un proyecto en el Explorador de soluciones y, a continuación, seleccione Proyecto>Administrar paquetes NuGet.

    Se abre la ventanaAdministrador de paquetes NuGet.

  2. Seleccione la pestaña Examinar para mostrar los paquetes por popularidad desde el origen seleccionado actualmente (consulte Orígenes de los paquetes). Para buscar un paquete específico, utilice el cuadro de búsqueda situado en la parte superior izquierda. Seleccione un paquete de la lista para mostrar su información en el panel derecho, que le permite seleccionar una versión para instalar.

    Screenshot showing the NuGet Package Manager window with the Browse tab selected.

  3. En el panel derecho, seleccione una Versión de la lista desplegable. Si desea incluir versiones preliminares en la lista Versión, seleccione Incluir versiones preliminares.

  4. Para instalar el paquete NuGet, seleccione Instalar. Se le pedirá que acepte los términos de licencia o se le solicitará que verifique la instalación.

    Visual Studio instala el paquete y sus dependencias en el proyecto. Cuando finaliza la instalación, los paquetes añadidos aparecen en la pestaña Instalado. También puedes encontrar los paquetes en el nodo Dependencias>Paquetes del proyecto en el Explorador de soluciones. Después de instalar un paquete, puede hacer referencia a él en el proyecto con una sentencia using.

  5. (Opcional) NuGet tiene dos formatos en los que un proyecto puede utilizar paquetes: PackageReference y packages.config. Para establecer el formato predeterminado, seleccione Herramientas>Opciones, expanda Administrador de paquetes NuGet, seleccione General y, a continuación, elija Formato predeterminado de administración de paquetes. Para más información, consulte Elegir formato predeterminado de administración de paquetes.

Desinstala un paquete.

Para desinstalar un paquete NuGet, siga estos pasos:

  1. Cargue un proyecto en el Explorador de soluciones, seleccione Proyecto>Administrar paquetes NuGet y, a continuación, seleccione la pestaña Instalado.

  2. Seleccione el paquete que quiere desinstalar en el panel izquierdo (use el cuadro Buscar para encontrarlo, si es necesario), y luego seleccione Desinstalar en el panel derecho.

    Screenshot showing the NuGet Package Manager with a package selected and its Uninstall button highlighted.

Actualización de un paquete

Para actualizar un paquete NuGet, siga estos pasos:

  1. Cargue un proyecto en el Explorador de soluciones y, a continuación, seleccione Proyecto>Administrar paquetes NuGet. Para proyectos de sitios web, seleccione primero la carpeta Bin.

  2. Seleccione la pestaña Actualizaciones para ver los paquetes que tienen actualizaciones disponibles del origen de paquetes seleccionado. Seleccione Incluir versión preliminar para incluir los paquetes de versión preliminar en la lista de actualizaciones.

  3. Seleccione el paquete que quiere actualizar. En el panel derecho, seleccione la versión deseada en la lista desplegable y, a continuación, seleccione Actualizar.

    Screenshot showing the NuGet Package Manager with a package selected and its Update button highlighted.

  4. Para algunos paquetes, el botón Actualizar está desactivado y aparece el siguiente mensaje: Implícitamente referenciado por un SDK. Para actualizar el paquete, actualice el SDK al que pertenece. Este mensaje indica que el paquete forma parte de un framework o SDK más amplio y no puede actualizarse de forma independiente Estos paquetes se marcan internamente con <IsImplicitlyDefined>True</IsImplicitlyDefined>. Por ejemplo, Microsoft.NETCore.App forma parte del SDK de .NET Core, y la versión del paquete es diferente de la versión del marco de ejecución que utiliza la aplicación. Para descargar una nueva versión de .NET Core, actualice su instalación de .NET Core. Más información en Metapaquetes y versionado de .NET Core. Este escenario se aplica a los siguientes paquetes de uso común:

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

    Screenshot showing a NuGet package with the Update button disabled.

  5. Para actualizar varios paquetes a sus versiones más recientes, selecciónelos en la lista de paquetes NuGet y, a continuación, seleccione Actualizar.

  6. También puede actualizar un paquete individual desde la pestaña Instalado. Para este caso, también puede seleccionar una Versión y la opción Incluir versión preliminar.

Administración de paquetes para la solución

La administración de paquetes para una solución es un medio conveniente para trabajar con varios proyectos simultáneamente:

  1. Seleccione una solución en el Administrador de soluciones y, a continuación, seleccione Herramientas>Administrador de paquetes NuGet>Administrar paquetes NuGet para la solución.

  2. En la ventana Administrar paquetes NuGet para solución, seleccione los proyectos afectados por las operaciones.

    Screenshot showing the Manage Packages for Solution window with multiple projects selected.

Pestaña Consolidar

Por lo general, los desarrolladores consideran como una práctica incorrecta usar versiones distintas del mismo paquete NuGet en diferentes proyectos de la misma solución. Visual Studio permite utilizar una versión común para los paquetes NuGet. Para ello, utilice la ficha Consolidar de la ventana Administrador de paquetes NuGet para descubrir dónde se utilizan paquetes con distintos números de versión en los diferentes proyectos de la solución.

Screenshot showing the Manage Packages for Solution window with the Consolidate tab selected.

En este ejemplo, el proyecto ClassLibrary1 usa EntityFramework 6.2.0, mientras que ConsoleApp1 usa EntityFramework 6.1.0. Para consolidar las versiones del paquete, siga estos pasos:

  1. En la pestaña Consolidar, seleccione los proyectos que quiere actualizar en la lista de proyectos.

  2. Seleccione la versión a utilizar para todos estos proyectos en la lista Versión.

  3. Seleccione Instalar.

    El Administrador de paquetes NuGet instala la versión del paquete seleccionado en todos los proyectos elegidos, después de lo cual el paquete ya no aparece en la pestaña Consolidar.

Orígenes de paquetes

Visual Studio ignora el orden del origen de los paquetes y utiliza el paquete del primer origen que responda a una solicitud. Para más información, consulte Restaurar paquetes. Más información sobre cómo cargar un paquete desde un origen específico en Asignación de orígenes de paquetes.

Para administrar los orígenes de paquetes NuGet, siga estos pasos:

  1. Para cambiar el origen desde el que Visual Studio carga los metadatos del paquete, seleccione un origen en el selector Origen del paquete.

    Screenshot showing the Package source selector highlighted.

  2. Para administrar los orígenes de paquetes, seleccione el icono Configuración o seleccione Herramientas>Opciones.

    Screenshot showing the Package source settings icon highlighted.

  3. En la ventana Opciones, expanda el nodo Administrador de paquetes NuGet y seleccione Orígenes de paquetes.

    Screenshot showing the Options window with Package Sources selected.

  4. Para agregar un origen, seleccione +, edite el Nombre, introduzca la URL o la ruta en Origen y, a continuación, seleccione Actualizar.

    El origen aparece ahora en la lista desplegable Origen del paquete.

  5. Para cambiar un origen de paquete, selecciónelo, realice las modificaciones en los cuadros Nombre y Origen y seleccione Actualizar.

  6. Para deshabilitar un origen de paquete, desactive la casilla que está a la izquierda del nombre en la lista.

  7. Para quitar un origen de paquete, selecciónelo y, luego, seleccione el botón X.

    Si un origen de paquete vuelve a aparecer después de eliminarlo, es posible que aparezca en un archivo NuGet.config de nivel de equipo o de nivel de usuario. Para conocer la ubicación de estos archivos, consulte Configuraciones comunes de NuGet. Elimine el origen del paquete en los archivos editándolos manualmente o con el comando orígenes de nuget.

Control de opciones del administrador de paquetes NuGet

Al seleccionar un paquete, el Administrador de paquetes NuGet muestra un control de Opciones expandible debajo del selector Versión. Para la mayoría de los tipos de proyecto, solo se proporciona la opción Mostrar ventana de vista previa.

Screenshot showing the NuGet Package manager Options control expanded.

Las siguientes secciones explican las opciones disponibles.

Opciones de instalación y actualización

Estas opciones solo están disponibles para determinados tipos de proyectos:

  • Comportamiento de dependencia: esta opción configura cómo NuGet decide qué versiones de paquetes dependientes instalar. Tiene las siguientes opciones:

    • Ignorar dependencias omite la instalación de dependencias, lo que normalmente interrumpe el paquete que se está instalando.
    • Mínima [valor predeterminado]: instala la dependencia con el número de versión mínimo que cumple los requisitos del paquete principal escogido.
    • Revisión superior: instala la versión con los mismos números de versión principal y secundaria, pero con el número de revisión superior. Por ejemplo, si se especifica la versión 1.2.2, se instalará la versión superior que empieza con 1.2.
    • Secundaria superior: instala la versión con el mismo número de versión principal, pero el número de revisión y de versión secundaria superior. Si se especifica la versión 1.2.2, se instalará la versión superior que empieza con 1.
    • Superior: instala la versión superior disponible del paquete.

  • Acción de conflicto de archivos: esta opción especifica cómo NuGet debe manejar los paquetes que ya existen en el proyecto o en la máquina local. Tiene las siguientes opciones:

    • Petición: indica a NuGet si debe conservar o sobrescribir los paquetes existentes.
    • Omitir todo: indica a NuGet que omita sobrescribir cualquier paquete existente.
    • Sobrescribir todo: indica a NuGet que sobrescriba cualquier paquete existente.

Opciones de desinstalación

Estas opciones solo están disponibles para determinados tipos de proyectos:

  • Eliminar dependencia: cuando se selecciona, esta opción quita todos los paquetes dependientes si no se hace referencia a ellos en alguna otra parte del proyecto.

  • Forzar la desinstalación incluso si hay dependencias: cuando se selecciona, esta opción desinstala un paquete incluso si se hace referencia a él en el proyecto. Por lo general, se usa en combinación con Eliminar dependencias para quitar un paquete y todas las dependencias que instaló. Sin embargo, usar esta opción puede generar referencias rotas en el proyecto. En tal caso, es posible que tenga que volver a instalar esos otros paquetes.

Consulte también

Para obtener más información acerca de NuGet, consulte los siguientes artículos: