首页 技术交流 Jenkins发布WebApi项目时Release构建时如何生成xml文档文件 正文

Jenkins发布WebApi项目时Release构建时如何生成xml文档文件

发布日期:2020年04月20日 13:48        阅读次数:1408

我使用的Webapi用swagger自动生成的api的接口文档,通过读取xml的注释直接显示接口文档的说明等信息,这样很方便,但是在Jenkins发布的时候遇到了一个问题,就是发布的时候不会生成xml文档文件,后来几经辗转,研究发现,Jenkins配置的Command Line Arguments是这样的:

/t:Build  /p:Configuration=Release /xxx

 也就是说Jenkins是利用msbuild构建的release版本,所以我们需要在项目中选中该项目,点击【属性】:


正常情况下,这里是debug模式,我们切换到release模式,同样选择【xml文档文件】


然后提交代码到svn或者Git,在Jenkins里重新构建,然后xml文档文件酒会自动生成了,不用每次都从本地电脑生成一份拷贝到服务器电脑了。    

另外简单说明一下debug和release的区别
1.debug是调试版本,调试版本,包含调试信息,所以容量比Release大很多,并且不进行任何优化(优化会使调试复杂化,因为源代码和生成的指令间关系会更复杂),便于程序员调试。Debug模式下生成两个文件,除了.exe或.dll文件外,还有一个.pdb文件,该文件记录了代码中断点等调试信
2.release是发布版本,不对源代码进行调试,编译时对应用程序的速度进行优化,使得程序在代码大小和运行速度上都是最优的。(调试信息可在单独的PDB文件中生成)。Release模式下生成一个文件.exe或.dll文件


评论:

共 0 页 0 条记录,当前为第 1 页