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 Apache Maven
<a name="setup-project-maven"></a>

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
<a name="create-a-new-maven-package"></a>

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
<a name="configuring-maven"></a>

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
<a name="configuring-maven-individual-components"></a>

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 `<dependencyManagement>` 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:

```
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.amazonaws</groupId>
      <artifactId>aws-java-sdk-bom</artifactId>
      <version>1.11.1000</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>
```

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 `<dependencies>` 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.

```
<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-s3</artifactId>
  </dependency>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-dynamodb</artifactId>
  </dependency>
</dependencies>
```

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
<a name="configuring-maven-entire-sdk"></a>

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:

```
<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk</artifactId>
    <version>1.11.1000</version>
  </dependency>
</dependencies>
```

## Compilar o projeto
<a name="build-your-project"></a>

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
<a name="building-with-maven"></a>

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
```