Actualización de Alibaba Cloud SDK V1.0 a V2.0 - Alibaba Cloud SDK

Si ejecuta Alibaba Cloud SDK V1.0, actualice a V2.0 para obtener un modelo de cliente seguro para hilos, compatibilidad con más lenguajes y acceso a las funciones más recientes de la API.

¿Debo actualizar?

Elija según la situación de su proyecto:

Proyecto sencillo sin problemas: mantenga V1.0. No es necesario actualizar si V1.0 cubre sus necesidades.
Proyecto complejo que llama a varios servicios en la nube: actualice a V2.0. Esta versión ofrece un modelo de cliente seguro para hilos que elimina los problemas de concurrencia comunes en las integraciones de V1.0 con varios servicios.
Proyecto nuevo: utilice V2.0 directamente.

Compatibilidad

V2.0 no es compatible con versiones anteriores de V1.0. Ambas versiones usan convenciones de nombres de paquete distintas y pueden coexistir en el mismo proyecto, lo que le permite migrar un servicio a la vez.

Versión	Convención de nombres de paquete	Ejemplo (ECS)	Ejemplo (VPC)
V2.0	`${Service name}${API version number}`	`com.aliyun:ecs20140526`	`com.aliyun:vpc20160428`
V1.0	`aliyun-${Language}-sdk-${Service name}`	`com.aliyun:aliyun-java-sdk-ecs`	`com.aliyun:aliyun-java-sdk-vpc`

A continuación se muestra una configuración de Maven que indica cómo ejecutar V1.0 y V2.0 de forma simultánea. Tanto el SDK de ECS V2.0 como los paquetes core y ECS de V1.0 se declaran como dependencias, por lo que puede migrar un servicio a la vez.

<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>

Requisitos del entorno

V2.0 admite más lenguajes de programación que V1.0, pero exige requisitos de entorno más altos. Compruebe su entorno de ejecución antes de actualizar:

Lenguaje	Requisito de V1.0	Requisito de V2.0
Java	Java 6.0 o posterior	Java 8.0 o posterior
Node.js	JavaScript compatible	Solo TypeScript

Java: V2.0 requiere Java 8.0 o posterior, mientras que V1.0 necesita Java 6.0 o posterior.
Node.js: V2.0 solo es compatible con TypeScript. Asegúrese de que su proyecto admita TypeScript antes de actualizar.

Para consultar la configuración específica de cada lenguaje y las referencias de la API, consulte la documentación de desarrollo correspondiente a su lenguaje.