AbpZero的Swagger汉化之旅

做汉化主要是为了出一份前后端都能看得懂的在线文档，废话不多说，我们开始准备，

我们要在启动项目的Startup.cs中重定向一下swagger的读取方式

1、在这个类下面，新增一个方法：

    public  static System.Collections.Generic.List<string> GetXmlCommentPath()
         {
             var baseDirectory = AppDomain.CurrentDomain.BaseDirectory + @"\xmls\";
             if (!Directory.Exists(baseDirectory))
             {
                 Directory.CreateDirectory(baseDirectory);
             }
             var docs = Directory.GetFiles(baseDirectory, "*.xml", SearchOption.TopDirectoryOnly).ToList();
             return docs;
         }

2、Ctrl+F用关键词AddSwaggerGen找到调用swagger的代码，把下面的代码覆盖上去

   var xmls = GetXmlCommentPath();
             services.AddSwaggerGen(options =>
             {
                 options.SwaggerDoc("v1", new Info { Title = "Hitouch API", Version = "v1" });
                 options.DocInclusionPredicate((docName, description) => true);
                 options.OperationFilter<FormFileOperationFilter>();
                 options.AddSecurityDefinition("Bearer", new ApiKeyScheme
                 {
                     Description = "Authorization format : Bearer {token}",
                     Name = "Authorization",
                     In = "header",
                     Type = "apiKey"
                 });
                 options.AddSecurityDefinition("Abp.TenantId", new ApiKeyScheme
                 {
                     Description = "Abp.TenantId: {Int}",
                     Name = "Abp.TenantId",
                     In = "header",
                     Type = "apiKey"
                 });
                 foreach (var xml in xmls)
                 {
                     if (File.Exists(xml))
                     {
                         options.IncludeXmlComments(xml);
                     }
                 }

                 //api界面新增authorize按钮
             });

3、在启动项目的bin\Debug\netcoreapp2.1的文件夹下新建一个名字为xmls的文件夹

4、把接口层的生成文件定向到上面的文件夹

打完收工，美滋滋。