asp.net-web-api - 是否可以在 Asp Web Api 的单独项目中创建 Swagger 文档？

Question

是否可以在单独的项目中为我的 ASP.Net Web API 生成 Swagger 文档？

我在 Swagger 文档所在的位置创建了一个空项目。在 API 项目中引用了 Swagger 项目，但没有起作用。比 API 项目像外部程序集一样加载。可以访问 Controller ，但未生成文档。

然后尝试使用自动生成的 XML 文档，看看它是否会创建任何东西，但没有结果。

在此之后尝试在一个 Swagger 文档中包含多个 API，Multiple API documentation in one Swagger file , 没用。

我也试过这个:

• ApiExplorer for WebAPI controllers in external assembly
• https://github.com/Microsoft/aspnet-api-versioning/issues/271

在 Swagger 官方文档中，我没有找到可以帮助我解决这个问题的东西。我也没有在其他地方找到任何信息(如果可能的话)以及需要如何完成。

我使用 Swashbuckle 5.6.0 和 ASP.Net Web API。

Answer 1

是的，可以在单独的项目中为 Web API 生成 Swagger 文档。

这里有显示我是如何做到的代码:
https://github.com/heldersepu/csharp-proj/tree/master/Swashbuckle.Sample

这是 swagger-ui 的样子: http://swashbucklesample.azurewebsites.net/swagger/ui/index

老实说，这段代码没什么特别的，我第一次尝试就成功了……
但我确实对 Swashbuckle 有一些经验

如果您可以提供一个最小的项目来重现您的问题，我们可以帮助您一起查明问题的根源。