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

   在.NET Standard/.NET Core技术出现之前,编写一个类库项目(暂且称为基础通用类库PA)且需要支持不同 .NET Framework 版本,那么可行的办法就是创建多个不同版本的项目(暂且称为PB1、PB2、PB3 … PBn)。PB1、PB2、PB3 … PBn项目分别执行下面操作:【添加】–【现有项】–【添加为链接的方式】,将PA项目代码文件添加到各自项目中,如果代码不同,则需要使用#if #else #endif 等标签来判断 .NET Framework 版本。而在.NET Standard/.NET Core技术出现之后,可以通过配置SDK 样式项目中的目标框架来支持一套代码同时输出多版本类库。

  下面以Visual Studio 2019 来演示整个操作过程。

1、新建一个 .NET Standard 类库。

142275 20200930170250867 80941463 - .NET Standard中配置TargetFrameworks输出多版本类库

2、填写项目名称

142275 20200930170436528 1078409265 - .NET Standard中配置TargetFrameworks输出多版本类库

 3、创建完成后,查看“解决方案资源管理器”,项目下面多了一个“依赖项”节点,子节点是SDK,孙子节点是 NETStandard.Library(2.0.3)。

142275 20200930170534521 138532274 - .NET Standard中配置TargetFrameworks输出多版本类库

 项目组织方式与传统类库项目的组织方式不同

142275 20200930171010631 2098652517 - .NET Standard中配置TargetFrameworks输出多版本类库

 4、项目,右键【属性】–>【应用程序】–> “目标框架”默认是 .NET Standard 2.0。

142275 20200930171323801 812028395 - .NET Standard中配置TargetFrameworks输出多版本类库

 

也可以修改为其他版本

142275 20201010092453621 488874973 - .NET Standard中配置TargetFrameworks输出多版本类库

 

5、编译项目,查看bin –> debug。生成了 netstandard2.0目录

 142275 20200930171414171 1831255931 - .NET Standard中配置TargetFrameworks输出多版本类库

目录里面生成的DLL,这与传统.NET Framework 类型的类库项目生成结果相同。

142275 20200930171904162 374325407 - .NET Standard中配置TargetFrameworks输出多版本类库

6、项目,右键 –> “编辑项目文件”

 142275 20200930171501347 1400041073 - .NET Standard中配置TargetFrameworks输出多版本类库

 142275 20200930171600467 159531644 - .NET Standard中配置TargetFrameworks输出多版本类库

可以看到当前类库默认为 netstandard2.0,而此时其xml标签为 TargetFramework

如果要支持多版本,则需要做调整,将 TargetFramework 节点修改为 TargetFrameworks,再添加目标版本。

7、配置多目标框架

关于如何指定多目标框架,请参考博客《.NET Standard SDK 样式项目中的目标框架》

 我做的BIMFACE二次开发的接口的目标是支持 .NET Framework4.0、.NET Framework4.5 以及 .NET Core3.1。所以配置了选下3个目标版本

 <PropertyGroup>
    <TargetFrameworks>net40;net45;netstandard2.0;</TargetFrameworks> <!--输出多版本类库-->
  </PropertyGroup>

 修改后并保存,Visual Studio 会弹出黄色背景的提示信息。

142275 20200930172459222 1788999102 - .NET Standard中配置TargetFrameworks输出多版本类库

这里一定要点击【重新加载项目】按钮。重新加载后,依赖项中出现了如下图所示的3个项

142275 20200930172635437 1023685344 - .NET Standard中配置TargetFrameworks输出多版本类库

 展开每个项查看, 每个版本的程序集对应一个单独的依赖项节点。

142275 20200930172703874 925017745 - .NET Standard中配置TargetFrameworks输出多版本类库

8、项目,右键【属性】–>【应用程序】–> “目标框架”被禁用,因为单个项目支持多版本类库,无法一次呈现多个,这是正确的。

 142275 20200930173239637 2084323003 - .NET Standard中配置TargetFrameworks输出多版本类库

 9、重新编译项目,查看bin –> debug,生成了3种不同版本的目标程序集。

142275 20200930173320215 1890943976 - .NET Standard中配置TargetFrameworks输出多版本类库

 

通过上面的步骤我们已经实现了多版本输出,但是在实际的企业级业务系统开发时情况比较复杂,还需要解决以下几个问题:

1、条件编译

2、引用本地程序集

3、NuGet方式引用程序集

4、XML文档输出

5、编码与DEBUG 调试

6、自动生成内部版本号

7、文件复制

 

下面逐步讲解如何解决以上问题。

一、条件编译
在下图中可以看出,编译成功后,在项目的默认位置 bin\Debug 下生成了3个不同目录,分别对应3个目标版本。
142275 20201009165542435 435771927 - .NET Standard中配置TargetFrameworks输出多版本类库

这是VS中默认的编译输出目录。

如果需要配置不同的类库输出到不同的位置,也可以自定义配置输出路径实现。

查看项目属性,【生成】–>“输出”–>“输出路径”中输入自定义目录或者点击【浏览】按钮选择一个目录。

142275 20201009170404290 604339432 - .NET Standard中配置TargetFrameworks输出多版本类库

填写后,保存项目。项目右键,【编辑项目文件】,csproj文件中自动增加了如下配置,其中 Condition 后面的表达式即是编译条件。OutputPath即是自定义输出目录。

  <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|net40|AnyCPU'">
    <OutputPath>bin\Debug\</OutputPath>
  </PropertyGroup>

按照以上方式再复制2份,分别配置 net45 与 netstandard2.0版。完整配置如下:

<!--条件编译-->
  <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|Release|net40|AnyCPU'">
    <OutputPath>bin\Debug\</OutputPath><!--编译后的文件输出目录-->
  </PropertyGroup>

  <!--条件编译-->
  <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|Release|net45|AnyCPU'">
    <OutputPath>bin\Debug\</OutputPath>
  </PropertyGroup>

  <!--条件编译-->
  <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|Release|netstandard2.0|AnyCPU'">
    <OutputPath>bin\Debug\</OutputPath>
  </PropertyGroup>
bin\Debug\ 是我自己定义的输出目录,大家可以根据实际需求填写其他目录。

$(Configuration) 的条件值有:Debug、Release。142275 20201010114454379 910926151 - .NET Standard中配置TargetFrameworks输出多版本类库

 

 

$(TargetFramework)的条件为 <TargetFrameworks>节点中配置的值。

$(Platform) 的条件值有:142275 20201010114710014 1176041149 - .NET Standard中配置TargetFrameworks输出多版本类库

 

 

 

查看项目属性,【生成】–>“常规”–>“条件编译和符号”中输入自定义内容。选择 “定义DEGUG常数” 与 “定义TRACE常量”,保存项目。

142275 20201010144902257 2100875001 - .NET Standard中配置TargetFrameworks输出多版本类库

查看csproj文件,在第一个目标版本对应的 <PropertyGroup> 配置节点下增加了

<DefineConstants>TRACE;DEBUG;NET_FULL;TEST;</DefineConstants>

为了做统一配置,将其提取出来

 <PropertyGroup Condition=" '$(Configuration)' == 'Debug|Release' ">
    <!--统一定义的常量-->
    <DefineConstants>TRACE;DEBUG;RELEASE;NET_FULL;TEST;</DefineConstants>
  </PropertyGroup>

 

二、引用本地程序集

在下图中可以看出由于3个不同的输出类库中所引用的程序集是不同的,那么当编译时,一定是每个类库进行单独编译,这时就就需要通过某种方式告诉编译器当前编译的类库版本是什么,然后添加针对具体版本的第三方程序集引用。

142275 20201009171420065 1802138732 - .NET Standard中配置TargetFrameworks输出多版本类库

.NET Standard 指定多个目标框架时,可有条件地为每个目标框架引用程序集。

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

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

  <PropertyGroup>
    <TargetFrameworks>netstandard2.0;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>

 

下面开始添加引用,点击项目子节点【依赖项】–>【添加程序集引用】

142275 20201009172107744 1975315852 - .NET Standard中配置TargetFrameworks输出多版本类库

打开如下界面。默认加载的目标框架显示为 .NET Framework 4。

