支持项目文件中的多个 .NET Framework 版本

  • 项目

首次创建项目时，建议创建 .NET Standard 类库，因为它提供了与最广泛使用项目的兼容性。 使用 .NET Standard 可以默认向 .NET 库添加跨平台支持。 但是，在某些情况下，可能还需要包含针对特定框架的代码。 本文介绍如何针对 SDK 样式的项目执行该操作。

对于 SDK 样式的项目，可以在项目文件中配置对多个目标框架 (TFM) 的支持，然后使用dotnet pack 或 msbuild /t:pack 创建包。

注意

nuget.exe CLI 不支持打包 SDK 样式的项目，因此应只使用 dotnet pack 或 msbuild /t:pack。 我们建议改为包含所有属性（项目文件的 .nuspec 文件中通常包含的所有属性）。 要在非 SDK 样式的项目中以多个 .NET Framework 版本为目标，请参阅支持多个 .NET Framework 版本。

创建一个支持多个 .NET Framework 版本的项目

  1. 在 Visual Studio 中或使用 dotnet new classlib 创建新的 .NET Standard 类库。

    建议创建 .NET Standard 类库以获得最佳兼容性。

  2. 编辑 .csproj 文件以支持目标框架。 例如，更改

    <TargetFramework>netstandard2.0</TargetFramework>

    更改为：

    <TargetFrameworks>netstandard2.0;net45</TargetFrameworks>

    确保将 XML 元素从单数更改为复数（将“s”添加到开始和结束标记）。

  3. 如果你有任何仅在一个 TFM 中工作的代码，则可以使用 #if NET45 或 #if NETSTANDARD2_0 分隔与 TFM 相关的代码。 （有关详细信息，请参阅如何设定多目标。）例如，可以使用以下代码：

    public string Platform {
   get {
#if NET45
      return ".NET Framework"
#elif NETSTANDARD2_0
      return ".NET Standard"
#else
#error This code block does not match csproj TargetFrameworks list
#endif
   }
}

  4. 将你需要的任何 NuGet 元数据添加到 .csproj 作为 MSBuild 属性。

    有关可用包元数据和 MSBuild 属性名称的列表，请参阅 pack 目标。 另请参阅控制依赖项资产。

    如果要将与生成相关的属性与 NuGet 元数据分开，可以使用不同的 PropertyGroup，或将 NuGet 属性放在另一个文件中，并使用 MSBuild 的 Import 指令将其包含在内。 从 MSBuild 15.0. 开始，还支持 Directory.Build.Props 和 Directory.Build.Targets。

  5. 现在，使用 dotnet pack 和生成的 .nupkg 以 .NET Standard 2.0 和 .NET Framework 4.5 为目标。

以下是使用上述步骤和 .NET Core SDK 2.2 生成的 .csproj 文件。

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

  <PropertyGroup>
    <TargetFrameworks>netstandard2.0;net45</TargetFrameworks>
    <Description>Sample project that targets multiple TFMs</Description>
  </PropertyGroup>

</Project>

另请参阅