Marcos de destino

NuGet usa referencias de marcos de destino en varios lugares para identificar y aislar de forma específica los componentes de un paquete que dependen del marco:

• Archivo de proyecto: para los proyectos de estilo SDK, .csproj contiene las referencias de la plataforma de destino.
• Manifiesto .nuspec: un paquete puede indicar que se incluyan distintos paquetes en un proyecto en función de la plataforma de destino del proyecto.
• Nombre de la carpeta .nupkg: las carpetas que están dentro de la carpeta lib de 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 esa plataforma.
• packages.config: el atributo targetframework de una dependencia especifica la variante de un paquete que se va a instalar.

Marcos de trabajo admitidos

A una plataforma normalmente se hace referencia mediante un moniker corto de la plataforma de destino o TFM. En .NET Standard, esto también se ha generalizado a TxM para permitir una sola referencia a varios marcos.

Los clientes de NuGet admiten las plataformas indicadas en la tabla siguiente. Los equivalentes se muestran entre corchetes []. Tenga en cuenta que es posible que algunas herramientas, como dotnet, usen variaciones de TFM canónicos en algunos archivos. Por ejemplo, dotnet pack usa .NETCoreApp2.0 en un archivo .nuspec en lugar de netcoreapp2.0. Las distintas herramientas del cliente de NuGet controlan estas variaciones sin problema, pero siempre debe usar TFM canónicos al editar archivos directamente.

Marcos de trabajo en desuso

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

Prioridad

Hay una serie de plataformas relacionadas 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 solo marco de destino haga referencia a una combinación de otros. (Para obtener información, vea el manual de .NET).

La herramienta de NuGet Get Nearest Framework simula lo que usa NuGet para seleccionar una plataforma entre los muchos recursos de plataformas disponibles en un paquete en función de la plataforma del proyecto.

La serie de monikers dotnet se debe usar en NuGet 3.3 y en versiones anteriores, mientras que la sintaxis de moniker netstandard se debe usar en la versión 3.4 y en versiones posteriores.

Bibliotecas de clases portables

Para definir una plataforma de destino que haga referencia a varias plataformas de destino secundarias, use la palabra clave portable para prefijar la lista de las plataformas a las que se hace referencia. Evite incluir artificialmente plataformas adicionales que no estén directamente compiladas, ya que puede provocar efectos secundarios imprevistos en esas plataformas.

Las plataformas adicionales definidas por terceros proporcionan compatibilidad con otros entornos que son accesibles de este modo. Además, existen números de perfil abreviados disponibles para hacer referencia a estas combinaciones de plataformas relacionadas como Profile#, pero no es una práctica recomendada para usar estos números, ya que reduce la legibilidad de las carpetas y de .nuspec.

Además, los paquetes de NuGet que tienen como destino Xamarin pueden usar otras plataformas definidas por Xamarin. Vea Manually Creating NuGet Packages for Xamarin (Crear manualmente paquetes de NuGet para Xamarin).