目标框架

  • 项目

NuGet 在各个地方使用目标框架引用，以特别标识和隔离包的框架依赖组件：

  • 项目文件：对于 SDK 式项目，.csproj 包含目标框架引用。
  • .nuspec 清单：根据项目的目标框架，包可以指示要包含在项目中的不同包。
  • .nupkg 文件夹名称：包的 lib 文件夹内的文件夹可根据目标框架进行命名，每个文件夹都包含适合该框架的 DLL 及其他内容。
  • packages.config：依赖项的 targetframework 特性指定要安装的包的变体。

注意

NuGet 支持所有新式 .NET 目标框架：

支持的框架

通常按简短的目标框架名字对象或 TFM 引用框架。 在 .NET Standard 中，这也被泛化成 TxM，以便一次引用多个框架。

注意

计算下方表格的 NuGet 客户端源代码位于以下位置：

NuGet 客户端支持下表中的框架。 等效项显示在括号内 []。 请注意，某些工具（如 dotnet）可能会在某些文件中使用规范的 TFM 变体。 例如，dotnet pack 在 .nuspec 文件中会使用 .NETCoreApp2.0，而非 netcoreapp2.0。 各种 NuGet 客户端工具正确处理这些变体，但是在直接编辑文件时，应始终使用规范的 TFM。

名称 缩写 TFM/TxM
.NET Framework net net11
net20
net35
net40
net403
net45
net451
net452
net46
net461
net462
net47
net471
net472
net48
Microsoft Store（Windows 应用商店） netcore netcore [netcore45]
netcore45 [win, win8]
netcore451 [win81]
netcore50
.NET MicroFramework netmf netmf
Windows win win [win8、netcore45]
win8 [netcore45、win]
win81 [netcore451]
win10（Windows 10 平台不支持）
Silverlight sl sl4
sl5
Windows Phone (SL) wp wp [wp7]
wp7
wp75
wp8
wp81
Windows Phone (UWP) wpa81
通用 Windows 平台 uap uap [uap10.0]
uap10.0
uap10.0.xxxxx（其中，10.0.xxxxx 为使用应用的目标平台最低版本）
.NET Standard netstandard netstandard1.0
netstandard1.1
netstandard1.2
netstandard1.3
netstandard1.4
netstandard1.5
netstandard1.6
netstandard2.0
netstandard2.1
.NET 5 及更高版本（和 .NET Core） netcoreapp netcoreapp1.0
netcoreapp1.1
netcoreapp2.0
netcoreapp2.1
netcoreapp2.2
netcoreapp3.0
netcoreapp3.1
net net5.0
net6.0
net7.0
net8.0
Tizen tizen tizen3
tizen4
Native 本机 本机

弃用的框架

以下框架已弃用。 定位这些框架的包应迁移到指明的替代框架。

弃用的框架 Replacement
aspnet50 netcoreapp
aspnetcore50
dnxcore50
dnx
dnx45
dnx451
dnx452
dotnet netstandard
dotnet50
dotnet51
dotnet52
dotnet53
dotnet54
dotnet55
dotnet56
winrt win

优先顺序

许多框架相互关联且彼此兼容，但不一定是等效的：

框架 可以使用
uap（通用 Windows 平台） win81
wpa81
netcore50
win (Microsoft Store) winrt

NET Standard

.NET Standard 简化了二进制兼容框架之间的引用，从而允许一个目标框架引用其他框架的组合。 （有关背景信息，请参阅 .NET 入门。）

NuGet 获取最新框架工具模拟用于从基于项目框架的包中的许多可用框架资产中选择一个框架的 NuGet 逻辑。

NuGet 3.3 及更早版本应该使用 dotnet 系列的名字对象；v3.4 及更高版本应该使用 netstandard 名字对象语法。

可移植类库

警告

建议不要使用 PCL。 尽管支持 PCL，但包创建者反而应支持 netstandard。 .NET 平台标准是 PCL 的一种演变，且表示跨平台的二进制可移植性，它使用未绑定到静态库的单个名字对象（如 portable-a+b+c 名字对象）。

