在.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 类库。

2、填写项目名称

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

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

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

也可以修改为其他版本

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

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

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

可以看到当前类库默认为 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 会弹出黄色背景的提示信息。

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

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

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

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

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

1、条件编译

2、引用本地程序集

3、NuGet方式引用程序集

4、XML文档输出

5、编码与DEBUG 调试

6、自动生成内部版本号

7、文件复制

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

一、条件编译
在下图中可以看出,编译成功后,在项目的默认位置 bin\Debug 下生成了3个不同目录,分别对应3个目标版本。

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

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

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

填写后,保存项目。项目右键,【编辑项目文件】,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。

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

$(Platform) 的条件值有:

二、引用本地程序集

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

.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>

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

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

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

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

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

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

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

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

添加后,如下图所示

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

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

查看.csproj文件

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

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

三、NuGet 方式引用程序集

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

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

点击【安装】

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

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

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

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

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

点击【安装】

点击【确定】

点击【我接受】。

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

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

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

四、XML文档输出

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

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

这表示 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>

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

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

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

五、编码与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 目标框架的预处理器符号的完整列表如下:

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

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

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

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

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

<!--条件编译-->
<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 元素的子元素。其包含如下的子元素

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

六、自动生成内部版本号
七、文件复制

NuGet包相关

NET Standard中配置TargetFrameworks输出多版本类库的更多相关文章

  1. 配置使用TargetFrameworks输出多版本类库

    1.类库右键 2.修改配置 修改前: <Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <Targe ...

  2. php中Standard中配置选项,在TargetFrameworks环境下如何输出库存

    在.NET Standard/.NET Core技术出现之前,编写一个类库项目(暂且称为基础通用类库PA)且需要支持不同 .NET Framework 版本,那么可行的办法就是创建多个不同版本的项目( ...

  3. 在tomcat中配置jdk的不同版本

    在tomcat中配置jdk的不同版本---------------------------------------------------------------------------------- ...

  4. VS_QT中配置qDebug输出

    在使用qt_create时可以使用qDebug进行调试输出.在VS中也可以使用.但需要配置.配置过程如下图所示: 一.首先右击工程名,选择最后一个选项“Properties” 二.然后选择Linker ...

  5. Visual Studio中配置Beyond Compare为版本比较工具

    VS自带的合并工具并不理想,个人比较习惯Beyond Compare,这里替换成Beyond Compare,因为并不想改变所有的VS项目设置,这里以单个仓库项目为例,源代码管理器使用GIT 找到.g ...

  6. 在 Android studio 中 配置Gradle 做到 “根据命令行提示符生成指定versionCode, versionName,指定apk的打包输出路径”

    需求: 1. 使用 Android studio ,使用 gradle 进行构建 2. 在实际开发中,我们需要使用jenkins进行打包.就需要配置我们的 gradle 脚本以支持参数化的方式. 3. ...

  7. mybatis的mapper代理,SqlMapConfig.xml中配置,输入和输出映射使用案例

    public class User { private int id; private String username;// 用户姓名 private String sex;// 性别 private ...

  8. VS Code中配置python版本以及Python多版本

    VS Code中配置python版本VS Code十分方便配置python的版本:可以选在在本地setting.json或者全局setting.json文件中配置:python.pythonPath在 ...

  9. Windows Server2008 下用于.NET Framework3.0版本的问题无法在IIS7中配置.NET Framework4.0节点的问题

    Windows Server 2008中,功能列表安装的为.NET Framework3.0. 试了N种方法未升级为.NET Framework4.0(哪位如果可以直接升级为4.0或3.5希望能够分享 ...

随机推荐

  1. 地图_SDK

    不仅仅是Google,您必须知道的全球十大地图API https://blog.csdn.net/u013068887/article/details/79322096

  2. 关于js重名方法的先后调用问题

    当js中方法重名时,最后引入的js会覆盖前面的引入的js(就是说会调用最后引入的js中的方法)详情参照(main.js与white.js 的a())但是,当最后一个js中存在语法上的错误时(也可以是本 ...

  3. Google Code Jam 2020 Round1B Expogo

    题意 你初始位于\((0,0)\),然后你想要到\((x,y)\)去,第\(i\)步的步长是\(2^{i-1}\),要求用最少的步数走到\((x,y)\). 解题思路 首先可以推出,走\(i\)步可以 ...

  4. 编写第一个 .NET 微服务

    介绍 本文的目的是:通过创建一个返回列表的简单服务,并在 Docker 容器中运行该服务,让您熟悉使用 .NET 创建微服务的构建过程. 安装 .NET SDK 要开始构建 .NET 应用程序,首先下 ...

  5. vue引入 lodash

    vue main.js引入 // main.js 全局引入lodash import _ from 'lodash' Vue.prototype._ = _ // 使用 this._.debounce ...

  6. webstorm编写vue、react 将大驼峰组件命名转换成短横杠命名

    大家好!我是木瓜太香,精通 webstorm 与常见前端技术的工程师,偶尔也在b站搞一些 webstorm 技巧教学,今天给大家带来的是大驼峰小驼峰快速转换短横杠命名或者下划线命名的方式. 开发中我们 ...

  7. Redis Linux 安装部署

    Redis部署文档   Redis部署文档 准备软件: 开始部署: 解压tar包[root@localhost redis]# tar -zxvf redis-3.2.8.tar.gz 进入Redis ...

  8. Java中nextInt和nextLine同时使用出现的问题

    代码: package com.ins1; import java.util.*; public class test { public static void main(String[] args) ...

  9. Face The Right Way(POJ 3276)

    原题如下: Face The Right Way Time Limit: 2000MS   Memory Limit: 65536K Total Submissions: 6708   Accepte ...

  10. oracle之二实例与数据库

    实例与数据库 1.Oracle 网络架构及应用环境 看PPT,Oracle结构的基本单元.术语 2.Oracle 体系结构    1)oracle server :database + instanc ...