142275 20201009172411267 1236607686 - .NET Standard中配置TargetFrameworks输出多版本类库

如何才能添加 net45 或者 netstandard2.1 的引用呢?正常来说应该在VS的“引用管理器”界面上提供目标框架的下拉选择框,可以自由切换选择不同的目标框架,但是到目前为止VS没有此功能,我的VS版本信息如下

142275 20201009173026347 1866163217 - .NET Standard中配置TargetFrameworks输出多版本类库

希望微软在后续VS版本中能增加此功能。

回到csproj编辑界面,可以看到 TargetFrameworks 值第一个为 net40,估计与这个有关系。

142275 20201009173614275 1971965551 - .NET Standard中配置TargetFrameworks输出多版本类库

通过取巧的方式调整 TargetFrameworks 里的版本先后顺序,保存后,重启VS(我的VS2019是这种情况,需要重启才生效。不知道其他小伙伴们的VS是不是保存后可以自动切换呢?)

142275 20201009173829063 1167745046 - .NET Standard中配置TargetFrameworks输出多版本类库 

再次添加程序集引用,此时加载了 .NET Framework 4.5

142275 20201009174033253 725440792 - .NET Standard中配置TargetFrameworks输出多版本类库

 添加一个“System.Net.dll”引用来测试一下

142275 20201009174212818 1782963045 - .NET Standard中配置TargetFrameworks输出多版本类库

添加后,如下图所示

142275 20201009174600330 1031472396 - .NET Standard中配置TargetFrameworks输出多版本类库

.NET Framework 4.5 项目中多了“System.Net.dll”引用。但是 .NET Standard 2.0 前面显示黄色警告符合。展开所有依赖项,.NET Framework 4.0 与 .NET Framework 4.5 都已经正确引用。

142275 20201009174826604 618771111 - .NET Standard中配置TargetFrameworks输出多版本类库

.NET Standard 2.0 程序及引用有警告。这表示 netstandard2.0 并不知道 System.Net.dll 是什么。

查看.csproj文件

142275 20201009174914874 1834997035 - .NET Standard中配置TargetFrameworks输出多版本类库

红色框内的配置,表示net40、.net45 和 netstand2.0 都需要“System.Net”引用(即统一配置),而实际只有 net40、.net45 才需要该引用,所以这里我们要使用 Condition 条件,修改如下:

142275 20201009174956536 1336889296 - .NET Standard中配置TargetFrameworks输出多版本类库

这样只有 .net40 与 .net45 条件下才引用“System.Net.dll”。保存后,发现 netstand2.0 下面的警告标示消失了。

三、NuGet 方式引用程序集

下面演示添加一个多版本都支持的第三方类库,NLog 日志组件,目前最新版本为4.7.5。通过 NuGet 方式添加引用

142275 20201009175715905 2121202200 - .NET Standard中配置TargetFrameworks输出多版本类库

下图可以看出该组件同时支持 .NET4.0、.NET4.5 以及 .NET Standard 2.0 

142275 20201009175731251 1644107918 - .NET Standard中配置TargetFrameworks输出多版本类库

点击【安装】

142275 20201009175900255 197033243 - .NET Standard中配置TargetFrameworks输出多版本类库

点击【确定】,安装完成后,每一个类库均添加了引用

142275 20201009175937804 59732191 - .NET Standard中配置TargetFrameworks输出多版本类库

 查看.csproj文件,添加了如下配置

142275 20201009180041868 1309026105 - .NET Standard中配置TargetFrameworks输出多版本类库

注意这里是 PackageReference,而之前程序集的是 Reference,而且我们也会发现在VS解决方案管理器中并没有出现 packages.config 文件。默认在 sln 文件的同级也没有创建一个 packages 文件夹。

142275 20201009180132658 1264815368 - .NET Standard中配置TargetFrameworks输出多版本类库

 而是将dll下载到了C:\Users\当前登录用户\.nuget目录下,这与java的Maven管理方式类似。我的本地路径为:C:\Users\Savion\.nuget\packages

142275 20201009180217161 1549270094 - .NET Standard中配置TargetFrameworks输出多版本类库

