c# - Visual Studio 2013 Web API 2 プロジェクトで Swagger/Swashbuckle が機能しない

Question

Nuget パッケージ (Swashbuckle) を使用して Swagger をインストールしようとしていますが、動作させることができません。

これはバニラ VS 2013 Web Api 2 プロジェクトです。JS コンソールに 1 つのエラーがあります: Uncaught TypeError: Cannot read property 'tags' of null.

/swagger/ui/lib/underscore-min.map のリクエストで 404 が受信される

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;
    }