将 SDK 与 Gradle 结合使用 - 适用于 Java 的 Amazon SDK 1.x
Gradle 4.6 或更高版本的项目设置用于 4.6 之前的 Gradle 版本的项目设置
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

适用于 Java 的 Amazon SDK 1.x 版本自 2024 年 7 月 31 日起已进入维护模式，并将于 2025 年 12 月 31 日终止支持。我们建议您迁移到 Amazon SDK for Java 2.x 以继续获得新功能、可用性改进和安全更新。

将 SDK 与 Gradle 结合使用

要管理 Gradle 项目的 SDK 依赖项，请将适用于 Java 的 Amazon SDK 的 Maven BOM 导入到应用程序的 build.gradle 文件中。

注意

在以下示例中，将构建文件中的 1.12.529 替换为适用于 Java 的 Amazon SDK 的有效版本。在 Maven Central 存储库中查找最新版本。

Gradle 4.6 或更高版本的项目设置

自 Gradle 4.6 开始，通过声明针对 BOM 的依赖项，便可以使用 Gradle 的经过改进的 POM 支持功能来导入材料清单 (BOM) 文件。

  1. 如果您使用的是 Gradle 5.0 或更高版本，请跳至步骤 2。否则，请在 settings.gradle 文件中启用 IMPROVED_POM_SUPPORT 功能。

    enableFeaturePreview('IMPROVED_POM_SUPPORT')

  2. 将 BOM 添加到应用程序 build.gradle 文件的 dependencies 部分。

    ...
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 的依赖项替换为您将在项目中使用的 Amazon 服务的依赖项。由适用于 Java 的 Amazon SDK BOM 管理的模块（依赖项）列在 Maven Central 存储库中。

用于 4.6 之前的 Gradle 版本的项目设置

早于 4.6 的 Gradle 版本缺少本机 BOM 支持。要管理项目的适用于 Java 的 Amazon SDK依赖项，请使用 Spring 的适用于 Gradle 的依赖项管理插件为开发工具包导入 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. 在 dependencies 部分中指定您将使用的开发工具包模块。例如，以下内容包含 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 的依赖项替换为您将在项目中使用的 Amazon 服务的依赖项。由适用于 Java 的 Amazon SDK BOM 管理的模块（依赖项）列在 Maven Central 存储库中。

有关使用 BOM 指定开发工具包依赖项的更多信息，请参阅将开发工具包与 Apache Maven 一起使用。