Plataformas-alvo

O NuGet utiliza referências de framework alvo em vários locais para identificar e isolar especificamente componentes dependentes do framework de um pacote:

• ficheiro de projeto: Para projetos ao estilo SDK, o .csproj contém as referências do framework alvo.
• Manifesto .nuspec: Um pacote pode indicar pacotes distintos a serem incluídos num projeto dependendo do framework alvo do projeto.
• Nome da pasta .nupkg: As pastas dentro da lib pasta de um pacote podem ser nomeadas de acordo com o framework de destino, cada uma das quais contém as DLLs e outro conteúdo apropriado a esse framework.
• packages.config: O targetframework atributo de uma dependência especifica a variante de um pacote a instalar.

Para a lista canónica de todos os frameworks-alvo suportados e a sua sintaxe TFM, veja frameworks de alvo em projetos ao estilo SDK.

Os valores do TargetFramework são pseudónimos

A TargetFramework propriedade num ficheiro de projeto é um nome amigável — um alias — que é traduzido numa identidade canónica de framework. O SDK .NET realiza esta tradução definindo o TargetFrameworkMoniker (TFM) e, quando aplicável, as propriedades TargetPlatformMoniker .

Por exemplo, quando escreves <TargetFramework>net10.0-windows</TargetFramework>, o SDK .NET traduz isso em:

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

O NuGet utiliza estas propriedades do nome — não a TargetFramework cadeia — para verificações de compatibilidade de pacotes. Isto significa que o TargetFramework valor em si pode ser qualquer cadeia, desde que as propriedades do nome estejam corretamente definidas. Por exemplo, o seguinte projeto é 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 projeto restaura e compila para .NET 10.0, mesmo que o TargetFramework valor seja banana. O SDK .NET já depende deste mecanismo de aliasing para TFMs específicos do sistema operativo como net8.0-ios e net8.0-android, onde o TFM curto é traduzido para o nome completo com informação da plataforma.

Multidirecionamento com frameworks duplicados

A partir do NuGet 7.6 / .NET SDK 10.0.300, múltiplos TargetFrameworks aliases podem ser resolvidos para o mesmo framework eficaz. Isto permite cenários como compilações multi-RID e direcionamento de extensões multi-versão. Para detalhes sobre como isto funciona com restaurar, empacotar ficheiros de bloqueio e referências de projeto, veja Targeting multiple frameworks.

Estruturas suportadas

Uma framework é tipicamente referenciada por um nome de framework alvo curto ou TFM. No .NET Standard isto também é generalizado para o TxM para permitir uma única referência a múltiplos frameworks.

Os clientes NuGet suportam os frameworks apresentados na tabela abaixo. Os equivalentes são mostrados entre parênteses []. Note que algumas ferramentas, como dotnet, podem usar variações dos TFMs canónicos em alguns ficheiros. Por exemplo, dotnet pack usa .NETCoreApp2.0 num .nuspec ficheiro em vez de netcoreapp2.0. As várias ferramentas clientes NuGet lidam bem com estas variações, mas deve sempre usar TFMs canónicos ao editar ficheiros diretamente.

Frameworks obsoletos

Os seguintes frameworks estão obsoletos. Os pacotes direcionados a estes frameworks devem migrar para as substituições indicadas.

Precedence

Vários frameworks estão relacionados e compatíveis entre si, mas não necessariamente equivalentes:

NET Padrão

O .NET Standard simplifica referências entre frameworks compatíveis com binários, permitindo que um único framework alvo faça referência a uma combinação de outros. (Para contextualizar, veja o .NET Primer.)

A Ferramenta de Framework NuGet Get Nearest simula o que a NuGet utiliza para selecionar um framework entre muitos ativos de framework disponíveis num pacote baseado no framework do projeto.

A dotnet série de nomes deve ser usada no NuGet 3.3 e anteriores; a netstandard sintaxe dos nomes deve ser usada na v3.4 e posteriores.

Bibliotecas Portáteis de Classes

Para definir um framework alvo que se refira a múltiplos frameworks filhos-target, a portable palavra-chave usada para prefixar a lista de frameworks referenciados. Evite incluir artificialmente frameworks extra que não sejam diretamente compilados, pois isso pode levar a efeitos secundários indesejados nesses frameworks.

Frameworks adicionais definidos por terceiros proporcionam compatibilidade com outros ambientes acessíveis desta forma. Além disso, existem números de perfil abreviados disponíveis para referenciar estas combinações de frameworks relacionados como Profile#, mas não é uma prática recomendada usar estes números, pois reduz a legibilidade das pastas e .nuspec.

Adicionalmente, pacotes NuGet direcionados para Xamarin podem usar frameworks adicionais definidos por Xamarin: