将 SDK 与 Apache Maven 结合使用 - AWS SDK for Java 1.x
创建新的 Maven 软件包将开发工具包配置为 Maven 依赖项重新构建项目。使用 Maven 构建开发工具包

自2024年7月31日起， AWS SDK for Java 1.x已进入维护模式，并将于2025年12月31日end-of-support上线。我们建议您迁移到AWS SDK for Java 2.x以继续接收新功能、可用性改进和安全更新。

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

将 SDK 与 Apache Maven 结合使用

您可以使用 Apache Maven 配置和构建AWS SDK for Java项目或构建开发工具包本身。

注意

您必须安装 Maven 才能使用本主题中的指导信息。如果尚未安装 Maven，请访问 http://maven.apache.org/ 下载并进行安装。

创建新的 Maven 软件包

要创建基本的 Maven 软件包，请打开终端 (命令行) 窗口并运行：

mvn -B archetype:generate \
  -DarchetypeGroupId=org.apache.maven.archetypes \
  -DgroupId=org.example.basicapp \
  -DartifactId=myapp

将 org.example.basicapp 替换为您的应用程序的完整软件包命名空间，将 myapp 替换为项目的名称 (这将变为项目的目录名称)。

默认情况下，使用 quickstart 原型为您创建项目模板，该原型是许多项目的绝佳起点。还提供了更多原型；有关随该软件打包的原型的列表，请访问 Maven archetypes 页面。可以通过向 -DarchetypeArtifactId 命令中添加 archetype:generate 参数来选择要使用的特定原型。例如：

mvn archetype:generate \
  -DarchetypeGroupId=org.apache.maven.archetypes \
  -DarchetypeArtifactId=maven-archetype-webapp \
  -DgroupId=org.example.webapp \
  -DartifactId=mywebapp
注意

《Maven Getting Started Guide》中提供了有关创建和配置项目的详细信息。

将开发工具包配置为 Maven 依赖项

要在项目中使用 AWS SDK for Java，您需要在项目的 pom.xml 文件中将该工具包声明为依赖项。从 1.9.0 版开始，可以导入单个组件或整个开发工具包。

指定单独的开发工具包模块

要选择单个开发工具包模块，请使用 AWS SDK for Java 的 Maven 材料清单 (BOM)，这将确保您指定的所有模块使用相同版本的开发工具包而且相互兼容。

要使用 BOM，请向应用程序的 <dependencyManagement> 文件中添加一个 pom.xml 部分，将 aws-java-sdk-bom 作为依赖项添加并指定要使用的开发工具包的版本：

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.amazonaws</groupId>
      <artifactId>aws-java-sdk-bom</artifactId>
      <version>1.11.1000</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

要查看 Maven Central 中提供的最新版本的AWS SDK for Java BOM，请访问：https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom。您也可以使用此页查看项目 pom.xml 文件的 <dependencies> 部分中包括的 BOM 管理了哪些模块（依赖项）。

现在，可以从您的应用程序中所使用的开发工具包中选择单个模块。由于您已经在 BOM 中声明了开发工具包版本，因此无需为每个组件都指定版本号。

<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-s3</artifactId>
  </dependency>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-dynamodb</artifactId>
  </dependency>
</dependencies>

还可以参考 AWS 代码示例目录 来了解要用于给定 AWS 服务的依赖项。请参阅特定的服务示例下的 POM 文件。例如，如果您想了解 AWS S3 服务的依赖项，请参阅 GitHub 上的完整示例。（查看 /java/example_code/s3 下的 pom）。

导入所有开发工具包模块

如果您想将整个开发工具包作为一个依赖项拉入，请勿使用 BOM 方法，而只需在 pom.xml 中声明该开发工具包，如下所示：

<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk</artifactId>
    <version>1.11.1000</version>
  </dependency>
</dependencies>

重新构建项目。

在设置项目之后，可以使用 Maven 的 package 命令进行构建：

mvn package

这会在 –0—jar 目录中创建 target 文件。

使用 Maven 构建开发工具包

可以使用 Apache Maven 从源构建开发工具包。为此，请从 GitHub 下载开发工具包代码，在本地解压缩，然后执行下面的 Maven 命令：

mvn clean install