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"/>,但是没有起到任何作用
浙公网安备 33010602011771号