Swagger / Swashbuckle 无法在 Visual Studio 2013 Web API 2 项目上工作

Question

我正在尝试通过 Nuget 包 (Swashbuckle) 安装 Swagger，但我无法让它工作。

这是一个 vanilla VS 2013 Web Api 2 项目。 JS 控制台上有一个错误：Uncaught TypeError: Cannot read 属性 'tags' of null.

在请求 /swagger/ui/lib/underscore-min.map

时收到 404

我发现一个link建议在webconfig中使用vs:EnableBrowserLink禁用BrowserLink，但似乎没有任何效果。

有什么想法吗？

Answer 1

我安装了 Swashbuckle.Core，确保正在创建 XML 输出，并通过一些配置立即运行。

    public static void Register(HttpConfiguration config)
    {
        ...
        config
            .EnableSwagger(c =>
            {
                c.SingleApiVersion("v1", "My API Title");
                c.IncludeXmlComments(GetXmlCommentsFileLocation());
            })
            .EnableSwaggerUi();
        ...
    }

    private static string GetXmlCommentsFileLocation()
    {
        var baseDirectory = AppDomain.CurrentDomain.BaseDirectory + "\bin";
        var commentsFileName = Assembly.GetExecutingAssembly().GetName().Name + ".XML";
        var commentsFileLocation = Path.Combine(baseDirectory, commentsFileName);
        return commentsFileLocation;
    }