插件概览
一个 Flutter/Dart 包，可从 OpenAPI 规范文件自动生成 REST 客户端和数据类。它通过将 OpenAPI（前身为 Swagger）定义解析为类型安全的 Dart 代码，简化了 API 集成，减少了样板代码并提升了开发速度。适用于使用标准化 API 合同的团队，支持 Android、iOS、macOS、Windows 和 Linux 多个平台。生成的代码确保了 API 文档与客户端实现之间的一致性。
适合场景
- 自动化 API 客户端生成
- 将客户端代码与 OpenAPI 规范同步
- 减少手动 JSON 序列化
- 通过 API 实现快速原型设计
- 在各个平台上保持一致的数据模型
主要特点
- 从 OpenAPI 模式生成数据类
- 创建 REST 客户端接口
- 支持完整的 OpenAPI 规范
- 生成类型安全的 Dart 代码
- 与 CI/CD 流水线集成
适合对象
- 使用 OpenAPI 规范的团队
- 需要自动化API客户端生成的项目
- 寻求减少样板代码的开发者
- 跨平台移动和桌面应用
- 以 API 为先的开发工作流程
使用建议
- 需要有效的 OpenAPI 3.x 规范
- 对于复杂架构，可能需要手动调整
- 生成的代码应进行版本控制
- 不适用于动态或非标准API
- 最好与 API 文档工作流程结合使用