servicestack - 最新的 ServiceStack Swagger-ui NuGet 包(v 4.0.30)未部署 swagger-ui 资源文件夹

Question

我有一个使用 ServiceStack 和 Swagger-UI 的项目，我已经使用 v4.0.24 安装和设置了它，最近升级到了 v4.0.30。

最新的ServiceStack.Api.Swagger NuGet包:https://www.nuget.org/packages/ServiceStack.Api.Swagger/似乎没有像以前的包那样安装/swagger-ui 资源文件夹。

我在 VS2013 中使用新的干净的 servicestack asp.net 解决方案尝试了这一点。从 nuget 添加了 ServiceStack.Api.Swagger，并在 AppHost.cs 中启用了该插件:

public override void Configure(Container container)
{
    this.AddPlugin(new SwaggerFeature());
}

swagger-ui功能似乎工作正常，但似乎资源(index.html、js、css等)嵌入在dll中，并且需要至少编辑index.html才能配置 Swagger-UI。

我是否遗漏了什么，或者这是最新 NuGet 包中的错误？

我已经编辑了我的 swagger v4.0.24 html、css 和 js，我可以安全地从 ServiceStack Git ( https://github.com/ServiceStack/ServiceStack/tree/master/src/ServiceStack.Api.Swagger ) 中提取这些内容并手动将它们添加/合并到我的解决方案中吗？

Answer 1

最好检查 ServiceStack Release Notes了解每个版本中的更改。

Swagger changes in v4.0.30 的注释:

所有静态资源现已嵌入

All of Swagger's static resources embedded into a single ServiceStack.Api.Swagger.dll, taking advantage of the Virtual File Systems transparent support for Embedded Resources, making it easier to manage and upgrade Swagger as a self-contained unit.

总之，您不再需要 Swagger 的资源，因为它们现在嵌入在 dll 中。

虚拟文件系统

虚拟文件系统上的文档展示了如何 override embedded resources :

覆盖 Swaggers 嵌入式资源

ServiceStack 的 Virtual File System支持多个文件源位置，您可以通过将您自己的自定义文件包含在与现有嵌入文件相同的位置来覆盖 Swagger 的嵌入文件。这样，您只需复制 /swagger-ui 即可将内置的 ServiceStack 嵌入式资源替换为您自己的资源。或/swagger-ui-bootstrap您想要自定义的文件并将它们放置在您的网站目录中的相同路径中，即:

/swagger-ui
  /css
  /images
  /lib
  index.html

/swagger-ui-bootstrap
  index.html
  swagger-like-template.html