Отсутствие XML-комментариев при генерации сваггера с помощью инструмента Swashbuckle CLI - PullRequest
0 голосов
/ 15 января 2019

Я использую Swashbuckle V4.0.0 с Asp.Net Core 2.2. Я использую комментарии XML для документирования моего Swagger. Когда я получаю чванство через конечные точки HTTP, все это прекрасно работает. Когда я запускаю dotnet swagger tofile, я получаю чванство, но без комментариев XML У кого-нибудь еще работали комментарии XML через инструмент CLI?

Я посмотрел код CLI Swashbuckle, и я не уверен, как он вызывает мой код запуска при создании компоновщика. Я включил свой код для того, как я сообщаю Swashbuckle, какие файлы использовать. Этот код находится в Startup.ConfigureServices. У меня есть XML-файлы в моем основном проекте и несколько библиотечных проектов, поэтому я написал функцию, чтобы найти их. Эта функция возвращает допустимые файлы и отлично работает при запросе чванства с http. Я в растерянности из-за того, что я делаю неправильно.

var xmlFiles = GetXmlFiles(apiName);
services.AddSwaggerGen(
    options =>
    {
        // add a custom operation filter which sets default values
        options.OperationFilter<SwaggerDefaultValues>();

        // integrate xml comments
        foreach (string s in xmlFiles)
        {
            options.IncludeXmlComments(s);
        }
    });
...