Swashbuckle.AspNetCore 中文档注释生成问题

    Abp Asp,net 的版本会安装扩展IApplicationService的应用服务接口内容的生成动态WEB接口,但是当前版本的ABP会利用asp.net core 自身机制来生成动态WEB API,这个机制是按照IApplicationService的实现类的public 方法来生成的Dynamic Web API。

    另外,ABP当前的版本的惯用法是应用服务接口以及DTO和实现分离到不同的程序集中 比如 UserAppService 和 IUserAppService 分别再 ZZ.Application 和 ZZ。Application.Shared中,所以需要Swagger要包含两个注释xml文档

options.IncludeXmlComments("ZZ.Application.Shared.xml");

options.IncludeXmlComments("ZZ.Application.xml");
 
在csproj 里加
  <PropertyGroup >
      <GenerateDocumentationFile>true</GenerateDocumentationFile>
  </PropertyGroup>
 
    我还测试了再实现类上加 /// <inheritdoc ceref="IUserAppService"/>,但是没有起到任何作用

posted on 2020-03-08 10:01  一片涂鸦  阅读(491)  评论(0)    收藏  举报

导航