DEV Community
·
简化Umbraco无头开发：使用Orval自动生成内容交付API模型
💡
原文英文，约1000词，阅读约需4分钟。
📝
内容提要
我正在为Umbraco创建Next.js版本的Clean Starter Kit，面临内容模型和API客户端管理的挑战。使用Orval工具简化了从Umbraco内容交付API生成模型的过程，配置简单，支持多种输出模式，解决了与Next.js的集成问题，推荐用于生成TypeScript客户端和模型。
🎯
关键要点
- 正在为Umbraco创建Next.js版本的Clean Starter Kit，面临内容模型和API客户端管理的挑战。
- 使用Umbraco.Community.DeliveryApiExtensions包来生成强类型模型。
- 选择Hey API作为模型生成的初始解决方案，但其快速变化带来了挑战。
- Hey API的实现需要单独的客户端包，导致编译错误。
- Orval工具被发现并用于简化模型生成，配置简单且支持多种输出模式。
- Orval解决了与Next.js的集成问题，允许自定义实现以支持Next.js特定参数。
- Orval支持多个API客户端生成，适用于多个API的Umbraco站点。
- 推荐Orval作为生成TypeScript客户端和模型的最佳选择，因其简单性、稳定性和灵活性。
- 使用Umbraco的内容交付API和Orval工具，构建Next.js前端变得更加可管理。
❓
延伸问答
如何使用Orval工具简化Umbraco的内容模型生成？
Orval工具通过简单的配置和多种输出模式，快速生成可用的模型，解决了与Next.js的集成问题。
Hey API在Umbraco项目中遇到了哪些挑战？
Hey API的快速变化导致了实现上的挑战，包括需要单独的客户端包和编译错误。
Orval与Hey API相比有哪些优势？
Orval更简单、稳定且灵活，提供清晰的文档和更好的集成支持，适合生成TypeScript客户端和模型。
如何在Umbraco中生成强类型模型？
可以使用Umbraco.Community.DeliveryApiExtensions包来生成强类型模型，结合Orval工具可进一步简化流程。
Orval支持哪些输出模式？
Orval支持多种输出模式，包括单文件、标签分割等，适用于不同的开发需求。
使用Orval工具构建Next.js前端的优势是什么？
使用Orval工具可以更好地管理Next.js特定参数，优化缓存和重新验证，提升开发效率。
➡️
