.Net Standard扩展支持实例分享
上篇(.Net基础体系和跨框架开发普及)介绍了.Net当前生态下的大概情况,也分享了简单实现的过程,这篇文章就是讲解我的OSS.Common项目扩展.Net Standard 支持的过程,主要集中在:方案的选择,移植检测,移植过程,常见问题的解决思路,以及nuget的打包部署这几个方面。
在开始之前简单介绍下OSS.Common项目的涉及的内容,方便了解后边所遇到的问题。这个类库是相对简单的一个基础类库,提供主要有以下的内容:1. 基础用户系统设备信息实体定义,2. 主流加解密方案实现(md5,aes,sha1,hmacsha1), 3. 常规实体DTO转化,静态扩展方法(时间,字符串等等处理), 4. 基础日志,缓存,异步辅助静态类及默认方案实现(采用了简单Provider模式,使用者可以注册自己的实现方案), 5. 全局结果,分页实体定义。 其主要作用就是完成对常见碎化方法的收集规整,方便在业务逻辑中减少不必要的消耗,了解之后我们进入具体的扩展过程。
一. 方案的选择
这个其实在上篇文章中已经做了介绍,当前.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文件配置:
如有其它疑问,欢迎关注公众号(osscoder):
.Net Standard扩展支持实例分享的更多相关文章
- OSS.Common扩展.Net Standard支持实例分享
上篇(.Net基础体系和跨框架开发普及)介绍了.Net当前生态下的大概情况,也分享了简单实现的过程,这篇文章就是讲解我的OSS.Common项目扩展.Net Standard 支持的过程,主要集中在: ...
- 效率神器 Workflow 实例分享
WorkflowShare Workflow实例分享,Github链接:WorkflowShare logo.jpg 苹果公司收购 Workflow 并将其完全免费,作为一款效率类 APP,Workf ...
- Python模拟登陆淘宝并统计淘宝消费情况的代码实例分享
Python模拟登陆淘宝并统计淘宝消费情况的代码实例分享 支付宝十年账单上的数字有点吓人,但它统计的项目太多,只是想看看到底单纯在淘宝上支出了多少,于是写了段脚本,统计任意时间段淘宝订单的消费情况,看 ...
- Java实现MD5加密及解密的代码实例分享
链接:http://www.jb51.net/article/86027.htm Java实现MD5加密及解密的代码实例分享 作者:厦门大学陈黎栋 字体:[增加 减小] 类型:转载 时间:2016-0 ...
- Android经典项目开发之天气APP实例分享
原文:Android经典项目开发之天气APP实例分享 版权声明:本文为博主原创文章,未经博主允许不得转载. https://blog.csdn.net/mzc186/article/details/5 ...
- YOLO3升级优化版!Poly-YOLO:支持实例分割!
YOLO3升级优化版!Poly-YOLO:支持实例分割! POLY-YOLO: HIGHER SPEED, MORE PRECISE DETECTION AND INSTANCE SEGMENTATI ...
- 免费手机号码归属地API查询接口和PHP使用实例分享
免费手机号码归属地API查询接口和PHP使用实例分享 最近在做全国性的行业分类信息网站,需要用到手机号归属地显示功能,于是就穿梭于各大权威站点之间偷来了API的接口地址. 分享出来,大家可以用到就拿去 ...
- openerp学习笔记 domain 增加扩展支持,例如支持 <field name="domain">[('type','=','get_user_ht_type()')]</field>
示例代码1,ir_action_window.read : # -*- coding: utf-8 -*-from openerp.osv import fields,osv class res_us ...
- php ZIP压缩类实例分享
php ZIP压缩类实例分享 <?php $zipfiles =array("/root/pooy/test1.txt","/root/pooy/test2.txt ...
随机推荐
- u-boot-2016.07 README文档结构
Author:AP0904225版权声明:本文为博主原创文章,转载请标明出处. 阅读u-boot的README文档,可以获取很多有用的信息,例如从哪里可以获得帮助,帮助:u-boot版本命名规则,目录 ...
- 把div 当文字来进行布局控制
两边对齐 text-align: justify; text-justify: distribute-all-lines;/*ie6-8*/ text-align-last: justify;/* i ...
- 10 Python+Selenium键盘事件
[环境信息] python3.6+selenium3.0.2+Firefox50.0+win7 [操作方法] 导入方法:from selenium.webdriver.common.keys impo ...
- Keepalived+Nginx提供前端负载均衡+主从双机热备+自动切换
原文链接:http://unun.in/linux/156.html 方案: 采用两台Nginx服务器作为前端,提供静态web内容,分发web请求,一主一从,Keepalived实现状态监测,保证 N ...
- Unity UGUI —— 无限循环List
还记得大学毕业刚工作的时候是做flash的开发,那时候看到别人写的各种各样的UI组件就非常佩服,后来自己也慢慢尝试着写,发现其实也就那么回事.UI的开发其实技术的成分相对来说不算多,但是一个好的UI是 ...
- C++中lower_bound函数和upper_bound函数
STL中关于二分查找的函数有三个lower_bound .upper_bound .binary_search .这三个函数都运用于有序区间(当然这也是运用二分查找的前提),下面记录一下这两个函数. ...
- jquery.cookie实战用法详细解析
Cookie是由服务器端生成,发送给User-Agent(一般是浏览器),浏览器会将Cookie的key/value保存到某个目录下的文本文件内,下次请求同一网站时就发送该Cookie给服务器(前提是 ...
- RMAN中FILESPERSET设置对备份速度的影响
看到网上部分人说不指定FILESPERSET(默认值=64)则会导致分配的通道只走第一个而导致备份效率低下,今天仔细研究了一下,参照了多个博主文章,得出结论如下: 如果没有指定filesperset, ...
- Java学习之旅基础知识篇:面向对象之封装、继承及多态
Java是一种面向对象设计的高级语言,支持继承.封装和多态三大基本特征,首先我们从面向对象两大概念:类和对象(也称为实例)谈起.来看看最基本的类定义语法: /*命名规则: *类名(首字母大写,多个单词 ...
- 触摸滑动插件 Swiper
Swiper Swiper 是纯javascript打造的滑动特效插件,面向手机.平板电脑等移动终端. Swiper中文网里已有详细的使用介绍,我就不多做介绍了. http://www.swiper ...