Swagger/Openapi静态文件未出现

Question

我正在尝试使dotnet 6天气API示例产生静态摇晃。json或Swagger.yaml。

我很确定我已经遵循了Microsoft文档的步骤，但是没有生成静态文件，我希望它们会出现在构建中。

Microsoft文档URL：
https://learn.microsoft.com/en-us/aspnet/core/core/tutorials/getting-started-with-with-with-swashbuckle?view=

asspnetcore-6.0＆tabs = visual-studio 我的 program.cs ：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();
builder.Services.AddControllersWithViews();

builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();

    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseAuthorization();

app.MapDefaultControllerRoute();
app.MapRazorPages();

app.Run();

我正在通过Visual Studio 2022以及 dotnet Run 来运行/构建应用程序

Answer 1

如下所示，更改您的 .csproj 文件。并请结果。

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Swashbuckle.AspNetCore" Version="6.3.1" />
    <PackageReference Include="Swashbuckle.AspNetCore.Swagger" Version="6.3.1" />
    <PackageReference Include="Swashbuckle.AspNetCore.SwaggerGen" Version="6.3.1" />
    <PackageReference Include="Swashbuckle.AspNetCore.SwaggerUI" Version="6.3.1" />
  </ItemGroup>
  <Target Name="PostBuild" AfterTargets="PostBuildEvent">
    <Exec Command="dotnet tool restore" />
    <Exec Command="dotnet new tool-manifest --force" />
    <Exec Command="dotnet tool install --local Swashbuckle.AspNetCore.Cli"/>
    <Exec Command="dotnet swagger tofile --output swagger.json $(OutputPath)\$(AssemblyName).dll v1 " />
</Target>
</Project>

Answer 2

对于没有任何控制器或API的ASP.NET Core Web应用程序项目，将不会生成Swagger文档。

因此，它的一点取决于您要实现的目标。

如果您想在没有API的构建时间生成Swagger Document 是您的解决方案。

但是，如果您在运行时正在寻找生成Swagger文档，则必须添加一些控制器或API才能生成，并且您将不需要任何项目设置更改。

因此，在您的示例中，我可以生成Swagger.json。当然，

if (!app.Environment.IsDevelopment())

在App.maprazorpages（）之后，我不得不将摇晃的东西放在此块之外。添加这些行并运行应用程序。

app.MapGet("/hello", () =>
{
    return "Hello World";
});

然后转到您的招摇页面
https：// localhost：7235/swagger/index.html

您可以在Swagger UI中看到您的API。