AWS SDK for Java 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로 SDK 사용하기
<a name="setup-project-gradle"></a>

[Gradle](https://gradle.com/) 프로젝트의 SDK 종속성을 관리하려면의 Maven BOM AWS SDK for Java 을 애플리케이션의 `build.gradle` 파일로 가져옵니다.

**참고**  
다음 예제에서는 빌드 파일의 *1.12.529*를 AWS SDK for Java의 유효한 버전으로 바꿉니다. [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) BOM(Bill Of Material)에 종속성을 선언하면 Gradle의 향상된 POM 지원 기능을 사용하여 BOM 파일을 가져올 수 있습니다.

1. Gradle 5.0 이상을 사용하는 경우 2단계로 건너뜁니다. 그렇지 않으면 `settings.gradle` 파일에서 *IMPROVED\$1POM\$1SUPPORT* 기능을 활성화하세요.

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

1. 애플리케이션의 `build.gradle` 파일에서 *종속성* 섹션에 BOM을 추가합니다.

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

1. *종속성* 섹션에 사용할 SDK 모듈을 지정합니다. 예를 들어, 다음은 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의 정보를 사용하여 올바른 SDK 종속성 버전을 자동으로 확인합니다.

다음은 종속성이 포함된 전체 `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'
}
```

**참고**  
이전 예제에서의 종속성을 프로젝트에서 사용할 AWS 서비스의 종속성 Amazon S3 으로 바꿉니다. AWS SDK for Java 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 지원이 부족합니다. 프로젝트의 AWS SDK for Java 종속성을 관리하려면 Gradle용 Spring의 [종속성 관리 플러그인](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의 정보를 사용하여 올바른 SDK 종속성 버전을 자동으로 확인합니다.

다음은 종속성이 포함된 전체 `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'
}
```

**참고**  
이전 예제에서의 종속성을 프로젝트에서 사용할 AWS 서비스의 종속성 Amazon S3 으로 바꿉니다. AWS SDK for Java BOM에서 관리하는 모듈(종속성)은 [Maven 중앙 리포지토리](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest)에 나열됩니다.

BOM을 사용한 SDK 종속성 지정에 대한 자세한 내용은 [Apache Maven으로 SDK 사용하기](setup-project-maven.md)를 참조하십시오.