Net Standard扩展支持实例分享

本文涉及的产品
对象存储 OSS,20GB 3个月
对象存储 OSS,内容安全 1000次 1年
对象存储 OSS,恶意文件检测 1000次 1年
简介:

一. 方案的选择

  这个其实在上篇文章中已经做了介绍,当前.net core ,.net Framework,mono for Xarmain等都有自己的运行时,虽然使用的都是C#语法,但是类库在不使用可移植或者标准库的前提下不能直接互相调用。随着.net standard 2.0的即将推出,.net core(asp.net core) 的应用场景会越来越普遍,对旧有项目的兼容需求会越来越强烈,oss.common也是遇到这个问题,所以我将对它进行.net standard支持的扩展。

  由于当前项目现在在好几个.net framework的项目中还在使用,为了旧项目中对net45的版本的支持不能丢失,所以我会保留两套解决方案,一个为.net Standard 提供支持,一个为.net framework使用,两个类库项目,共享同一套代码文件,针对Framework特有功能通过条件编译来控制。github上目录结构已更新,欢迎查看。

  二. 移植检测

  在移植之前我们需要对移植有个大概评估,了解需要代码改动的覆盖面积,确定代码的可移植性,这里推荐使用微软官方提供的移植检测工具(ApiPort),或者使用它的VS扩展。这里我使用的是vs插件,安装完插件之后,打开解决方案,查看右键菜单会有如下两个选项:

  首先,点击第二个选项,配置要检测的移植对比版本,如下图:

  完成对应的检测版本之后点击确定,点击第一个选项,执行分析过程,会生成html和xsl两种报表,html报表界面如下所示:

 报表中会给出对应版本的接口覆盖情况,以及相关的建议,可以说是比较详细了。

  三.移植过程

  经过上边的检测,可以看出oss.common项目 在.net standard1.4下,大概超过20%的代码不能直接提供支持,我看了一下,主要集中在涉及配置,缓存,反射等特有属性相关代码中,这个还算在预期之中,不过看到一堆的红叉叉还是一阵头疼,没办法,自己的类库,哭着也要码完,下边介绍下移植的步骤。

  1. 添加项目文件

  为了项目直观和方便管理,我将原来的OSS.Common类库修改名称为OSS.Common.NET45,新建一个OSS.Common的标准库项目,两个项目文件放在同一目录下,说明一下,vs2015如果要建标准库项目需要先建可移植类库,在类库属性页修改,如果不清楚请看上一篇文章介绍。

  这个时候如果你直接生成OSS.Common.NET45的项目,是会出现报错的,哪怕你没有做任何实际的代码的操作,主要是因为添加可移植类库需要project.json的文件进行依赖管理,当他们在同一目录下时,nuget会把project.json中的依赖默认执行还原操作,虽然你当前是在生成OSS.Common.NET45项目,没办法,就是这么傻,如果你遇到了这个错误,在当前目录中再建一个对应当前项目文件的project.json文件就好了,这里我添加了OSS.Common.Net45.project.json文件,文件中添加如下代码:

{
"frameworks": {
"net45": {}
},
"runtimes": {
"win": {}
}
}

 

  2. 代码集成

  新建好对应的解决方案之后,把代码文件附件到新建的标准库下,这个时候直接生成会有很多错误,这个时候我们就需要祭出条件编译这个大招了,因为以后主要是维护标准库,所以我在旧NET45的旧项目上新建了NETFW的条件编译符号 ,剩下的就是一个个错误完善了。

  在处理兼容的过程中,主要会面临这几个问题,1. 标准库完全不支持   2.  标准库和Framework的调用方法不一样, 3. 可以间接完成标准库的实现

  这里我把我遇到的情况各举一个例子供大家参考:

  1.  标准库完全不支持,这个最典型的就是缓存模块,在.net standard下,System.Runtime.Caching类库完全被移除了,没办法,只能使用#if NETFW 完全把Module模块下的默认Cache实现给屏蔽了,只能在Framework下才能使用默认实现(本来打算自己实现一个缓存类的,不过发现可能会带来不可预知bug,作废)。

  2. 标准库和Framework的调用方法不一样,举个例子就是Type类型下的IsEnum属性,在net standard下需要.gettypeinfo().IsEnum才可以,举例代码:

