Marcos de trabajo objetivo

NuGet usa referencias de marco de destino en una variedad de lugares para identificar y aislar específicamente los componentes dependientes del marco de un paquete:

• archivo de proyecto: para los proyectos de estilo SDK, .csproj contiene las referencias de la plataforma de destino.
• Manifiesto .nuspec: un paquete puede indicar paquetes distintos que se incluirán en un proyecto en función del marco de destino del proyecto.
• Nombre de la carpeta .nupkg: las carpetas dentro de la carpeta de lib un paquete se pueden denominar según la plataforma de destino, cada una de las cuales contiene los archivos DLL y otro contenido adecuado para ese marco.
• packages.config: el targetframework atributo de una dependencia especifica la variante de un paquete que se va a instalar.

Para obtener la lista canónica de todos los marcos de destino admitidos y su sintaxis de TFM, consulte Plataformas de destino en proyectos de estilo SDK.

Los valores targetFramework son alias

La TargetFramework propiedad de un archivo de proyecto es un nombre descriptivo (un alias) que se traduce en una identidad de marco canónica. El SDK de .NET realiza esta traducción estableciendo el TargetFrameworkMoniker (TFM) y, cuando procede, las TargetPlatformMoniker propiedades.

Por ejemplo, al escribir <TargetFramework>net10.0-windows</TargetFramework>, el SDK de .NET lo traduce en:

• TargetFrameworkMoniker = .NETCoreApp,Version=v10.0
• TargetPlatformMoniker = Windows,Version=7.0

NuGet usa estas propiedades de moniker (no la TargetFramework cadena) para las comprobaciones de compatibilidad de paquetes. Esto significa que el TargetFramework propio valor puede ser cualquier cadena, siempre y cuando las propiedades del moniker se establezcan correctamente. Por ejemplo, el siguiente proyecto es válido:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>banana</TargetFramework>
  </PropertyGroup>

  <PropertyGroup Condition=" '$(TargetFramework)' == 'banana' ">
    <TargetFrameworkIdentifier>.NETCoreApp</TargetFrameworkIdentifier>
    <TargetFrameworkVersion>v10.0</TargetFrameworkVersion>
    <TargetFrameworkMoniker>.NETCoreApp,Version=v10.0</TargetFrameworkMoniker>
  </PropertyGroup>
</Project>

Este proyecto restaura y compila para .NET 10.0, aunque el TargetFramework valor sea banana. El SDK de .NET ya se basa en este mecanismo de alias para TFM específicos del sistema operativo, como net8.0-ios y net8.0-android, donde el TFM corto se traduce en el moniker completo con información de la plataforma.

Multi-targeting con marcos duplicados

A partir de NuGet 7.6 / SDK de .NET 10.0.300, varios TargetFrameworks alias pueden resolverse en el mismo marco efectivo. Esto permite escenarios como compilaciones de varios RID y destinos de extensión de varias versiones. Para obtener más información sobre cómo funciona esto con las referencias de restauración, paquete, bloqueo y proyecto, consulte Selección de varios marcos de trabajo.

Marcos admitidos

Normalmente, un moniker de la plataforma de destino corto o TFM hace referencia a un marco de trabajo de destino corto. En .NET Standard, también se generaliza en TxM para permitir una sola referencia a varios marcos.

Los clientes nuGet admiten los marcos de trabajo de la tabla siguiente. Los equivalentes se muestran entre corchetes []. Tenga en cuenta que algunas herramientas, como dotnet, pueden usar variaciones de TFM canónicas en algunos archivos. Por ejemplo, dotnet pack usa .NETCoreApp2.0 en un .nuspec archivo en lugar de netcoreapp2.0. Las distintas herramientas de cliente de NuGet controlan estas variaciones correctamente, pero siempre debe usar TFM canónicos al editar archivos directamente.

Marcos en desuso

Los marcos siguientes están en desuso. Los paquetes destinados a estos marcos deben migrarse a los reemplazos indicados.

Precedence

Una serie de marcos están relacionados y compatibles entre sí, pero no necesariamente equivalentes:

NET Standard

.NET Standard simplifica las referencias entre marcos compatibles con binarios, lo que permite que un único marco de destino haga referencia a una combinación de otros. (Para obtener información general, consulte .NET Primer).

La herramienta NuGet Get Nearest Framework simula lo que NuGet usa para seleccionar un marco de muchos recursos de marcos disponibles en un paquete basado en el marco del proyecto.

La dotnet serie de monikers debe usarse en NuGet 3.3 y versiones anteriores; la netstandard sintaxis de moniker debe usarse en la versión 3.4 y posteriores.

Bibliotecas de clases portables

Para definir un marco de destino que hace referencia a varios marcos de destino secundarios, la portable palabra clave que se usa para prefijar la lista de marcos a los que se hace referencia. Evite la inclusión artificial de marcos adicionales que no se compilan directamente, ya que puede provocar efectos secundarios no deseados en esos marcos.

Los marcos adicionales definidos por terceros proporcionan compatibilidad con otros entornos a los que se puede acceder de esta manera. Además, hay números de perfil abreviados que están disponibles para hacer referencia a estas combinaciones de marcos relacionados como Profile#, pero esto no es una práctica recomendada para usar estos números, ya que reduce la legibilidad de las carpetas y .nuspec.

Además, los paquetes NuGet destinados a Xamarin pueden usar marcos definidos por Xamarin adicionales: