Estruturas de destino

O NuGet usa referências de estrutura de destino em uma variedade de locais para identificar e isolar especificamente componentes dependentes da estrutura de um pacote:

• arquivo de projeto: para projetos no estilo SDK, o .csproj contém as referências da estrutura de destino.
• Manifesto .nuspec: um pacote pode indicar pacotes distintos a serem incluídos em um projeto, dependendo da estrutura de destino do projeto.
• Nome da pasta .nupkg: as pastas dentro da pasta de lib um pacote podem ser nomeadas de acordo com a estrutura de destino, cada uma contendo as DLLs e outro conteúdo apropriado para essa estrutura.
• packages.config: o targetframework atributo de uma dependência especifica a variante de um pacote a ser instalado.

Para obter a lista canônica de todas as estruturas de destino com suporte e sua sintaxe TFM, consulte as estruturas de destino em projetos no estilo SDK.

Os valores de TargetFramework são aliases

A TargetFramework propriedade em um arquivo de projeto é um nome amigável — um alias — que é convertido em uma identidade de estrutura canônica. O SDK do .NET executa essa tradução definindo o TargetFrameworkMoniker (TFM) e, quando aplicável, as TargetPlatformMoniker propriedades.

Por exemplo, quando você escreve <TargetFramework>net10.0-windows</TargetFramework>, o SDK do .NET converte isso em:

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

O NuGet usa essas propriedades de moniker — não a TargetFramework cadeia de caracteres — para verificações de compatibilidade de pacote. Isso significa que o TargetFramework valor em si pode ser qualquer cadeia de caracteres, desde que as propriedades do moniker sejam definidas corretamente. Por exemplo, o projeto a seguir é 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>

Esse projeto restaura e cria para o .NET 10.0, mesmo que o TargetFramework valor seja banana. O SDK do .NET já depende desse mecanismo de aliasing para TFMs específicos do sistema operacional, como net8.0-ios e net8.0-android, em que o TFM curto é traduzido para o moniker completo com informações da plataforma.

Direcionamento múltiplo com estruturas duplicadas

A partir do NuGet 7.6 /.NET SDK 10.0.300, vários TargetFrameworks aliases podem ser resolvidos para a mesma estrutura efetiva. Isso permite cenários como builds multi-RID e direcionamento de extensão de várias versões. Para obter detalhes sobre como isso funciona com restauração, pacote, arquivos de bloqueio e referências de projeto, consulte Direcionamento de várias estruturas.

Estruturas com suporte

Uma estrutura normalmente é referenciada por um pequeno moniker de estrutura de destino ou TFM. No .NET Standard, isso também é generalizado no TxM para permitir uma única referência a várias estruturas.

Os clientes NuGet dão suporte às estruturas na tabela abaixo. Os equivalentes são mostrados entre colchetes []. Observe que algumas ferramentas, como dotnet, podem usar variações de TFMs canônicas em alguns arquivos. Por exemplo, dotnet pack usa em um .nuspec arquivo em vez de netcoreapp2.0.NETCoreApp2.0 . As várias ferramentas de cliente do NuGet lidam com essas variações corretamente, mas você sempre deve usar TFMs canônicas ao editar arquivos diretamente.

Estruturas preteridas

As estruturas a seguir são preteridas. Os pacotes direcionados a essas estruturas devem migrar para as substituições indicadas.

Precedence

Várias estruturas estão relacionadas e compatíveis entre si, mas não necessariamente equivalentes:

NET Standard

O .NET Standard simplifica as referências entre estruturas compatíveis com binários, permitindo que uma única estrutura de destino faça referência a uma combinação de outras. (Para obter plano de fundo, consulte o .NET Primer.)

A Ferramenta nuget Get Nearest Framework simula o que o NuGet usa para selecionar uma estrutura de muitos ativos de estrutura disponíveis em um pacote com base na estrutura do projeto.

A dotnet série de monikers deve ser usada no NuGet 3.3 e anterior; a netstandard sintaxe do moniker deve ser usada na v3.4 e posterior.

Bibliotecas de classes portáteis

Para definir uma estrutura de destino que se refere a várias estruturas filho-destino, a portable palavra-chave usada para prefixar a lista de estruturas referenciadas. Evite incluir artificialmente estruturas extras que não são diretamente compiladas porque elas podem levar a efeitos colaterais não intencionais nessas estruturas.

Estruturas adicionais definidas por terceiros fornecem compatibilidade com outros ambientes acessíveis dessa maneira. Além disso, há números de perfil abreviados disponíveis para fazer referência a essas combinações de estruturas relacionadas, Profile#mas essa não é uma prática recomendada para usar esses números, pois reduz a legibilidade das pastas e .nuspec.

Além disso, os pacotes NuGet direcionados ao Xamarin podem usar estruturas adicionais definidas pelo Xamarin: