适用于 Java 的 AWS SDK 1.x于2025年 end-of-support 12月31日达到。我们建议您迁移到 [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html) 以继续获得新功能、可用性改进和安全更新。

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

# 将 SDK 与 Gradle 结合使用
<a name="setup-project-gradle"></a>

要管理 [Gradle](https://gradle.com/) 项目的 SDK 依赖关系，请将的 Maven BOM 导 适用于 Java 的 AWS SDK 入到应用程序的文件中。`build.gradle`

**注意**  
在以下示例中，将生成文件*1.12.529*中的替换为的有效版本 适用于 Java 的 AWS SDK。在 [Maven Central 存储库](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest)中查找最新版本。

## Gradle 4.6 或更高版本的项目设置
<a name="project-setup-for-gradle-4-6-or-higher"></a>

 [自 Gradle 4.6 开始](https://docs.gradle.org/4.6/release-notes.html#bom-import)，通过声明针对 BOM 的依赖项，便可以使用 Gradle 的经过改进的 POM 支持功能来导入材料清单 (BOM) 文件。

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

   ```
   enableFeaturePreview('IMPROVED_POM_SUPPORT')
   ```

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

   ```
   ...
   dependencies {
       implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529')
   
       // Declare individual SDK dependencies without version
       ...
   }
   ```

1. 在 *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 服务的依赖关系。由 适用于 Java 的 AWS SDK BOM 管理的模块（依赖关系）列在 M [aven 中央存储库中](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest)。

## 用于 4.6 之前的 Gradle 版本的项目设置
<a name="project-setup-for-gradle-versions-earlier-than-4-6"></a>

早于 4.6 的 Gradle 版本缺少本机 BOM 支持。要管理项目的 适用于 Java 的 AWS SDK 依赖关系，请使用 Spring 的 Gradle [依赖关系管理插件](https://github.com/spring-gradle-plugins/dependency-management-plugin)导入 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"
   ```

1. 将 BOM 添加到该文件的 *dependencyManagement* 部分。

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

1. 在 *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 依赖关系替换为您将在项目中使用的 AWS 服务的依赖关系。由 适用于 Java 的 AWS SDK BOM 管理的模块（依赖关系）列在 M [aven 中央存储库中](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest)。

有关使用 BOM 指定开发工具包依赖项的更多信息，请参阅[将开发工具包与 Apache Maven 一起使用](setup-project-maven.md)。