“.net Core 托管”Blazor WASM 解决方案 Web API 项目上的 Swagger UI

Question

我在 Blazor WebAssembly 解决方案上使用“.net Core 托管”选项。

这会为您创建一个 .net Core Web API 项目作为解决方案的一部分。

如果我自己创建它并启动项目，它将启动一个 Swagger UI 界面到 API。如果我在“.net Core 托管”的 Blazor 应用程序中启动服务器项目，它会启动客户端应用程序（如预期的那样）。

如何获取 Web API 服务器应用程序的 Swagger UI？ （用于测试 API）。

我在 Google 上找不到任何相关信息 - 此链接没有帮助： Can I use Swashbuckle to generate Swagger UI from Blazor project c#

谢谢。

Answer 1

当您启动 Blazor 应用时，手动转到 /swagger/index.html，您将看到标准的 Swagger UI。

如果您希望在运行应用时显示 SwaggerUI 而不是 Blazor 客户端，请编辑您的 launchSettings.json 并将启动配置文件的“launchUrl”值设置为 /swagger/index.html

如果您想在 MainLayout.razor 中添加指向它的链接，并确保该链接仅显示在开发环境中。

编辑：您需要确保在您的 program.cs 文件中的服务器上设置了 Swagger。 （假设Asp.NET Core 6，如果使用5，你的Startup.cs文件中应该有类似的初始化代码）

var builder = WebApplication.CreateBuilder(args);
...
builder.Services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new OpenApiInfo { Title = "MyBlazor", Version = "v1" });
});
...
var app = builder.Build();
if (app.Environment.IsDevelopment())
{
    app.UseWebAssemblyDebugging();
    app.UseSwagger();
    app.UseSwaggerUI(c => 
         c.SwaggerEndpoint("/swagger/v1/swagger.json", "MyBlazor v1"));
}