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、把接口层的生成文件定向到上面的文件夹

打完收工，美滋滋。