#if NETFW
if (!enType.IsEnum)
#else
if (!enType.GetTypeInfo().IsEnum)
#endif

  3. 可以间接完成标准库的实现,这常见的如 list的ConvertAll方法,在Framework下有默认实现的,标准库下是没有的,这里我在ConvertExtention类自己定义了个一个:

#if !NET40
public static List<TResult> ConvertAll<TPara, TResult>(this List<TPara> list, Func<TPara, TResult> func)
{
if (list == null)
return null;
var resultList = new List<TResult>(list.Count);
list.ForEach(e => resultList.Add(func(e)));
return resultList;
}
#endif

 当然还会有其他的一些问题,不过还好,基本都已经解决,如果有不清楚的可以去下载oss.common代码自行查看

 

  四. nuget打包部署

  这个相对简单,在两个解决方案中分别生成对应的dll,在lib文件夹中分别添加net45 和 netstandard1.4 文件夹添加对应的dll就行。

需要注意的一点就是,最好添加个各自的依赖,举个例子,标准库的Hmacsha1加密算法在“System.Security.Cryptography.Algorithms” dll程序集下,如果在调用项目中没有引用这个dll,生成是不会报错的,但是当代码执行调用的时候就会弹出程序集未找到的错误,当然如果发现这个问题也可以通过nuget线上安装命令(install-package)安装。

  给大家看下我的nuget文件配置:

 














本文转自xsster51CTO博客,原文链接:http://blog.51cto.com/12945177/1929795  ,如需转载请自行联系原作者


相关实践学习
借助OSS搭建在线教育视频课程分享网站
本教程介绍如何基于云服务器ECS和对象存储OSS,搭建一个在线教育视频课程分享网站。
相关文章
|
开发框架 .NET 数据库
.NETCore 获取数据库上下文[实例的方法和配置连接字符串
.NETCore 获取数据库上下文[实例的方法和配置连接字符串
786 1
|
2月前
|
监控 安全 API
Docker + .NET API:简化部署和扩展
Docker + .NET API:简化部署和扩展
44 0
|
2月前
|
监控 安全 API
最完美的扩展Docker + .NET API:简化部署和扩展
最完美的扩展Docker + .NET API:简化部署和扩展
93 0
|
4月前
|
数据库
分享一个 .NET EF 6 扩展 Where 的方法
分享一个 .NET EF 6 扩展 Where 的方法
|
4月前
|
API Windows
闲聊 .NET Standard
闲聊 .NET Standard
|
7月前
|
PHP Windows
php扩展com_dndnet(PHP与.NET框架进行交互)
php扩展com_dndnet(PHP与.NET框架进行交互)
php扩展com_dndnet(PHP与.NET框架进行交互)
|
开发框架 .NET API
Hangfire .NET任务调度框架实例
# 1、介绍 Hangfire是一个开源的.NET任务调度框架,提供了内置集成化的控制台(后台任务调度面板),可以直观明了的查看作业调度情况。 # 2、Nuget安装 ![请在此添加图片描述](https://developer-private-1258344699.cos.ap-guangzhou.myqcloud.com/column/article/5877188/20231031-119e3068.png?x-cos-security-token=baeOYKJ0BOuKXaDG6L8qKX7pdH823CLaaefd8181d9b33eccf4b2a2f35cd15dd7jLbyf
100 0
Hangfire .NET任务调度框架实例
|
调度
Quartz.NET 任务调度框架的demo实例
​ # 1、新建项目 简单实例,新建一个控制台程序 # 2、Nuget安装Quartz ![请在此添加图片描述](https://developer-private-1258344699.cos.ap-guangzhou.myqcloud.com/column/article/5877188/20231031-52d48c93.png?x-cos-security-token=baeOYKJ0BOuKXaDG6L8qKX7pdH823CLa740df95695ddd90763a204f7cd7172afjLbyfjQS2rqYm0waz5Rlsx3p2jhWg-yj9JZ3WKDq32bpX
68 0
|
开发框架 程序员 API
【C#】.net core2.1,通过扩展状态代码页方法对404页面进行全局捕抓并响应信息
在开发一个网站项目时,除了异常过滤功能模块,还需要有针对404不存在的api接口和页面处理功能 本篇文章就来讲讲,如何自定义全局请求状态类来统一处理
230 0