适用于 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) 以继续获得新功能、可用性改进和安全更新。

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

# 如何获得 适用于 Java 的 AWS SDK
<a name="setup-install"></a>

## 先决条件
<a name="prerequisitesinstall"></a>

要使用 适用于 Java 的 AWS SDK，您必须具备：
+ 您必须能够[登录 AWS IAM Identity Center中提供的 AWS 访问门户](signup-create-iam-user.md#setup-awsaccount)。
+ 一个合适的 [Java 安装](signup-create-iam-user.md#java-dg-java-env)。
+ 在您的本地共享 `credentials` 文件中设置的临时凭证。

有关如何进行设置以使用适用于 Java 的 SDK 的说明，请参阅[要使用的基本设置 AWS 服务](signup-create-iam-user.md)主题。

## 使用构建工具管理适用于 Java 的 SDK 的依赖项（推荐）
<a name="include-sdk"></a>

建议在项目中使用 Apache Maven 或 Gradle 来访问适用于 Java 的 SDK 所需的依赖项。 [本部分](setup-build-tools.md)说明如何使用这些工具。

## 下载并解压缩 SDK（不推荐）
<a name="download-and-extract-sdk"></a>

建议使用构建工具来访问项目的 SDK，但您也可以下载最新版 SDK 的预构建 jar。

**注意**  
有关如何下载和构建开发工具包旧版本的信息，请参阅[安装开发工具包的旧版本](#install-prev-sdk)。

1. 从 [https://sdk-for-java.amazonwebservices.com/latest/aws-java-sdk.zip](https://sdk-for-java.amazonwebservices.com/latest/aws-java-sdk.zip) 下载软件开发工具包。

1. 下载开发工具包之后，将内容提取到本地目录中。

开发工具包包含以下目录：
+  `documentation` – 包含 API 文档（同时在 Web 上提供：[适用于 Java 的 AWS SDK API Reference](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/)）。
+  `lib` – 包含 SDK `.jar` 文件。
+  `samples` – 包含说明如何使用 SDK 的实用示例代码。
+  `third-party/lib` – 包含 SDK 使用的第三方库，例如 Apache Commons 日志记录、AspectJ 和 Spring 框架。

要使用开发工具包，将完整路径添加到 `lib`，并将 `third-party` 目录添加到编译文件中的依赖项，然后将它们添加到 java `CLASSPATH` 以运行代码。

## 从源代码构建 SDK 的早期版本（不推荐）
<a name="install-prev-sdk"></a>

预建表单中仅提供完整 SDK 的最新版本，作为可下载 jar。不过，可使用 Apache Maven（开源）构建开发工具包的旧版本。Maven 将一步完成下载所有必需的依赖项、构建和安装开发工具包。有关安装说明和更多信息，请访问 [http://maven.apache.org/](http://maven.apache.org/)。

1. 前往 SDK 的 GitHub 页面，网址为:[适用于 Java 的 AWS SDK (GitHub)](https://github.com/aws/aws-sdk-java)。

1. 选择与所需开发工具包的版本号对应的标签。例如 `1.6.10`。

1. 单击 **Download Zip** 按钮下载选择的开发工具包版本。

1. 将文件解压缩到开发系统中的一个目录中。在很多系统中，可使用自己的图形文件管理器执行该操作，或在终端窗口中使用 `unzip` 实用程序。

1. 在终端窗口中，导航到将开发工具包源文件解压缩的目录。

1. 使用以下命令构建并安装开发工具包 ([Maven](https://maven.apache.org/) 需要)：

   ```
   mvn clean install -Dgpg.skip=true
   ```

   生成的 `.jar` 文件会构建到 `target` 目录中。

1. (可选) 使用以下命令构建 API 参考文档：

   ```
   mvn javadoc:javadoc
   ```

   该文档构建到 `target/site/apidocs/` 目录中。