若要定义一个引用多个子目标框架的目标框架，请使用 portable 关键字作为所引用框架列表的前缀。 避免人为地包含非直接编译的额外框架，因为可能会导致这些框架中出现意外的负面效果。

由第三方定义的附加框架提供了与其他环境的兼容性，这些环境可通过此方式进行访问。 此外，还有速记配置文件编号，可用于以 Profile# 形式引用相关框架的组合，但不建议通过此方法引用这些编号，因为这会降低文件夹和 .nuspec 的可读性。

配置文件编号 框架 全名 .NET Standard
Profile2 .NETFramework 4.0 portable-net40+win8+sl4+wp7
Windows 8.0
Silverlight 4.0
WindowsPhone 7.0
Profile3 .NETFramework 4.0 portable-net40+sl4
Silverlight 4.0
Profile4 .NETFramework 4.5 portable-net45+sl4+win8+wp7
Silverlight 4.0
Windows 8.0
WindowsPhone 7.0
Profile5 .NETFramework 4.0 portable-net40+win8
Windows 8.0
Profile6 .NETFramework 4.0.3 portable-net403+win8
Windows 8.0
Profile7 .NETFramework 4.5 portable-net45+win8 netstandard1.1
Windows 8.0
Profile14 .NETFramework 4.0 portable-net40+sl5
Silverlight 5.0
Profile18 .NETFramework 4.0.3 portable-net403+sl4
Silverlight 4.0
Profile19 .NETFramework 4.0.3 portable-net403+sl5
Silverlight 5.0
Profile23 .NETFramework 4.5 portable-net45+sl4
Silverlight 4.0
Profile24 .NETFramework 4.5 portable-net45+sl5
Silverlight 5.0
Profile31 Windows 8.1 portable-win81+wp81 netstandard1.0
WindowsPhone 8.1 (SL)
Profile32 Windows 8.1 portable-win81+wpa81 netstandard1.2
WindowsPhone 8.1 (UWP)
Profile36 .NETFramework 4.0 portable-net40+sl4+win8+wp8
Silverlight 4.0
Windows 8.0
WindowsPhone 8.0 (SL)
Profile37 .NETFramework 4.0 portable-net40+sl5+win8
Silverlight 5.0
Windows 8.0
Profile41 .NETFramework 4.0.3 portable-net403+sl4+win8
Silverlight 4.0
Windows 8.0
Profile42 .NETFramework 4.0.3 portable-net403+sl5+win8
Silverlight 5.0
Windows 8.0
Profile44 .NETFramework 4.5.1 portable-net451+win81 netstandard1.2
Windows 8.1
Profile46 .NETFramework 4.5 portable-net45+sl4+win8
Silverlight 4.0
Windows 8.0
Profile47 .NETFramework 4.5 portable-net45+sl5+win8
Silverlight 5.0
Windows 8.0
Profile49 .NETFramework 4.5 portable-net45+wp8 netstandard1.0
WindowsPhone 8.0 (SL)
Profile78 .NETFramework 4.5 portable-net45+win8+wp8 netstandard1.0
Windows 8.0
WindowsPhone 8.0 (SL)
Profile84 WindowsPhone 8.1 portable-wp81+wpa81 netstandard1.0
WindowsPhone 8.1 (UWP)
Profile88 .NETFramework 4.0 portable-net40+sl4+win8+wp75
Silverlight 4.0
Windows 8.0
WindowsPhone 7.5
Profile92 .NETFramework 4.0 portable-net40+win8+wpa81
Windows 8.0
WindowsPhone 8.1 (UWP)
Profile95 .NETFramework 4.0.3 portable-net403+sl4+win8+wp7
Silverlight 4.0
Windows 8.0
WindowsPhone 7.0
Profile96 .NETFramework 4.0.3 portable-net403+sl4+win8+wp75
Silverlight 4.0
Windows 8.0
WindowsPhone 7.5
Profile102 .NETFramework 4.0.3 portable-net403+win8+wpa81
Windows 8.0
WindowsPhone 8.1 (UWP)
Profile104 .NETFramework 4.5 portable-net45+sl4+win8+wp75
Silverlight 4.0
Windows 8.0
WindowsPhone 7.5
Profile111 .NETFramework 4.5 portable-net45+win8+wpa81 netstandard1.1
Windows 8.0
WindowsPhone 8.1 (UWP)
Profile136 .NETFramework 4.0 portable-net40+sl5+win8+wp8
Silverlight 5.0
Windows 8.0
WindowsPhone 8.0 (SL)
Profile143 .NETFramework 4.0.3 portable-net403+sl4+win8+wp8
Silverlight 4.0
Windows 8.0
WindowsPhone 8.0 (SL)
Profile147 .NETFramework 4.0.3 portable-net403+sl5+win8+wp8
Silverlight 5.0
Windows 8.0
WindowsPhone 8.0 (SL)
Profile151 NETFramework 4.5.1 portable-net451+win81+wpa81 netstandard1.2
Windows 8.1
WindowsPhone 8.1 (UWP)
Profile154 .NETFramework 4.5 portable-net45+sl4+win8+wp8
Silverlight 4.0
Windows 8.0
WindowsPhone 8.0 (SL)
Profile157 Windows 8.1 portable-win81+wp81+wpa81 netstandard1.0
WindowsPhone 8.1 (SL)
WindowsPhone 8.1 (UWP)
Profile158 .NETFramework 4.5 portable-net45+sl5+win8+wp8
Silverlight 5.0
Windows 8.0
WindowsPhone 8.0 (SL)
Profile225 .NETFramework 4.0 portable-net40+sl5+win8+wpa81
Silverlight 5.0
Windows 8.0
WindowsPhone 8.1 (UWP)
Profile240 .NETFramework 4.0.3 portable-net403+sl5+win8+wpa8
Silverlight 5.0
Windows 8.0
WindowsPhone 8.1 (UWP)
Profile255 .NETFramework 4.5 portable-net45+sl5+win8+wpa81
Silverlight 5.0
Windows 8.0
WindowsPhone 8.1 (UWP)
Profile259 .NETFramework 4.5 portable-net45+win8+wpa81+wp8 netstandard1.0
Windows 8.0
WindowsPhone 8.1 (UWP)
WindowsPhone 8.0 (SL)
Profile328 .NETFramework 4.0 portable-net40+sl5+win8+wpa81+wp8
Silverlight 5.0
Windows 8.0
WindowsPhone 8.1 (UWP)
WindowsPhone 8.0 (SL)
Profile336 .NETFramework 4.0.3 portable-net403+sl5+win8+wpa81+wp8
Silverlight 5.0
Windows 8.0
WindowsPhone 8.1 (UWP)
WindowsPhone 8.0 (SL)
Profile344 .NETFramework 4.5 portable-net45+sl5+win8+wpa81+wp8
Silverlight 5.0
Windows 8.0
WindowsPhone 8.1 (UWP)
WindowsPhone 8.0 (SL)

