適用於 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)，以繼續接收新功能、可用性改善和安全性更新。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用軟體開發套件搭配 Gradle
<a name="setup-project-gradle"></a>

若要管理 [Gradle](https://gradle.com/) 專案的 SDK 相依性，請將 的 Maven BOM 匯入 適用於 Java 的 AWS SDK 應用程式的 `build.gradle` 檔案。

**注意**  
在下列範例中，將建置檔案中的 *1.12.529* 取代為有效的 版本 適用於 Java 的 AWS SDK。在 [ Maven 中央儲存庫](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest)中尋找最新版本。

## Gradle 4.6 或更新版本的專案設定
<a name="project-setup-for-gradle-4-6-or-higher"></a>

 [自 Gradle 4.6](https://docs.gradle.org/4.6/release-notes.html#bom-import) 以來，您可以使用 Gradle 改善的 POM 支援功能，透過宣告對 BOM 的相依性來匯入物料清單 (BOM) 檔案。

1. 如果您使用 Gradle 5.0 或更新版本，請跳至步驟 2。否則，請在 `settings.gradle` 檔案中啟用 *IMPROVED\$1POM\$1SUPPORT* 功能。

   ```
   enableFeaturePreview('IMPROVED_POM_SUPPORT')
   ```

1. 將 BOM 新增至應用程式`build.gradle`檔案的*相依性*區段。

   ```
   ...
   dependencies {
       implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529')
   
       // Declare individual SDK dependencies without version
       ...
   }
   ```

1. 指定要在 *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 的資訊，自動解析您開發套件相依性的正確版本。

以下是包含其相依性的完整`build.gradle`檔案範例 Amazon S3。

```
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 為您將在專案中使用的 AWS 服務的相依性。由 適用於 Java 的 AWS SDK BOM 管理的模組 （相依性） 會列在 [Maven 中央儲存庫](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest)上。

## 4.6 之前 Gradle 版本的專案設定
<a name="project-setup-for-gradle-versions-earlier-than-4-6"></a>

4.6 之前的 Gradle 版本缺少原生 BOM 支援。若要管理專案的 適用於 Java 的 AWS SDK 相依性，請使用 Spring for Gradle 的[相依性管理外掛程式](https://github.com/spring-gradle-plugins/dependency-management-plugin)來匯入 SDK 的 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"
   ```

1. 新增 BOM 到檔案的 *dependencyManagement* 區段。

   ```
   dependencyManagement {
       imports {
           mavenBom 'com.amazonaws:aws-java-sdk-bom:1.12.529'
       }
   }
   ```

1. 指定您將在*相依性*區段中使用的 SDK 模組。例如，以下內容包含 Amazon S3的相依性。

   ```
   dependencies {
       compile 'com.amazonaws:aws-java-sdk-s3'
   }
   ```

Gradle 會使用 BOM 的資訊，自動解析您開發套件相依性的正確版本。

以下是包含其相依性的完整`build.gradle`檔案範例 Amazon S3。

```
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 為您將在專案中使用的 AWS 服務相依性。由 適用於 Java 的 AWS SDK BOM 管理的模組 （相依性） 會列在 [Maven 中央儲存庫](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest)上。

如需使用 BOM 指定 SDK 相依性的詳細資訊，請參閱[搭配 Apache Maven 使用 SDK](setup-project-maven.md)。