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 ferramentas de compilação O uso de ferramentas de compilação ajuda a gerenciar o desenvolvimento de projetos Java. Várias ferramentas de compilação estão disponíveis, mas mostramos como começar a usar duas ferramentas de compilação populares: Maven e Gradle. Este tópico mostra como usar essas ferramentas de compilação para gerenciar as dependências do SDK para Java necessárias para seus projetos. **Topics** + [Usar o SDK com o Apache Maven](setup-project-maven.md) + [Usar o SDK com o Gradle](setup-project-gradle.md) # Usar o SDK com o Apache Maven Você pode usar o [Apache Maven](https://maven.apache.org/) para configurar e compilar projetos do AWS SDK para Java ou compilar o próprio SDK. **nota** Você deve ter o Maven instalado para usar a diretriz deste tópico. Se ele ainda não estiver instalado, visite [http://maven.apache.org/](http://maven.apache.org/) para fazer download e instalá-lo. ## Criar um novo pacote do Maven Para criar um pacote do Maven básico, abra uma janela de terminal (linha de comando) e execute: ``` mvn -B archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DgroupId=org.example.basicapp \ -DartifactId=myapp ``` Substitua *org.example.basicapp* pelo namespace do pacote completo do aplicativo e *myapp* pelo nome do projeto (este será o nome do diretório do projeto). Por padrão, cria um modelo de projeto para você usando o arquétipo [quickstart](http://maven.apache.org/archetypes/maven-archetype-quickstart/), que é um bom ponto de partida para muitos projetos. Existem mais arquétipos disponíveis; visite a página [Arquétipos do Maven](https://maven.apache.org/archetypes/index.html) para obter uma lista de arquétipos empacotados. Você pode escolher um determinado arquétipo a ser usado adicionando o argumento `-DarchetypeArtifactId` ao comando `archetype:generate`. Por exemplo: ``` mvn archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DarchetypeArtifactId=maven-archetype-webapp \ -DgroupId=org.example.webapp \ -DartifactId=mywebapp ``` **nota** Muito mais informações sobre como criar e configurar projetos são fornecidas no [Guia de conceitos básicos do Maven](https://maven.apache.org/guides/getting-started/). ## Configurar o SDK como uma dependência do Maven Para usar o AWS SDK para Java no projeto, será necessário declará-lo como uma dependência no arquivo `pom.xml` do projeto. Desde a versão 1.9.0, você pode importar [componentes individuais](#configuring-maven-individual-components) ou [todo o SDK](#configuring-maven-entire-sdk). ### Especificar módulos de SDK individuais Para selecionar módulos de SDK individuais, use a lista de materiais (BOM) do AWS SDK para Java para Maven, o que garantirá que os módulos especificados usem a mesma versão do SDK e sejam compatíveis entre si. Para usar a BOM, adicione uma seção `` ao arquivo `pom.xml` do aplicativo, adicionando `aws-java-sdk-bom` como uma dependência e especificando a versão do SDK que você deseja usar: ``` com.amazonaws aws-java-sdk-bom 1.11.1000 pom import ``` Para visualizar a versão mais recente da BOM do AWS SDK para Java disponível no Maven Central, visite: [https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom). Também é possível usar essa página para ver quais módulos (dependências) são gerenciados pela BOM que é possível incluir na seção `` do arquivo `pom.xml` do projeto. Agora você pode selecionar módulos individuais do SDK usados no aplicativo. Como já declarou a versão do SDK na BOM, você não precisa especificar o número da versão de cada componente. ``` com.amazonaws aws-java-sdk-s3 com.amazonaws aws-java-sdk-dynamodb ``` Também é possível consultar o *Catálogo de exemplos de código da AWS* para saber quais dependências devem ser usadas para determinado AWS service (Serviço da AWS). Consulte o arquivo POM em um exemplo de serviço específico. Por exemplo, se você estiver interessado nas dependências do serviço do AWS S3, consulte o [exemplo completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/java/example_code/s3/src/main/java/aws/example/s3/GetAcl.java) no GitHub. (Examine o pom em /java/example\$1code/s3). ### Importar todos os módulos do SDK Se você quiser extrair *todo* o SDK como uma dependência, não use o método da BOM. Basta declará-lo no `pom.xml` da seguinte forma: ``` com.amazonaws aws-java-sdk 1.11.1000 ``` ## Compilar o projeto Depois de configurar o projeto, será possível criá-lo usando o comando `package` do Maven: ``` mvn package ``` Isso criará o arquivo `–0—jar` no diretório `target`. ## Compilar o SDK com o Maven Você pode usar o Apache Maven para compilar o SDK pela origem. Para isso, [faça download do código do SDK no GitHub](https://github.com/aws/aws-sdk-java), descompacte-o localmente e execute o seguinte comando do Maven: ``` mvn clean install ``` # Usar o SDK com o Gradle 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 [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 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).