设置AWS SDK for Java

说明如何在您的项目中使用 AWS SDK for Java。

Prerequisites

要使用 AWS SDK for Java，必须拥有：

适合的 Java 开发环境。
AWS 账户和访问密钥。有关说明，请参阅注册 AWS 并创建 IAM 用户。
在环境中设置的 AWS 凭证(访问密钥)或使用共享(由 AWS CLI 和其他 SDKs 凭证文件)的凭证文件。有关更多信息，请参阅设置用于开发的 AWS 凭证和区域。

要在项目中包括开发工具包，根据您的编译系统或 IDE 使用以下方法之一：

Apache Maven – 如果使用 Apache Maven，可以将整个开发工具包（或开发工具包的特定组件）指定为项目的依赖项。有关如何在使用 Maven 时设置开发工具包的详细信息，请参阅将开发工具包与 Apache Maven 一起使用。
Gradle– 如果使用 Gradle，您可将 Maven 材料清单 (BOM) 导入到 Gradle 项目，以便自动管理开发工具包依赖项。有关更多信息，请参阅将开发工具包与 Gradle 一起使用。
Eclipse IDE – 如果使用 Eclipse IDE，您可能希望安装和使用 AWS Toolkit for Eclipse，它会自动为您下载、安装和更新 Java 开发工具包。有关更多信息和设置说明，请参阅 AWS Toolkit for Eclipse 用户指南。

如果您使用上述方法之一（例如，您使用的是 Maven），则无需下载并安装 AWS JAR 文件（您可以跳过以下部分）。如果要使用不同 IDE、使用 Apache Ant 或任何其他方法构建项目，请按照下一节中的说明下载并提取开发工具包。

我们建议您为新项目使用预建的最新开发工具包版本，从而针对所有 AWS 服务为您提供最新支持。

注意

有关如何下载和构建开发工具包旧版本的信息，请参阅安装开发工具包的旧版本。

下载和提取开发工具包的最新版本

开发工具包包含以下目录：

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

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

要安装开发工具包的旧版本

转到开发工具包的 GitHub 页面: 适用于 Java 的 AWS 开发工具包 (GitHub)。
选择与所需开发工具包的版本号对应的标签。例如：1.6.10。
单击 Download Zip 按钮下载选择的开发工具包版本。
将文件解压缩到开发系统中的一个目录中。在很多系统中，可使用自己的图形文件管理器执行该操作，或在终端窗口中使用 unzip 实用程序。
在终端窗口中，导航到将开发工具包源文件解压缩的目录。
使用以下命令构建并安装开发工具包 (Maven 需要)：
```
mvn clean install
```
生成的 .jar 文件会构建到 target 目录中。
(可选) 使用以下命令构建 API 参考文档：
```
mvn javadoc:javadoc
```
该文档构建到 target/site/apidocs/ 目录中。

AWS SDK for Java要求使用 J2SE Development Kit 6.0 或更高版本。可以从 http://www.oracle.com/technetwork/java/javase/downloads/ 下载最新的 Java 软件。

重要

Java 版本 1.6 (JS2E 6.0) 中没有 SHA256 签名的 SSL 证书的内置支持，而在 2015 年 9 月 30 日以后，与 AWS 的所有 HTTPS 连接都需要该功能。

Java 版本 1.7 或更高版本包含已更新证书，不受这一问题的影响。

为了让使用适用于 Java 的 AWS 开发工具包的基于服务器的应用程序获得最佳性能，我们建议您使用 Java 虚拟机 (JVM) 的 64 位版本。此 JVM 仅在服务器模式下运行，即使在运行时指定了 -Client 选项也是如此。

在运行时将 JVM 的 32 位版本与 -Server 选项一起使用应可以提供与 64 位 JVM 相当的性能。

Javascript 在您的浏览器中被禁用或不可用。

要使用 AWS 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

设置用于开发的 AWS 凭证和区域