142275 20201009180229597 1897274044 - .NET Standard中配置TargetFrameworks输出多版本类库

 

下面再添加一个 netstandard 专有的 nuget 引用 Microsoft.Extensions.DependencyInjection.dll

142275 20201009180307765 1141513786 - .NET Standard中配置TargetFrameworks输出多版本类库

点击【安装】

142275 20201009180332864 772713295 - .NET Standard中配置TargetFrameworks输出多版本类库

点击【确定】

142275 20201009180352170 941373171 - .NET Standard中配置TargetFrameworks输出多版本类库

点击【我接受】。

添加完后解决方案中仅有 .NET Standard2.0 中增加了引用。.net40 与 .net45 中没有引用。

142275 20201009180542282 287534003 - .NET Standard中配置TargetFrameworks输出多版本类库

 添加完后 csproj文件 会多出如下配置

142275 20201009180623490 2089540849 - .NET Standard中配置TargetFrameworks输出多版本类库

NuGet 很智能,自动把 Condition 给加好了。

四、XML文档输出

选择项目,点击 属性–>生成,勾选 “XML 文档文件”。默认生成的xml文件名称包含绝对路径,这个名称不是很友好,一般修改为程序集的名称即可

142275 20201010095000920 227332757 - .NET Standard中配置TargetFrameworks输出多版本类库

 点击菜单栏上的【保存】按钮。查看.csproj文件新增了如下配置:

142275 20201010095050977 531722024 - .NET Standard中配置TargetFrameworks输出多版本类库

 这表示 net40 会生成 xml 文件,将该配置信息复制两份,然后修改 Platform 以及输出路径为 net45 与 netstandard2.0。完整配置如下:

 <!--条件编译-->
  <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|Release|net40|AnyCPU'">
    <DocumentationFile>ZCN.NET.BIMFace.SDK.xml</DocumentationFile><!--xml文档,输出类库中方法与参数的注释等信息-->
    <OutputPath>bin\Debug\</OutputPath><!--编译后的文件输出目录-->
  </PropertyGroup>

  <!--条件编译-->
  <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|Release|net45|AnyCPU'">
    <DocumentationFile>ZCN.NET.BIMFace.SDK.xml</DocumentationFile>
    <OutputPath>bin\Debug\</OutputPath>
  </PropertyGroup>

  <!--条件编译-->
  <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|Release|netstandard2.0|AnyCPU'">
    <DocumentationFile>ZCN.NET.BIMFace.SDK.xml</DocumentationFile>
    <OutputPath>bin\Debug\</OutputPath>
  </PropertyGroup>

重新编译项目,查看输出目录里面的内容

142275 20201010095232836 2132760595 - .NET Standard中配置TargetFrameworks输出多版本类库

 142275 20201010095245931 2001499592 - .NET Standard中配置TargetFrameworks输出多版本类库

 142275 20201010095306186 1090920052 - .NET Standard中配置TargetFrameworks输出多版本类库

142275 20201010095325308 1814045552 - .NET Standard中配置TargetFrameworks输出多版本类库

 其中ZCN.NET.BIMFace.SDK.xml 内容如下

142275 20201010100222596 565938689 - .NET Standard中配置TargetFrameworks输出多版本类库

  .netstandard2.0 中多了一个 ZCN.NET.BIMFace.SDK.deps.josn 文件,里面包含了运行时环境以及依赖项等信息

 142275 20201010100302973 1488553750 - .NET Standard中配置TargetFrameworks输出多版本类库

五、编码与DEBUG调试
   虽然 .NET Standard 支持编写一套代码编译输出支持多平台,但是实际编码中会遇到很多特殊情况需要使用条件指令进行区分逻辑,比如编写一个扩展方法判断字符串是否为空或者为null。
在.NET3.5框架下使用下面的方式实现

 /// <summary>
 /// 判断字符串是否为null、空或者空白 /// </summary>
 /// <param name="str">待判断的字符串</param>
 /// <returns></returns>
 public static bool IsNullOrWhiteSpace(this string str) { return string.IsNullOrEmpty(str.Trim()); }

在.NET4.0及以上框架下使用下面的方式实现

