全部产品
Search
文档中心

Alibaba Cloud SDK:Peningkatan Alibaba Cloud SDK V1.0 ke V2.0

更新时间:Jun 28, 2025

Topik ini menjelaskan cara meningkatkan Alibaba Cloud SDK V1.0 ke V2.0 dalam sebuah proyek.

Apakah Alibaba Cloud SDK V2.0 diperlukan?

Jika Anda menggunakan Alibaba Cloud SDK V1.0 untuk mengintegrasikan layanan cloud dalam skenario sederhana tanpa masalah, kami menyarankan agar Anda tidak segera beralih ke V2.0.

Namun, jika Anda menggunakan Alibaba Cloud SDK V1.0 untuk memanggil API dari beberapa layanan cloud dalam skenario kompleks dan perlu mempertimbangkan masalah keamanan thread, kami sangat menyarankan untuk beralih ke V2.0.

Untuk proyek baru, kami sangat menyarankan langsung menggunakan Alibaba Cloud SDK V2.0.

Kompatibilitas

Alibaba Cloud SDK V2.0 tidak kompatibel dengan V1.0. Untuk meningkatkan ke V2.0, Anda dapat memodifikasi nama SDK saat menambahkan dependensi, sehingga memungkinkan penggunaan V2.0 dalam pengembangan selanjutnya.

Alibaba Cloud SDK V2.0 dinamai dalam format ${Nama Layanan}${Nomor Versi API}. Sebagai contoh, SDK V2.0 dari Elastic Compute Service (ECS) dinamai com.aliyun:ecs20140526, sedangkan SDK V2.0 dari Virtual Private Cloud (VPC) dinamai com.aliyun:vpc20160428.

Alibaba Cloud SDK V1.0 dinamai dalam format aliyun-${Bahasa}-sdk-${Nama Layanan}. Contohnya, SDK V1.0 dari ECS dinamai com.aliyun:aliyun-java-sdk-ecs, dan SDK V1.0 dari VPC dinamai com.aliyun:aliyun-java-sdk-vpc.

Kode sampel berikut menunjukkan cara menambahkan dependensi Maven untuk meningkatkan SDK. Dalam contoh ini, SDK V2.0 dan SDK V1.0 dari ECS digunakan. Setelah menambahkan dependensi, Anda dapat menggunakan SDK V2.0 dalam pengembangan berikutnya.

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

Catatan Penggunaan

Alibaba Cloud SDK V2.0 mendukung lebih banyak bahasa pemrograman dibandingkan V1.0, tetapi memiliki persyaratan lingkungan dan kerangka kerja tertentu. Contohnya:

  • Alibaba Cloud SDK V2.0 untuk Java memerlukan Java 8.0 atau yang lebih baru, sedangkan V1.0 memerlukan Java 6.0 atau yang lebih baru.

  • Alibaba Cloud SDK V2.0 untuk Node.js hanya mendukung TypeScript. Jika ingin menggunakan SDK ini, proyek Anda juga harus mendukung TypeScript.

Untuk informasi lebih lanjut, lihat dokumentasi pengembangan bahasa yang Anda gunakan.