Ubuntu Swagger如何进行版本控制

在Ubuntu上使用Swagger进行版本控制，可以参考以下步骤：

1. 建立API版本管理： 在代码中建立一个ApiVersions.cs文件，用来设置版本。例如：

   public enum ApiVersions
   {
       V1,
       V2,
       V3
   }
   

2. 配置SwaggerGen： 在Program.cs文件中修改相应的内容，添加版本控制。例如：

   builder.Services.AddSwaggerGen(options =>
   {
       options.SwaggerDoc("v1", new OpenApiInfo { Version = "v1", Title = "API标题", Description = "API描述" });
       options.SwaggerDoc("v2", new OpenApiInfo { Version = "v2", Title = "API标题", Description = "API描述" });
       options.SwaggerDoc("v3", new OpenApiInfo { Version = "v3", Title = "API标题", Description = "API描述" });
   
       foreach (string version in typeof(ApiVersions).GetEnumNames())
       {
           options.DocInclusion(version, true);
       }
   });
   

3. 配置SwaggerUI： 在Startup.cs中对UseSwaggerUI进行相应修改：

   if (app.Environment.IsDevelopment())
   {
       app.UseSwagger();
       app.UseSwaggerUI(c =>
       {
           c.SwaggerEndpoint("/swagger/v1/swagger.json", "API版本:v1");
           c.SwaggerEndpoint("/swagger/v2/swagger.json", "API版本:v2");
           c.SwaggerEndpoint("/swagger/v3/swagger.json", "API版本:v3");
       });
   }
   

4. 控制器版本控制： 在控制器文件里面添加版本控制特性：

   [ApiExplorerSettings(IgnoreApi = false, GroupName = nameof(ApiVersions.V1))]
   public class CompanyController : ControllerBase
   {
       // V1版本的控制器代码
   }
   

通过这些步骤，可以在Ubuntu上实现Swagger的版本控制。