使用軟體開發套件搭配 Gradle - AWS SDK for Java 1.x
Gradle 4.6 或更高版本的專案設定4.6 之前 Gradle 版本的專案設定

AWS SDK for Java 1.x 已於 2025 年 12 月 31 日end-of-support。我們建議您遷移至 AWS SDK for Java 2.x，以繼續接收新功能、可用性改善和安全性更新。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用軟體開發套件搭配 Gradle

若要管理 Gradle 專案的 SDK 相依性，請將 的 Maven BOM 匯入 AWS SDK for Java 應用程式的 build.gradle 檔案。

注意

在下列範例中，將建置檔案中的 1.12.529 取代為有效的 版本 AWS SDK for Java。在 Maven 中央儲存庫中尋找最新版本。

Gradle 4.6 或更高版本的專案設定

自 Gradle 4.6 起，您可以使用 Gradle 改善的 POM 支援功能，透過宣告對 BOM 的相依性來匯入物料清單 (BOM) 檔案。

  1. 如果您使用 Gradle 5.0 或更新版本，請跳至步驟 2。否則，請在 settings.gradle 檔案中啟用 IMPROVED_POM_SUPPORT 功能。

    enableFeaturePreview('IMPROVED_POM_SUPPORT')

  2. 將 BOM 新增至應用程式build.gradle檔案的相依性區段。

    ...
dependencies {
    implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529')

    // Declare individual SDK dependencies without version
    ...
}

  3. 指定要在 dependencies (相依性) 區段中使用的開發套件模組。例如，以下包含 Amazon Simple Storage Service () 的相依性Amazon S3。

    ...
dependencies {
    implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529')
    implementation 'com.amazonaws:aws-java-sdk-s3'
    ...
}

Gradle 會使用 BOM 的資訊，自動解析您開發套件相依性的正確版本。

以下是包含相依性的完整build.gradle檔案範例 Amazon S3。

group 'aws.test'
version '1.0-SNAPSHOT'

apply plugin: 'java'

sourceCompatibility = 1.8

repositories {
  mavenCentral()
}

dependencies {
  implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529')
  implementation 'com.amazonaws:aws-java-sdk-s3'
}
注意

在上一個範例中，將 的相依性取代 Amazon S3 為您將在專案中使用的 AWS 服務的相依性。由 AWS SDK for Java BOM 管理的模組 （相依性） 會列在 Maven 中央儲存庫上。

4.6 之前 Gradle 版本的專案設定

4.6 之前的 Gradle 版本缺少原生 BOM 支援。若要管理專案的 AWS SDK for Java 相依性，請使用 Gradle 的 Spring 相依性管理外掛程式，為 SDK 匯入 Maven BOM。

  1. 將相依性管理外掛程式新增至應用程式的 build.gradle 檔案。

    buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath "io.spring.gradle:dependency-management-plugin:1.0.9.RELEASE"
    }
}

apply plugin: "io.spring.dependency-management"

  2. 新增 BOM 到檔案的 dependencyManagement 區段。

    dependencyManagement {
    imports {
        mavenBom 'com.amazonaws:aws-java-sdk-bom:1.12.529'
    }
}

  3. 指定您將在相依性區段中使用的 SDK 模組。例如，以下內容包含 Amazon S3的相依性。

    dependencies {
    compile 'com.amazonaws:aws-java-sdk-s3'
}

Gradle 會使用 BOM 的資訊，自動解析您開發套件相依性的正確版本。

以下是包含相依性的完整build.gradle檔案範例 Amazon S3。

group 'aws.test'
version '1.0'

apply plugin: 'java'

sourceCompatibility = 1.8

repositories {
  mavenCentral()
}

buildscript {
  repositories {
    mavenCentral()
  }
  dependencies {
    classpath "io.spring.gradle:dependency-management-plugin:1.0.9.RELEASE"
  }
}

apply plugin: "io.spring.dependency-management"

dependencyManagement {
  imports {
    mavenBom 'com.amazonaws:aws-java-sdk-bom:1.12.529'
  }
}

dependencies {
  compile 'com.amazonaws:aws-java-sdk-s3'
  testCompile group: 'junit', name: 'junit', version: '4.11'
}
注意

在上一個範例中，將 的相依性取代 Amazon S3 為您將在專案中使用的 AWS 服務相依性。由 AWS SDK for Java BOM 管理的模組 （相依性） 會列在 Maven 中央儲存庫上。

如需使用 BOM 指定 SDK 相依性的詳細資訊，請參閱搭配 Apache Maven 使用 SDK。