将 SDK 与 Gradle 结合使用 - Amazon SDK for Java 1.x
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

我们宣布了即将推出 end-of-support 的 Amazon SDK for Java (v1)。建议您迁移到 Amazon SDK for Java v2。有关日期、其他详细信息以及如何迁移的信息,请参阅链接的公告。

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

将 SDK 与 Gradle 结合使用

要管理 Gradle 项目的 SDK 依赖项,请将 Amazon SDK for Java 的 Maven BOM 导入到应用程序的 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 中的信息来解析开发工具包依赖项的正确版本。

以下是包含 Amazon S3 的依赖项的完整 build.gradle 文件的示例。

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 管理的模块(依赖项)列在 Maven Central 存储库中。

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

早于 4.6 的 Gradle 版本缺少本机 BOM 支持。要管理项目的Amazon SDK for Java依赖项,请使用 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 中的信息来解析开发工具包依赖项的正确版本。

以下是包含 Amazon S3 的依赖项的完整 build.gradle 文件的示例。

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 管理的模块(依赖项)列在 Maven Central 存储库中。

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