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

本文为您介绍如何对已经集成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方可使用。

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