全部产品
Search
文档中心

阿里云SDK:升级V1.0 SDK指南

更新时间:Aug 01, 2023

本文为您介绍如何对已经集成V1.0 SDK的项目进行升级。

是否必须升级?

如果您曾使用V1.0 SDK集成云产品服务,场景非常简单,且尚未发生任何问题,我们不推荐您立即升级SDK。

如果您正在使用V1.0 SDK,涉及多个产品OpenAPI混编的复杂业务场景,还需要考虑线程安全问题时,我们强烈建议您升级到V2.0 SDK。

如果您目前有个全新的项目,正在做技术选型,我们强烈建议您直接使用V2.0 SDK。

依赖共存

由于V2.0 SDK使用方式无法兼容V1.0 SDK,可以通过使用不同的命名方式来实现二者的共存,以达到迁移的效果。

V2.0 SDK的命名方式为${产品名}${OpenAPI版本号}。例如,云服务器ECS SDK为com.aliyun:ecs20140526,专有网络VPC SDK为com.aliyun:vpc20160428

V1.0 SDK的命名方式为aliyun-${语言}-sdk-${产品名}。例如,云服务器ECS SDK为com.aliyun:aiyun-java-sdk-ecs,专有网络VPC SDK为com.aliyun:aliyun-java-sdk-vpc

以云服务器ECS为例,添加以下Maven依赖信息即可在后续开发中使用V2.0 SDK。

<dependencies>
  <!--  V2.0 SDK  -->
  <dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>ecs20140526</artifactId>
    <version>3.1.12</version>
  </dependency>
  <!--  V1.0 SDK  -->
  <dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.6.3</version>
  </dependency>
  <dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-ecs</artifactId>
    <version>4.24.59</version>
  </dependency>
</dependencies>

升级注意事项

V2.0 SDK支持更多语言,同时新版的SDK对环境、框架也有一定的要求。如:

  • V2.0 Java SDK要求Java版本是8+,而V1.0 Java SDK 要求仅为6+。

  • V2.0 Node.js SDK 只支持TypeScript,这要求您的项目必须支持TypeScript方可使用。

更多详情请参考对应语言的开发文档。