/// <summary>
/// 判断字符串是否为null、空或者空白 /// </summary>
/// <param name="str">待判断的字符串</param>
/// <returns></returns>
public static bool IsNullOrWhiteSpace(this string str) { return string.IsNullOrWhiteSpace(str); }

2种框架下实现的逻辑方式不同,为了只编写一套代码(该情况为一个方法),此时就需要使用预处理指令编写条件指令。

在库或应用中,使用预处理器指令编写条件代码,针对每个目标框架进行编译。关于预处理指令请参考《C# 预处理器指令》

使用预处理指令编写条件代码的实现方式如下:

        /// <summary>
        /// 判断字符串是否为null、空或者空白 /// </summary>
        /// <param name="str">待判断的字符串</param>
        /// <returns></returns>
        public static bool IsNullOrWhiteSpace(this string str) { #if NET35
            return string.IsNullOrEmpty(str.Trim()); #else
            return string.IsNullOrWhiteSpace(str); #endif }

上面的实现方式是在一个方法内进行条件区分,下面介绍在同一个类中(方法之外),使用条件区分不同逻辑的实现方式

#if NET35 || NET40 || NET45
        /// <summary>
        /// 对URL字符串进行编码 /// <para>注意:.NET Core 转义后字母为大写</para>
        /// </summary>
        /// <param name="url">有效的url字符串</param>
        /// <param name="encoding">编码,默认为 UTF8</param>
        /// <returns></returns>
        public static string UrlEncode(this string url, Encoding encoding = null) { encoding = encoding ?? Encoding.UTF8; return System.Web.HttpUtility.UrlEncode(url, encoding); } #else
        /// <summary>
        /// 对URL字符串进行编码 /// <para>注意:.NET Core 转义后字母为大写</para>
        /// </summary>
        /// <param name="url">有效的url字符串</param>
        /// <returns></returns>
        public static string UrlEncode(this string url) { return WebUtility.UrlEncode(url);//转义后字母为大写
 } #endif

上面两段代码中的预处理符号 NET35、NET40、NET45 是.NET目标框架中预定义的预处理符号。

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

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

142275 20201010105902969 2041021732 - .NET Standard中配置TargetFrameworks输出多版本类库

除此之外,开发者可以通过配置自定义常量的方式达到与.NET目标框架中预定义的预处理符号相同的功能。

<PropertyGroup Condition=" '$(Configuration)' == 'Release' ">
   <DefineConstants>TRACE;RELEASE</DefineConstants>  <!--统一定义的常量-->
</PropertyGroup>

上述代码片段通过 <DefineConstants> 节点 定义了2个常量(多个常量之间使用分号分隔)TRACE 与 RELEASE。

在编写C#代码时能够自动智能感知到自定义的常量

142275 20201010111828201 1499904311 - .NET Standard中配置TargetFrameworks输出多版本类库

上面是定义的统一的全局变量,也可以在每个条件编译分组中自定义常量

<!--条件编译-->
  <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|net40|AnyCPU'">
    <DocumentationFile>ZCN.NET.BIMFace.SDK.xml</DocumentationFile><!--xml文档,输出类库中方法与参数的注释等信息-->
    <OutputPath>bin\Debug\</OutputPath><!--编译后的文件输出目录-->
    <DefineConstants>NET_FULL</DefineConstants><!--独立定义的常量-->
  </PropertyGroup>
PropertyGroup,是包含一组用户定义的 Property 元素。 MSBuild 项目中使用的每个 Property 元素必须是 PropertyGroup 元素的子元素。其包含如下的子元素

142275 20201010112528158 373162142 - .NET Standard中配置TargetFrameworks输出多版本类库

142275 20201010112826393 1209981507 - .NET Standard中配置TargetFrameworks输出多版本类库

142275 20201010112930645 1109673625 - .NET Standard中配置TargetFrameworks输出多版本类库

 更加完整详细的信息请参考微软官方文档PropertyGroup 元素 (MSBuild)》

六、自动生成内部版本号

七、文件复制

NuGet包相关

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

.NET Standard中配置TargetFrameworks输出多版本类库

.NET Standard中配置TargetFrameworks输出多版本类库插图