另外，面向 Xamarin 的 NuGet 包可以使用 Xamarin 定义的其他框架。 请参阅创建适用于 Xamarin 的 NuGet 包。

名称 描述 .NET Standard
monoandroid Mono 支持 Android OS netstandard1.4
monotouch Mono 支持 iOS netstandard1.4
monomac Mono 支持 OSX netstandard1.4
xamarinios 支持适用于 iOS 的 Xamarin netstandard1.4
xamarinmac 支持适用于 Mac 的 Xamarin netstandard1.4
xamarinpsthree 支持 Playstation 3 上的 Xamarin netstandard1.4
xamarinpsfour 支持 Playstation 4 上的 Xamarin netstandard1.4
xamarinpsvita 支持 PS Vita 上的 Xamarin netstandard1.4
xamarinwatchos 适用于 Watch OS 的 Xamarin netstandard1.4
xamarintvos 适用于 TV OS 的 Xamarin netstandard1.4
xamarinxboxthreesixty 适用于 XBox 360 的 Xamarin netstandard1.4
xamarinxboxone 适用于 XBox One 的 Xamarin netstandard1.4

注意

Stephen Cleary 创建了一种工具，用于列出支持的 PCL，该工具可在其文章 Framework profiles in .NET（.NET 中的框架配置文件）中找到。