目標 Framework

NuGet 在各種位置使用目標 Framework 參考,具體識別並隔離套件的 Framework 相依元件:

  • 專案檔:針對 SDK 樣式專案, .csproj 包含目標 framework 參考。
  • .nuspec 資訊清單:套件可以根據專案的目標 Framework,指出專案要包含的確切套件。
  • .nupkg 資料夾名稱:套件的 lib 資料夾內的資料夾,可以根據目標 Framework 命名,各自包含 DLL 以及其他合適的內容。
  • packages.config:相依性的 targetframework 屬性會指定要安裝的套件 Variant。

注意

NuGet 支援所有新式 .net 目標 framework:

支援的架構

Framework 通常是簡短的目標 Framework Moniker 或 TFM 的參考對象。 在 .NET Standard 這也一般化 TxM ,以允許對多個架構的單一參考。

注意

計算下列表格的 NuGet 用戶端原始程式碼位在下列位置:

NuGet 用戶端支援下表中的 Framework 。 對等項目會顯示在 [] 括弧內。 請注意,某些工具,例如 dotnet,可能會在某些檔案中使用標準的 TFM 變化。 例如,會在檔案中 .nuspec 使用, dotnet pack 而不是 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 Store) 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
uap 10.0. xxxxx (其中10.0 是使用中應用程式的目標平臺最小版本)
.NET Standard netstandard netstandard1.0
netstandard1.1
netstandard1.2
netstandard1.3
netstandard1.4
netstandard1.5
netstandard1.6
netstandard2.0
netstandard 2。1
.NET 5 + (和 .NET Core) netcoreapp netcoreapp1.0
netcoreapp1.1
netcoreapp2.0
netcoreapp2.1
netcoreapp2.2
netcoreapp 3。0
netcoreapp 3。1
net net 5。0
net 6。0
Tizen tizen tizen3
tizen4

已被取代的架構

下列架構已被取代。 以這些架構為目標的套件應該移轉至所指出的取代項目。

已被取代的架構 取代
aspnet50 netcoreapp
aspnetcore50
dnxcore50
dnx
dnx45
dnx451
dnx452
dotnet netstandard
dotnet50
dotnet51
dotnet52
dotnet53
dotnet54
dotnet55
dotnet56
winrt win

優先順序

有一些 Framework 彼此相關且相容,但未必相等:

Framework 可使用
uap (通用 Windows 平台) win81
wpa81
netcore50
win (Microsoft Store) winrt

NET Standard

.NET Standard 可簡化二進位相容架構之間的參考,讓單一目標架構參考其他人的組合。 (背景請參閱 .NET 入門。)

NuGet 取得最接近的 Framework 工具會模擬 NuGet 使用的方法,從以專案 Framework 為基礎之套件中的許多可用 Framework 資產中選取一個 Framework。

NuGet 3.3 和更舊版本中應該使用 moniker 的 dotnet 系列,v3.4 及更新版本應使用 netstandard Moniker 語法。

可攜式類別庫

警告

不建議使用 PCL。 儘管支援 PCL,但套件作者應改支援 netstandard。 .NET 平臺標準是 Pcl 的演進,代表跨平臺的二進位可攜性,使用未系結至靜態程式庫(例如 便攜-a + b + c 的名字標記)的單一標記。

若要定義參考多個子目標 Framework 的目標 Framework,會使用 portable 關鍵字 作為參考之 Framework 清單的首碼。 避免以人為方式包含不會直接編譯的額外 Framework ,因為它會導致這些 Framework 出現非預期的副作用。

協力廠商定義的其他 Framework ,提供可以這種方式存取之其他環境的相容性。 此外,還有縮寫的設定檔編號,可用來參考這些相關 Framework 的組合,如 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 定義的 Framework。 請參閱 Manually Creating NuGet Packages for Xamarin (手動建立適用於 Xamarin 的 NuGet 套件)。

名稱 描述 .NET Standard
monoandroid Android 作業系統的 Mono 支援 netstandard1.4
monotouch iOS 的 Mono 支援 netstandard1.4
monomac OSX 的 Mono 支援 netstandard1.4
xamarinios 支援 Xamarin for iOS netstandard1.4
xamarinmac 支援 Xamarin for Mac netstandard1.4
xamarinpsthree 支援 Playstation 3 上的 Xamarin netstandard1.4
xamarinpsfour 支援 Playstation 4 上的 Xamarin netstandard1.4
xamarinpsvita 支援 PS Vita 上的 Xamarin netstandard1.4
xamarinwatchos Xamarin for Watch OS netstandard1.4
xamarintvos Xamarin for TV OS netstandard1.4
xamarinxboxthreesixty Xamarin for XBox 360 netstandard1.4
xamarinxboxone Xamarin for XBox One netstandard1.4

注意

Stephen Cleary 建立的工具可以列出支援的 PCL,您可以在他的文章中找到這項工具:Framework profiles in .NET (.NET 中的 Framework 設定檔)。