View a markdown version of this page

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

Amazon SDK for Java 1.x于2025年12月31日达到支撑终止状态。我们建议您迁移到 Amazon SDK for Java 2.x 以继续获得新功能、可用性改进和安全更新。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

将 SDK 与 Gradle 结合使用

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

注意

在以下示例中，将生成文件1.12.529中的替换为的有效版本 Amazon SDK for Java。在 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 服务的依赖关系。由 Amazon SDK for Java BOM 管理的模块（依赖关系）列在 M aven 中央存储库中。

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

早于 4.6 的 Gradle 版本缺少本机 BOM 支持。要管理项目的 Amazon SDK for Java 依赖关系，请使用 Spring 的 Gradle 依赖关系管理插件导入 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. 在 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 服务的依赖关系。由 Amazon SDK for Java BOM 管理的模块（依赖关系）列在 M aven 中央存储库中。

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