本文为您介绍了SDK不同版本之间的区别,帮助您快速找到需要的SDK版本。

版本关系

说明 推荐用户使用V2版本SDK。
  • 升级版SDK:V3版本。
  • 原版SDK:
    • CommonRequest版本:V2版本。
    • BusinessRequest版本:V1版本。

升级版SDK和原版SDK区别

对比项 升级版SDK 原版SDK
生成方案 基于DSL语言 Darabonba 基于模版生成,各编程语言之间采用不同的模版方案,各个语言之间功能完备程度不一致,使用体验不一。
语言支持 支持主流6门语言的SDK生成。 大部分云产品的老版本SDK无法支持超过3门以上的主流语言。
SDK示例 各语言间的代码在逻辑行为上保持一致,通过中间语言来统一生成,具有校验能力,有效保证示例代码的准确性。 各语言间的代码示例不一致,不能保证代码的正确性。
SDK场景化示例 通过DSL一次编写就能生成多语言的SDK场景化示例,可以协助开发者极大的简化SDK使用的理解成本,SDK 示例中心 多语言场景化示例编写难度大,覆盖语言数较少。

CommonRequest版本(V2版本)和BusinessRequest版本(V1版本)的区别

对比项 CommonRequest版本(V2版本) BusinessRequest版本(V1版本)
定义 为开发者封装了签名逻辑,但是所有API调用都需要用户自己填写参数,请求方法,请求头等全量信息。 为开发者封装了包括签名逻辑,公有参数,公有请求头等所有通用逻辑,用户不用关注 API 的请求逻辑,只需要关注自身业务参数即可。
签名逻辑 包含,开发者无需关注。 包含,开发者无需关注。
请求方法 需要用户通过文档查询,API是通过 POST、GET或其他方法请求后,赋值给request对象的对应属性。 开发者无需关注,SDK中已经生成了相关方法。
公有参数 需要开发者查看文档获取请求API对应的产品参数,版本参数,返回体对应格式以及请求的 Action参数或API对应的URI参数。 开发者无需关注,SDK中已经生成了全量公有参数。
业务参数 需要开发者查看文档来查看API需要哪些参数,并且需要按照文档指示的格式来序列化参数,序列化开发和调试成本较高。 SDK中为用户提供了业务参数的结构化 Request对象,按Ide提示即可完成编写,序列化过程由SDK完成,保障正确性。
返回结果 直接返回未经处理的字符串,开发者可通过API文档查看如何解析结果,并通过文档序列化处理后的返回值组成结构化的对象来使用。 SDK中为用户做了返回结果的解析,并返回跟文档一致的结构化Response对象,按Ide提示即可找到自己需要的参数来使用。
产品支持能力 支持所有产品。 部分云产品不提供原版SDK,所有云产品提供新版SDK。
SDK示例 OpenAPI 开发者门户提供没有原版SDK 产品的示例。 OpenAPI 开发者门户不仅提供所有新版 SDK和原版SDK示例,还为超过50款产品提供了SDK 场景化示例