首页
/ Fern API框架0.63.30版本发布:多语言SDK优化与OpenRPC增强

Fern API框架0.63.30版本发布:多语言SDK优化与OpenRPC增强

2025-06-16 07:38:10作者:宣海椒Queenly

项目概述

Fern是一个现代化的API开发框架,它通过定义良好的接口规范,可以自动生成多种编程语言的客户端SDK和服务端代码。该项目采用工程化的方式管理API生命周期,支持TypeScript、Python、Java、PHP等多种语言,并提供完善的文档生成能力。

版本核心更新

1. TypeScript SDK测试架构重构

本次版本对TypeScript SDK的测试体系进行了重要重构。原先的测试实现依赖于外部mock服务器,现在改为完全自包含的测试方案。这种改进带来了几个显著优势:

  • 测试运行不再依赖网络连接,提高了测试稳定性和速度
  • 更精确地控制测试环境和模拟响应
  • 便于在CI/CD流水线中执行测试
  • 降低了测试环境的复杂度

2. OpenRPC端点级服务器支持

对于使用OpenRPC规范的API,新版本增加了端点级别(Endpoint-level)的服务器配置支持。这意味着:

  • 同一个API的不同端点可以指向不同的服务器地址
  • 支持更灵活的部署架构,如灰度发布场景
  • 符合现代微服务架构的最佳实践
  • 通过CLI工具即可完成配置

3. 多语言SDK种子更新

框架维护了各语言SDK的"种子"项目(seed),作为生成客户端代码的基础模板。本次更新同步了多个语言的种子项目:

  • Python FastAPI种子更新,优化了异步处理性能
  • PHP SDK种子改进,增强了类型安全性
  • TypeScript SDK种子升级,完善了错误处理机制
  • Java SDK种子更新,改进了泛型支持

4. 文档系统增强

本地开发文档体验得到提升:

  • 代码块展示更加清晰规范
  • 功能说明更加详细准确
  • 优化了文档首页布局
  • 增强了本地预览功能

技术细节解析

Python测试代码片段格式化修复

针对Python SDK生成测试代码中的片段格式化问题进行了修复。现在生成的测试代码会保持更好的可读性,包括:

  • 正确的缩进处理
  • 适当的空行分隔
  • 符合PEP8规范的代码风格
  • 清晰的断言表达式

版本管理改进

通过优化versions.yml配置文件的管理:

  • 确保各语言SDK版本同步更新
  • 更精确地控制依赖版本
  • 简化发布流程
  • 避免版本冲突

开发者建议

对于使用Fern框架的开发者,建议关注以下实践:

  1. 测试策略:TypeScript项目可以迁移到新的测试架构,享受更稳定的测试体验

  2. 多服务器配置:对于复杂部署场景,可以充分利用新的端点级服务器配置能力

  3. 种子项目:定期同步最新种子项目,获取框架提供的最新优化

  4. 文档本地预览:利用增强的文档功能,在开发过程中获得更好的文档反馈

这个版本的发布体现了Fern框架对开发者体验的持续关注,特别是在测试可靠性和配置灵活性方面的改进,将显著提升API开发效率和质量。

登录后查看全文
热门项目推荐