

 適用於 Java 的 AWS SDK 1.x 已於 2025 年 12 月 31 日end-of-support。我們建議您遷移至 [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 存取入口網站](signup-create-iam-user.md#setup-awsaccount) AWS IAM Identity Center。
+ 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 的最新版本。

**注意**  
如需有關如何下載和建置舊版 SDK 的資訊，請參閱[安裝舊版 SDK](#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. 下載 SDK 後，將內容擷取至本機目錄。

開發套件包含下列目錄：
+  `documentation`- 包含 API 文件 （也可在 Web 上取得：[適用於 Java 的 AWS SDK API 參考](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/))。
+  `lib`- 包含 SDK `.jar` 檔案。
+  `samples`- 包含工作範例程式碼，示範如何使用 SDK。
+  `third-party/lib`- 包含開發套件使用的第三方程式庫，例如 Apache 通用日誌記錄、AspectJ 和 Spring 架構。

若要使用 SDK，請將 `lib`和 `third-party` 目錄的完整路徑新增至建置檔案中的相依性，並將其新增至您的 Java `CLASSPATH`以執行程式碼。

## 從來源建置舊版 SDK （不建議）
<a name="install-prev-sdk"></a>

只有最新版的完整 SDK 會以可下載的 jar 格式提供。不過，您可以使用 Apache Maven （開放原始碼） 建置舊版 SDK。Maven 會在一個步驟中下載所有必要的相依性、建置和安裝 SDK。如需安裝說明和詳細資訊，請造訪 [http://maven.apache.org/](http://maven.apache.org/)：//。

1. 前往開發套件的 GitHub 頁面，網址為： [適用於 Java 的 AWS SDK (GitHub)](https://github.com/aws/aws-sdk-java)。

1. 選擇與您想要的 SDK 版本編號對應的標籤。例如 `1.6.10`。

1. 按一下**下載 ZIP** 按鈕，下載您選取的 SDK 版本。

1. 將檔案解壓縮至開發系統上的目錄。在許多系統上，您可以使用圖形檔案管理員來執行此操作，或在終端機視窗中使用 `unzip` 公用程式。

1. 在終端機視窗中，導覽至您解壓縮 SDK 來源的目錄。

1. 使用下列命令建置並安裝 SDK （需要 [Maven](https://maven.apache.org/))：

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

   產生的 `.jar` 檔案內建至 `target` 目錄。

1. （選用） 使用以下命令建置 API 參考文件：

   ```
   mvn javadoc:javadoc
   ```

   文件內建於 `target/site/apidocs/`目錄中。