3月7日,微软发布了Visual Studio 2017 RTM,与之一起发布的还有.NET Core Runtime 1.1.0以及.NET Core SDK 1.0.0,尽管这些并不是最新版,但也已经从preview版本升级到了正式版。所以,在安装Visual Studio 2017时如果启用了.NET Core开发的相关功能,那么在安装完成后,你可以在命令行直接执行dotnet.exe,此时你可以看到.NET Core版本是1.1.0,而如果是执行dotnet.exe --version命令,那么你看到的SDK版本将会是1.0.0(并不带preview字样)。

在此介绍如何查看.NET Core SDK版本,主要是源于一件非常有趣的事情,而这件事对于.NET Core项目从老的xproj+project.json迁移到csproj有一定的影响。如果你曾经使用Visual Studio 2015 + .NET Core Tools for Visual Studio + .NET Core SDK开发过项目,并希望在全新的Visual Studio 2017中继续开发的话,了解一下这方面的内容还是很有必要的。

总的来说,迁移一个.NET Core项目,大致有以下几个步骤:

  • 迁移准备

  • 使用Visual Studio 2017对项目进行单项升级

  • 在Jenkins CI服务器上安装最新版的.NET Core SDK

  • 修改Jenkins CI系统编译任务,成功完成编译与发布

下面我就以自己的一个开源项目HAL为例,简单介绍一下各个步骤的做法。

迁移准备

HAL项目本来就是托管在Github上的一个开源项目,为了能够平滑地实现项目迁移,并确保Jenkins CI能够正常工作,在进行项目迁移之前,我首先在Github上新建了一个分支(branch)。Github中创建分支的成本是很低的,在一切调试通过之后,将分支合并(merge)到主分支后,直接删掉就行了。

Github中分支创建完成后,更新本地代码库,完成代码同步。

在Visual Studio 2017中打开并升级.NET Core项目

在我之前有篇简文中介绍过,在安装了Visual Studio 2017 RC之后,如何还能继续在Visual Studio 2015中打开并编译xproj项目,因为当安装完Visual Studio 2017后,dotnet.exe已经升级到1.0.0的版本,此时的dotnet.exe已经是使用MSBuild进行项目编译,它并不认识xproj+project.json这样的项目类型和文档组织结构,因此,在Visual Studio 2015中即使能够打开xproj项目文件,也无法正常编译。当时的解决方案是,在项目的根目录级别创建一个global.json文件,在文件中显式指定.NET Core SDK的版本,使得在项目编译时,强制使用老版本的.NET Core SDK,于是问题也就得到了解决。对于如何修改global.json以指定SDK的版本,这里就不多介绍了,请参考这篇文章。

对于这个问题,我们可以做一个实验,假定你的机器上装有Visual Studio 2015 + .NET Core Tools for Visual Studio 2015 + preview版本的.NET Core SDK,同时装有Visual Studio 2017。那么,当你直接在命令行执行dotnet.exe --version命令,你会看到,.NET Core SDK的版本为1.0.0:

如果你进入到一个在global.json中指定了SDK版本的项目的根目录下,同样执行dotnet.exe --version命令,你会发现,此时的SDK版本却是global.json中指定的版本:

OK,如果你之前有修改global.json文件使得xproj项目能够继续在Visual Studio 2015中打开并编译的话,现在就需要去掉global.json文件中对SDK版本的显式声明,否则,在Visual Studio 2017中进行项目迁移的时候,将无法正常完成。因为此时Visual Studio会使用旧版本的SDK,而这个版本的SDK没有migrate功能。

总的来说,在Visual Studio 2017中迁移xproj还是比较平滑稳定的,一般不会遇到稀奇古怪的问题,只需要确认单向迁移就行了。在迁移完成后,会产生新的解决方案文件(sln)。

在Jenkins服务器上安装新的.NET Core SDK

当Visual Studio 2017成功完成项目迁移之后,就可以把代码提交到Github上的临时分支了,这样就能在Jenkins上进行构建测试。在此之前,需要安装新版本的.NET Core SDK。安装过程很简单,到dotnet官方网站上根据Jenkins master或者slave的操作系统选择相应的.NET Core SDK进行下载安装即可。安装完成后,可以使用dotnet --version命令,确认.NET Core SDK已经正确安装。

修改Jenkins系统编译任务

就HAL项目而言,我首先在Jenkins中克隆了编译任务(build job),然后修改这个编译任务,使得它能从Github中的临时分支获取代码。整个过程也没有出现什么难以解决的问题,原有的dotnet restore/build/pack等命令也能够正常继续使用,不过你会发现,编译过程已经使用Microsoft Build Engine(MSBuild)了。

需要注意的是,原来基于xUnit的dotnet test,有一个-xml的隐藏参数,它能够产生JUnit XML格式的单元测试结果报告,但在.NET Core SDK 1.0下,这个参数就不能用了,有个解决办法是使用-l(--logger)参数,它能够产生MSTest格式的单元测试报告,此时,在Jenkins中安装一个MSTest的插件,就能够继续将测试报告显示在主页上。

最后,在Github中,将临时分支合并到主线分支,并在Jenkins中手动修改主线分支对应的build job,最后把克隆的build job删除即可。不建议继续沿用克隆的build job,那样会造成编译版本的混乱。

原文地址:http://www.cnblogs.com/daxnet/p/6575634.html


.NET社区新闻,深度好文,微信中搜索dotNET跨平台或扫描二维码关注

.NET Core项目从xproj+project.json向csproj迁移简介相关推荐

  1. .NET Core 构建配置文件从 project.json 到 .csproj

    从 .NET Core SDK 1.0 Preview 3 build 004056 开始,.NET Core 弃用 project.json,回归 .csproj,主要原因是为了兼容 MSBuild ...

  2. .NET Core计划弃用project.json

    Microsoft最终宣布project.json实验失败,将转回使用.csproj文件.但是转变不会马上发生,最近发布的.NET Core RC2(又称tooling preview 1)将继续使用 ...

  3. [asp.net core]project.json(1)

    摘要 前面介绍了使用vs2015新建asp.net core web的内容,这篇文章学习下project.json文件的内容. project.json 原文:https://docs.microso ...

  4. .NET Core系列 : 2 、project.json 这葫芦里卖的什么药

    .NET Core系列 : 1..NET Core 环境搭建和命令行CLI入门 介绍了.NET Core环境,本文介绍.NET Core中最重要的一个配置文件project.json的相关内容.我们可 ...

  5. 如果没有Visual Studio 2015,我们如何创建.NET Core项目 ?

    对于.NET开发人员来说,我们已经习惯了VS这个世界上最强大的IDE,所以对他们来说,项目的创建直接利用安装到VS中相应的项目模板即可.当.NET Core跨出了Windows的围栏,正式拥抱其他平台 ...

  6. 微信小程序打开项目提示读取project.config.json文件失败

    前几天一个月薪35k的兄弟,给我推了一个人工智能学习网站,看了一段时间挺有意思的.包括语音识别.机器翻译等从基础到实战都有,很详细,分享给大家.大家及时保存,说不定啥时候就没了. 微信小程序打开项目提 ...

  7. .net core 项目文件结构浅析

    1:launch.json (配置调试用的) 通过vs code创建的项目,都会有这个文件,是启动调试的配置文件: (vscode默认支持nodejs调试) 要调试调试c#代码  需要安装 C# 插件 ...

  8. linux上运行项目,发布项目到 Linux 上运行 Core 项目

    目录索引 简介 ASP.Net Core 给我们带来的最大的亮点就是跨平台,我在我电脑(win7)上用虚拟机建了个 CentOS7 ,来演示下,我们windows上的项目如何发布项目到Linux上运行 ...

  9. Asp.Net Core 项目搭建 基础配置 和MySql 的使用

    一.开发环境准备 1.安装Visual Studio 2015,我这里安装的是专业版. 2.安装.NET Core SDK相关 下载列表:  https://www.microsoft.com/net ...

最新文章

  1. ASP.NET 发邮件方法
  2. 实现DataGridView中同一列不同行控件类型的不同
  3. 如何在Linux使用Eclipse + CDT开发C/C++程序 OS Linux C/C++ gcc
  4. C语言 - sizeof和strlen的区别
  5. InstallShield与Visual Studio
  6. Postman使用小教程--基础入门篇
  7. 在unity用shaderGraph做出类似动物之森的柱面场景,甚至球面场景。
  8. 吴恩达|机器学习作业6.0支持向量机(SVM)
  9. tensorflow学习之常用函数总结:tensorflow.placeholder()函数
  10. 大杂烩 -- Iterator 和 Iterable 区别和联系
  11. 【深度学习系列】PaddlePaddle可视化之VisualDL
  12. network 公网IP与私网IP的区别
  13. Fgui切割图集为散图
  14. 首次!让我们出一个基于延迟的同行 IP 库数据评估来打个样~
  15. HDU 2122 Ice_cream’s world III
  16. 2019最新activiti6.0工作流搭建平台
  17. Vue中minxis的使用
  18. 如何在自己设置家里的路由器DNNS,并实现远程管理路由器。
  19. 如何安装arm交叉工具链及问题解决
  20. 世界的本质是什么---辩证的唯物论

热门文章

  1. 【emWin】例程六:设置颜色
  2. 应用环境下的TIME_WAIT和CLOSE_WAIT
  3. Imageready(IR)动画介绍
  4. 管理Apache服务器访问日志
  5. 3月更新来了!Windows 11正式版22000.556发布
  6. SkyWalking集成与案例
  7. 如何定位Source Generators性能问题
  8. 【分享】154页微软WPF官方手册(含.NETCore和.NET Framwork双版本)
  9. Source Generators(源代码生成器)的调试器支持 | Visual Studio 2019(16.10)新功能试用...
  10. fiddler插件开发