如何使用NSwag.CodeGeneration.CSharp？

Question

我正在尝试从.yaml文件生成.NET Core Web API控制器。

下面是一个运行此命令的示例：

dotnet "/.../dotnet-nswag.dll" openapi2cscontroller /input:https://somewhere.com/swagger.yaml /classname:MyResource /namespace:Com.Example.MyResource /output:Controllers/ResourceController.cs /UseLiquidTemplates:true /AspNetNamespace:"Microsoft.AspNetCore.Mvc" /ControllerBaseClass:"Microsoft.AspNetCore.Mvc.Controller"

此命令与NSwag.CodeGeneration.CSharp有何关系？

这个参数是什么？"/.../dotnet-nswag.dll"是不是来自工具的npm安装？

如何在Visual Studio中的Spec项目构建中生成ApiControllers？

谢谢。

Answer 1

生成器的实际实现位于NSwag.CodeGeneration.CSharp nuget包中。

您可以直接在代码中使用它，以编程方式读取规范并将代码生成为字符串。dotnet-nswag.dll是一个命令行工具，其中的命令可以转换为对此包中生成器的调用。

Answer 2

对于dotnet cli的命令行使用，最简单的选项是执行run命令，将nswag配置文件作为参数传递，其中包含生成源代码所需的设置。

dotnet C:\Users\demo\.nuget\packages\nswag.msbuild\13.4.2\tools\NetCore31\dotnet-nswag.dll run config.nswag
NSwag command line tool for .NET Core NetCore31, toolchain v13.4.2.0 (NJsonSchema v10.1.11.0 (Newtonsoft.Json v12.0.0.0))
Visit http://NSwag.org for more information.
NSwag bin directory: C:\Users\demo\.nuget\packages\nswag.msbuild\13.4.2\tools\NetCore31

Executing file 'config.nswag' with variables ''...
Done.

Duration: 00:00:01.8555952

或者，您可以使用其他命令，如您在维基https://github.com/RicoSuter/NSwag/wiki/CommandLine中详细介绍的命令(openapi2cscontroller