.NET Standard SDK 样式项目中的目标框架

系列目录【已更新最新开发文章，点击查看详细】

包表示形式

　　.NET Standard 引用程序集的主要分发载体是 NuGet 包。实现会以适用于每个 .NET 实现的各种方式提供。

　　NuGet 包面向一个或多个框架。 .NET Standard 包定位“.NET Standard”框架。可以使用 netstandard 精简 TFM（例如 netstandard1.4）来设定 .NET Standard 框架作为目标。如果构建的库将用于在多个运行时上运行，就应将此框架作为目标。对于最广泛的 API 集，将 netstandard2.0 设定为目标，因为 .NET Standard 2.0 的可用 API 数量比 .NET Standard 1.6 的两倍还多。

.NETStandard.Library 元包引用定义 .NET Standard 的一整套 NuGet 包。要指定 netstandard 作为目标，最常见的方法是引用此元包。它描述并提供了对大约 40 个 .NET 库及定义 .Net Standard 的相关 API 的访问权限。可以引用以 netstandard 为目标的其他包来使用其他 API。

如何指定目标框架

　　以应用或库中的框架为目标时，需要指定想要向应用或库提供的 API 集。使用目标框架名字对象 (TFM) 在项目文件中指定目标框架。
　　应用或库可以使用 .NET Standard 版本作为目标。 .NET Standard 版本表示所有 .NET 实现中的标准化 API 集。例如，库可以使用 .NET Standard 1.6 作为目标，并获得对可使用相同基本代码跨 .NET Core 和 .NET Framework 工作的 API 的访问权限。
　　应用或库还能以一个特定 .NET 实现为目标，获得特定于实现的 API 的访问权限。例如，面向 Xamarin.iOS 的应用（如 Xamarin.iOS10）有权访问 Xamarin 提供的适用于 iOS 10 的 iOS API 包装器；面向通用 Windows 平台 (UWP) 的应用（如 uap10.0）有权访问为运行 Windows 10 的设备编译的 API。
　　对于某些目标框架（例如 .NET Framework），API 由框架在系统上安装的程序集定义，并且可能包括应用程序框架 API（例如 ASP.NET）。
　　对于基于包的目标框架（例如 .NET Standard 和 .NET Core），API 由包含在应用或库中的包定义。元包是一个 NuGet 包，NuGet 包本身不包含任何内容，只是一个依赖项列表（其他包）。基于 NuGet 包的目标框架隐式指定一个元包，该元包引用一起构成框架的所有包。

支持的目标框架

目标框架通常由 TFM 引用。下表显示 .NET SDK 和 NuGet 客户端支持的目标框架。等效项显示在括号内。例如，win81 对于 netcore451 来说等效于 TFM。

.NET 5 特定于 OS 的 TFM

对于每个 .NET 5.0 及更高版本的 TFM（例如 net5.0），都存在包含特定于 OS 的绑定的 TFM 变体。下表中显示了这些变体。

还可以指定可选的 OS 版本，例如 net5.0-ios12.0。有关 .NET 5 TFM 的详细信息，请参阅 .NET 5 中的目标框架名称。

如何指定目标框架

在项目文件中指定目标框架。指定单个目标框架时，使用 TargetFramework 元素。以下控制台应用项目文件演示了如何面向 .NET 5.0：

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net5.0</TargetFramework>
  </PropertyGroup>

</Project>

指定多个目标框架时，可有条件地为每个目标框架引用程序集。在代码中，可使用具有 -if-then-else 逻辑的预处理器符号，有条件地针对这些程序集进行编译。

　　以下库项目面向 .NET Standard (netstandard1.4) 和 .NET Framework（net40 和 net45）的 API。将复数形式的 TargetFrameworks 元素与多个目标框架一起使用。为两个 .NET Framework TFM 编译库时，Condition 属性包括特定于实现的包：

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFrameworks>netstandard1.4;net40;net45</TargetFrameworks>
  </PropertyGroup>

  <!-- 有条件地获取.NET Framework 4.0 目标的引用 -->
  <ItemGroup Condition=" '$(TargetFramework)' == 'net40' ">
    <Reference Include="System.Net" />
  </ItemGroup>

  <!-- 有条件地获取.NET Framework 4.5 目标引用 -->
  <ItemGroup Condition=" '$(TargetFramework)' == 'net45' ">
    <Reference Include="System.Net.Http" />
    <Reference Include="System.Threading.Tasks" />
  </ItemGroup>

</Project>

在库或应用中，使用预处理器指令编写条件代码，针对每个目标框架进行编译：

public class MyClass
{
    static void Main()
    {
#if NET40
        Console.WriteLine("Target framework: .NET Framework 4.0");
#elif NET45  
        Console.WriteLine("Target framework: .NET Framework 4.5");
#else
        Console.WriteLine("Target framework: .NET Standard 1.4");
#endif
    }
}

使用 SDK 样式项目时，生成系统可识别预处理器符号，这些符号表示支持的目标框架版本表中所示的目标框架。使用表示 .NET Standard、.NET Core 或 .NET 5 TFM 的符号时，请用下划线替换点和连字符，并将小写字母更改为大写字母（例如，netstandard1.4 的符号为 NETSTANDARD1_4）。

.NET 目标框架的预处理器符号的完整列表如下：