openapi3.0是手动这还是生成的

Posted 2023-05-01

参考技术A 手动。手动编写文档能及时发现文档和项目版本不一致，因此openapi3.0是手动的。OpenAPI 3.0.0 是 OpenAPI 规范的第一个正式版本，因为是由 SmartBear Software 捐赠给 OpenAPI Initiative，并在2015年从 Swagger 规范重命名为 OpenAPI 规范。

重命名 OpenAPI 的参考生成的 swagger.json

【中文标题】重命名 OpenAPI 的参考生成的 swagger.json

【英文标题】：Rename OpenAPI's reference generated swagger.json

【发布时间】：2021-01-07 15:02:58

【问题描述】：

我想知道如何重命名生成的 swagger.json

当我通过“添加新的 OpenAPI 服务引用”选项在 Visual Studio 2019 中向我的项目添加 OpenAPI 服务引用时。

我认为它应该类似于使用“ClassName”完成的操作。

<ItemGroup>
    <OpenApiReference Include="OpenAPIs\swagger.json" CodeGenerator="NSwagCSharp" Namespace="PetStore.Client">
      <SourceUri>https://petstore.swagger.io/v2/swagger.json</SourceUri>
      <ClassName>PetStoreClient</ClassName>
      <OutputPath>PetStoreClient.cs</OutputPath>
      <Options>/GenerateClientInterfaces:true /ClientBaseClass:ClientBase</Options>
    </OpenApiReference>
</ItemGroup>

【参考方案1】：

要更改此设置，只需将<OpenApiReference /> 的Include 参数更改为另一个路径。然后刷新服务引用。

这可能需要手动清理解决方案（出于某种原因，bin 和 obj 中的 OpenApi 相关内容有时不会自行清理）。