升级版 SDK 与原版 SDK 的区别

更新时间:

本文介绍内容为阿里云 OpenAPI 开发者门户中的升级版 SDK 和原版 SDK 的区别。

对比项

原版 SDK

新版 SDK

生成方案

基于模版生成,各编程语言之间采用不同的模版方案,各个语言之间功能完备程度不一致,使用体验不一。

基于 DSL 语言 Darabonba 方案生成。新方案通过 DSL 语言进行统一的中间表达,并进行了语法校验,使用体验一致。

语言支持

大部分云产品的老版本 SDK 无法支持超过3门以上的主流语言。

支持主流 6 门语言的 SDK 生成。

语言扩展

模板化生成,扩展难度太高,老版本 SDK 很难扩展新语言。

新语言生成器只需接入 DSL 语言的 AST 即可完成扩展,未来还会新增更多的语言。

SDK 示例

各语言间的代码示例不一致,不能保证代码的正确性。

各语言间的代码在逻辑行为上保持一致,通过中间语言来统一生成,具有校验能力,有效保证示例代码的准确性。

SDK 场景化示例

多语言场景化示例编写困难,极少有产品提供,覆盖语言数极少。

通过 DSL 一次编写就能生成多语言的 SDK 场景化示例,可以协助开发者极大的简化 SDK 使用的理解成本。SDK 示例中心