Framework di destinazione

NuGet usa riferimenti al framework di destinazione in un'ampia gamma di posizioni per identificare e isolare in modo specifico i componenti dipendenti dal framework di un pacchetto:

• file di progetto: per i progetti in stile SDK, il file con estensione csproj contiene i riferimenti al framework di destinazione.
• Manifesto .nuspec: un pacchetto può indicare pacchetti distinti da includere in un progetto a seconda del framework di destinazione del progetto.
• Nome cartella .nupkg: le cartelle all'interno della cartella di lib un pacchetto possono essere denominate in base al framework di destinazione, ognuna delle quali contiene le DLL e altro contenuto appropriato per tale framework.
• packages.config: l'attributo targetframework di una dipendenza specifica la variante di un pacchetto da installare.

Per l'elenco canonico di tutti i framework di destinazione supportati e la relativa sintassi TFM, vedere Framework di destinazione nei progetti in stile SDK.

I valori targetFramework sono alias

La TargetFramework proprietà in un file di progetto è un nome descrittivo, un alias, che viene convertito in un'identità del framework canonica. .NET SDK esegue questa conversione impostando ( TargetFrameworkMoniker TFM) e, se applicabile, le TargetPlatformMoniker proprietà.

Ad esempio, quando si scrive <TargetFramework>net10.0-windows</TargetFramework>, .NET SDK lo converte in:

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

NuGet usa queste proprietà del moniker, non la stringa, per i controlli di TargetFramework compatibilità dei pacchetti. Ciò significa che il TargetFramework valore stesso può essere qualsiasi stringa, purché le proprietà del moniker siano impostate correttamente. Ad esempio, il progetto seguente è valido:

<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>

Questo progetto ripristina e compila per .NET 10.0, anche se il TargetFramework valore è banana. .NET SDK si basa già su questo meccanismo di aliasing per tfm specifici del sistema operativo come net8.0-ios e net8.0-android, dove il tfm breve viene convertito nel moniker completo con informazioni sulla piattaforma.

Multitargeting con framework duplicati

A partire da NuGet 7.6 / .NET SDK 10.0.300, più TargetFrameworks alias possono essere risolti nello stesso framework efficace. Ciò consente scenari come compilazioni multi-RID e destinazione dell'estensione a più versioni. Per informazioni dettagliate su come funziona con il ripristino, il pacchetto, i file di blocco e i riferimenti al progetto, vedere Targeting di più framework.

Framework supportati

Un framework viene in genere fatto riferimento da un moniker del framework di destinazione breve o TFM. In .NET Standard viene generalizzato anche in TxM per consentire un singolo riferimento a più framework.

I client NuGet supportano i framework nella tabella seguente. Gli equivalenti vengono visualizzati tra parentesi quadre []. Si noti che alcuni strumenti, ad esempio dotnet, potrebbero usare varianti di TFM canoniche in alcuni file. Ad esempio, dotnet pack usa .NETCoreApp2.0 in un .nuspec file anziché netcoreapp2.0. I vari strumenti client NuGet gestiscono correttamente queste varianti, ma è consigliabile usare sempre tfm canonici durante la modifica diretta dei file.

Framework deprecati

I framework seguenti sono deprecati. I pacchetti destinati a questi framework devono eseguire la migrazione alle sostituzioni indicate.

Precedenza

Diversi framework sono correlati e compatibili tra loro, ma non necessariamente equivalenti:

NET Standard

.NET Standard semplifica i riferimenti tra framework compatibili con binari, consentendo a un singolo framework di destinazione di fare riferimento a una combinazione di altre. Per informazioni generali, vedere Nozioni di base su .NET.

Lo strumento NuGet Get Nearest Framework simula ciò che NuGet usa per selezionare un framework da molti asset framework disponibili in un pacchetto basato sul framework del progetto.

La serie di moniker deve essere usata in NuGet 3.3 e versioni precedenti. La dotnetnetstandard sintassi del moniker deve essere usata nella versione 3.4 e successive.

Librerie di classi portabili

Per definire un framework di destinazione che fa riferimento a più framework figlio-target,la portable parola chiave usata per anteporre l'elenco di framework a cui si fa riferimento. Evitare l'inclusione artificiale di framework aggiuntivi non compilati direttamente rispetto a perché può causare effetti collaterali imprevisti in tali framework.

Altri framework definiti da terze parti garantiscono la compatibilità con altri ambienti accessibili in questo modo. Inoltre, sono disponibili numeri di profilo abbreviati per fare riferimento a queste combinazioni di framework correlati come Profile#, ma questa non è una procedura consigliata per usare questi numeri perché riduce la leggibilità delle cartelle e .nuspec.

Inoltre, i pacchetti NuGet destinati a Xamarin possono usare framework Xamarin definiti aggiuntivi: