Hey devs, como todos sabemos, Microsoft decidió dejar fuera el soporte integrado de Swagger (más específicamente, el paquete Swashbuckle) en .NET 9. Ahora incluye soporte nativo para generar documentación OpenAPI usando el paquete Microsoft.AspNetCore.OpenApi, lo que permite crear documentación de APIs sin depender de herramientas externas. A pesar de esto, si prefieres seguir usando Swagger, todavía puedes integrarlo manualmente en tus proyectos ya que es totalmente funcional.
Para mí, Swagger me parece una herramienta muy valiosa y versátil, es por ello que en este artículo te enseñaré a cómo instalarlo en un proyecto API REST manualmente de forma que puedas disfrutar de esta herramienta como si nada hubiese pasado.
Por supuesto, hay otras herramientas alternativas como Scalar. Swagger es solamente una de ellas, te animo a que aprendas más de una para que te quedes con la que mejor te funcione.
La instalación de Swagger lo haremos en 3 simples pasos:
1. Instalar la herramienta
Debes instalar Swashbuckle.AspNetCore en tu proyecto de tipo ASP.NET Core Web API
Hazlo mediante Nuget o mejor aún, desde la consola con el comando:
dotnet add ./tu-proyecto/ package swashbuckle.aspnetcore
2. Actualizar Program.cs
Debes quitar o comentar una líneas y añadir otras en el middleware de tu aplicación:
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
//builder.Services.AddOpenApi();
// Add Swagger/OpenAPI services
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
var app = builder.Build();
if (app.Environment.IsDevelopment())
{
//app.MapOpenApi();
app.UseSwagger();
app.UseSwaggerUI();
}
app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();
app.Run();
3. Actualizar launchsettings.json
Quédate con un perfil con esta apariencia en tu archivo launchsettings.json:
{
"profiles": {
"https": {
"commandName": "Project",
"launchBrowser": true,
"launchUrl": "https://localhost:7219/swagger",
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development"
},
"dotnetRunMessages": true,
"applicationUrl": "https://localhost:7219/"
}
},
"$schema": "https://json.schemastore.org/launchsettings.json"
}
Y eso es todo estimado dev! Ahora corre tu proyecto y deberías tener el viejo y confiable Swagger aunque estés usando la última versión de .NET: la versión 9 en adelante.
Si quieres saber un poco más de Swagger, en este artículo te lo cuento.
Si esta entrada te ha gustado, compártela crack! 🥳🚀