

O AWS SDK para Java 1.x chegou end-of-support em 31 de dezembro de 2025. Recomendamos que você migre para o [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html) para continuar recebendo novos recursos, melhorias de disponibilidade e atualizações de segurança.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Usar o SDK com o Gradle
<a name="setup-project-gradle"></a>

Para gerenciar as dependências do SDK do seu projeto [Gradle](https://gradle.com/), importe o BOM do Maven AWS SDK para Java para o arquivo do aplicativo. `build.gradle`

**nota**  
Nos exemplos a seguir, *1.12.529* substitua o arquivo de compilação por uma versão válida do AWS SDK para Java. Encontre a versão mais recente no [repositório central do Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest).

## Configuração do projeto para Gradle 4.6 ou superior
<a name="project-setup-for-gradle-4-6-or-higher"></a>

 [Desde o Gradle 4.6](https://docs.gradle.org/4.6/release-notes.html#bom-import), é possível usar o recurso de suporte de POM aprimorado do Gradle para a importação de arquivos de lista de materiais (BOM) declarando uma dependência em uma BOM.

1. Se você estiver usando o Gradle 5.0 ou posterior, pule para a etapa 2. Caso contrário, habilite o recurso *IMPROVED\$1POM\$1SUPPORT* no arquivo `settings.gradle`.

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

1. Adicione a BOM à seção *dependências* do arquivo `build.gradle` do aplicativo.

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

1. Especifique os módulos do SDK a serem usados na seção *dependencies*. Por exemplo, o seguinte inclui uma dependência para 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'
       ...
   }
   ```

O Gradle resolve automaticamente a versão correta das dependências do SDK usando as informações da BOM.

Veja a seguir um exemplo de um `build.gradle` arquivo completo que inclui uma dependência para 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'
}
```

**nota**  
No exemplo anterior, substitua a dependência por pelas Amazon S3 dependências dos AWS serviços que você usará em seu projeto. Os módulos (dependências) que são gerenciados pelo AWS SDK para Java BOM estão listados no repositório [central do Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest).

## Configuração do projeto para versões do Gradle anteriores à 4.6
<a name="project-setup-for-gradle-versions-earlier-than-4-6"></a>

As versões do Gradle anteriores à 4.6 não possuem suporte nativo a BOM. Para gerenciar AWS SDK para Java dependências do seu projeto, use o [plug-in de gerenciamento de dependências](https://github.com/spring-gradle-plugins/dependency-management-plugin) do Spring para Gradle para importar o BOM do Maven para o SDK.

1. Adicione o plug-in de gerenciamento de dependências ao arquivo `build.gradle` do aplicativo.

   ```
   buildscript {
       repositories {
           mavenCentral()
       }
       dependencies {
           classpath "io.spring.gradle:dependency-management-plugin:1.0.9.RELEASE"
       }
   }
   
   apply plugin: "io.spring.dependency-management"
   ```

1. Adicione a BOM à seção *dependencyManagement* do arquivo.

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

1. Especifique os módulos do SDK que você usará na seção *dependencies* Por exemplo, o seguinte inclui uma dependência para o Amazon S3.

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

O Gradle resolve automaticamente a versão correta das dependências do SDK usando as informações da BOM.

Veja a seguir um exemplo de um `build.gradle` arquivo completo que inclui uma dependência para 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'
}
```

**nota**  
No exemplo anterior, substitua a dependência por pelas Amazon S3 dependências do AWS serviço que você usará em seu projeto. Os módulos (dependências) que são gerenciados pelo AWS SDK para Java BOM estão listados no repositório [central do Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest).

Para obter mais informações sobre como especificar dependências do SDK usando a BOM, consulte [Usar o SDK com o Apache Maven](setup-project-maven.md).