Compartir a través de

Administración de dependencias de paquetes en aplicaciones .NET

En este artículo se explica cómo agregar y quitar dependencias de paquete editando el archivo de proyecto o mediante la CLI.

Elemento <PackageReference>

El <PackageReference> elemento de archivo del proyecto tiene la siguiente estructura:

<PackageReference Include="PACKAGE_ID" Version="PACKAGE_VERSION" />

El Include atributo especifica el identificador del paquete que se va a agregar al proyecto. El Version atributo especifica la versión que se va a obtener. Las versiones se especifican según las reglas de versión de NuGet.

Use condiciones para agregar una dependencia que solo esté disponible en un destino específico, como se muestra en el ejemplo siguiente:

<PackageReference Include="PACKAGE_ID" Version="PACKAGE_VERSION" Condition="'$(TargetFramework)' == 'netcoreapp2.1'" />

La dependencia del ejemplo anterior solo será válida si la compilación se está efectuando para ese objetivo determinado. El elemento $(TargetFramework) de la condición es una propiedad de MSBuild que se está configurando en el proyecto. Para las aplicaciones .NET más comunes, no es necesario hacerlo.

Agregar y quitar dependencias

Puede agregar y quitar dependencias editando el archivo del proyecto o mediante comandos de la CLI de .NET .

Edición del archivo del proyecto

Para agregar una dependencia, agregue un <PackageReference> elemento dentro de un <ItemGroup> elemento. Puede agregar a un existente <ItemGroup> o crear uno nuevo.

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    ...
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.EntityFrameworkCore" Version="3.1.2" />
  </ItemGroup>

</Project>

Para quitar una dependencia, quite su <PackageReference> elemento del archivo del proyecto.

Uso de la CLI

Para agregar una dependencia, ejecute el dotnet package add comando , como se muestra en el ejemplo siguiente. (Si usa una versión del SDK de .NET 9 o una versión anterior, use el dotnet add package formulario en su lugar).

dotnet package add Microsoft.EntityFrameworkCore

Para quitar una dependencia, ejecute el dotnet package remove comando , como se muestra en el ejemplo siguiente. (Si usa una versión del SDK de .NET 9 o una versión anterior, use el dotnet remove package formulario en su lugar).

dotnet package remove Microsoft.EntityFrameworkCore

Consejos

  • No incluya entradas para la operación de restauración en el archivo .targets o .props de un paquete al que se hace referencia. Estas entradas pueden incluir PackageReference elementos, ExcludeAssets atributos, las fuentes de NuGet que se van a usar u otra configuración de NuGet. Los archivos .targets y .props de los paquetes no se usan hasta que se complete la restauración de NuGet. Todo lo necesario para la restauración debe estar en el archivo de proyecto o archivo .targets del propio proyecto, no en una dependencia de paquete.

  • Si desea usar ASP.NET API en una aplicación de consola o biblioteca de clases, agregue un elemento FrameworkReference al archivo del proyecto:

    <FrameworkReference Include="Microsoft.AspNetCore.App" />

    Para obtener más información, consulte Uso del marco compartido de ASP.NET Core.

Consulte también