升級V1.0 SDK指南 - Alibaba Cloud 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版本號碼}。例如，Elastic Compute Service SDK為com.aliyun:ecs20140526，Virtual Private Cloud SDK為com.aliyun:vpc20160428。

V1.0 SDK的命名方式為aliyun-${語言}-sdk-${產品名}。例如，Elastic Compute Service SDK為com.aliyun:aiyun-java-sdk-ecs，Virtual Private Cloud SDK為com.aliyun:aliyun-java-sdk-vpc。

以Elastic Compute Service為例，添加以下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方可使用。

更多詳情請參考對應語言的開發文檔。