Versions cible de .Net Framework

NuGet utilise les références des versions cibles de .NET Framework à de nombreux endroits pour identifier et isoler spécifiquement les composants dépendants du framework d’un package :

• fichier projet : pour les projets de style SDK, le fichier .csproj contient les références de versions cibles.
• Manifeste .nuspec : un package peut désigner des packages distincts à inclure dans un projet en fonction de la version cible de .NET Framework du projet.
• Nom du dossier .nupkg : les dossiers à l’intérieur du dossier lib d’un package peuvent être nommés en fonction de la version cible de .NET Framework, chacun contenant les DLL et tout autre contenu appropriés pour ce framework.
• packages.config : l’attribut targetframework d’une dépendance spécifie la variante d’un package à installer.

Frameworks pris en charge

Un framework est généralement référencé par un moniker du Framework cible ou TFM court. Dans .NET Standard, ceci est également généralisé sous la forme TxM pour permettre une référence unique à plusieurs frameworks.

Les clients NuGet prennent en charge les frameworks dans le tableau ci-dessous. Les équivalents sont indiqués entre crochets []. Notez que certains outils, tels que dotnet, peuvent utiliser les variantes de monikers TFM canoniques dans certains fichiers. Par exemple, dotnet pack utilise .NETCoreApp2.0 dans un fichier .nuspec plutôt que netcoreapp2.0. Les différents outils du client NuGet gèrent correctement ces variantes, mais vous devez toujours utiliser des monikers TFM canoniques quand vous modifiez directement les fichiers.

Frameworks dépréciés

Les frameworks suivants sont dépréciés. Les packages ciblant ces frameworks doivent migrer vers les versions de remplacement indiquées.

Priorité

Un certain nombre de frameworks sont liés et compatibles entre eux, mais sans être nécessairement équivalents :

.NET Standard

.NET Standard simplifie les références entre les frameworks compatibles au niveau binaire, ce qui permet à un même framework cible de référencer une combinaison d’autres frameworks. (Pour obtenir des informations générales, consultez le Guide de .NET.)

L’outil Get Nearest Framework Nuget simule ce que NuGet utilise pour la sélection d’un framework à partir de nombreuses ressources de framework disponibles dans un package, en fonction du framework du projet.

La série dotnet des monikers doit être utilisée dans NuGet 3.3 et versions antérieures ; la syntaxe de moniker netstandard doit être utilisée dans v3.4 et versions ultérieures.

Bibliothèques de classes portables

Pour définir une version cible de .NET Framework qui fait référence à plusieurs frameworks-cibles-enfants, le mot clé portable est utilisé pour préfixer la liste des frameworks référencés. Évitez d’inclure artificiellement des frameworks supplémentaires qui ne sont pas directement compilés, car cela peut aboutir à des effets secondaires inattendus dans ces frameworks.

D’autres frameworks définis par des tiers assurent la compatibilité avec d’autres environnements qui sont accessibles de cette manière. De plus, il existe des numéros de profil abrégés qui sont disponibles pour faire référence à ces combinaisons de frameworks connexes en tant que Profile#, mais l’utilisation de ces numéros n’est pas recommandée, car cela réduit la lisibilité des dossiers et de .nuspec.

De plus, les packages NuGet ciblant Xamarin peuvent utiliser d’autres frameworks définis par Xamarin. Consultez Création de packages NuGet pour Xamarin.