转自:https://www.cnblogs.com/dyxd/p/7080026.html
这里是实现自动化api稳当的生成,在网上看了很多swagger的文档,可能都是在为实现接口时直接使用的swagger,其实步骤差不多,但是更加详细的我还没看到,又或者说,我看着文档来的时候还是出错啦,绕了很大的弯,之前有听过要用这个,但是还是用过。接下来总结下我这次在使用过程中的步骤及一些问题。
在接口已经成型的基础上集成swagger,实现了接口文档的自动化生成,相对于开发来说节约了写文档的大部分时间,无疑是一件莫大的好事情。接下来总结下这个过程:
一、在现有Api的基础上添加Nuget包的引用(这里简述下现有api,不一定是webapi项目,要看接口实现在哪里,可以是类库,也可以是项目webapi等),有2个包,一个是Swagger.Net.UI,一个是Swashbuckle,如下图所示:
(1)、Swagger.Net.UI的添加引用:
(2)、Swashbuckled的添加引用
这里的版本是4.5.2的版本,可能在4.0版本上就不一样啦,这里我没有尝试。。。
二、安装成功后会有新增的文件如下所示: