La AWS SDK para Java 1.x se alcanzó end-of-support el 31 de diciembre de 2025. Le recomendamos que migre a [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html) para seguir recibiendo nuevas características, mejoras de disponibilidad y actualizaciones de seguridad. Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Usar herramientas de compilación El uso de herramientas de compilación ayuda a gestionar el desarrollo de los proyectos de Java. Hay varias herramientas de compilación disponibles, pero mostramos cómo ponerlas en marcha con dos herramientas de compilación populares: Maven y Gradle. En este tema, se muestra cómo utilizar estas herramientas de compilación para gestionar las dependencias del SDK para Java que necesita para sus proyectos. **Topics** + [Usar el SDK con Apache Maven](setup-project-maven.md) + [Usar el SDK con Gradle.](setup-project-gradle.md) # Usar el SDK con Apache Maven Puede utilizar [Apache Maven](https://maven.apache.org/) para configurar y compilar proyectos de AWS SDK para Java o para compilar el propio SDK. **nota** Debe tener Maven instalado para utilizar las instrucciones de este tema. Si aún no está instalado, visite [http://maven.apache.org/](http://maven.apache.org/) para descargarlo e instalarlo. ## Creación de un nuevo paquete de Maven Para crear un paquete de Maven básico, abra un ventana de terminal (línea de comandos) y ejecute: ``` mvn -B archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DgroupId=org.example.basicapp \ -DartifactId=myapp ``` Sustituya *org.example.basicapp* por el espacio de nombres del paquete completo de su aplicación y *myapp* por el nombre del proyecto (este será el nombre del directorio de su proyecto). De forma predeterminada, crea una plantilla de proyecto que utiliza el arquetipo de [inicio rápido](http://maven.apache.org/archetypes/maven-archetype-quickstart/), lo que constituye un buen punto de partida para muchos proyectos. Hay más arquetipos disponibles; visite la página [Arquetipos de Maven](https://maven.apache.org/archetypes/index.html) para obtener una lista de arquetipos del paquete. Puede elegir un determinado arquetipo añadiendo el argumento `-DarchetypeArtifactId` al comando `archetype:generate`. Por ejemplo: ``` mvn archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DarchetypeArtifactId=maven-archetype-webapp \ -DgroupId=org.example.webapp \ -DartifactId=mywebapp ``` **nota** Encontrará mucha más información sobre la creación y configuración de proyectos en la [Guía de introducción a Maven](https://maven.apache.org/guides/getting-started/). ## Configuración del SDK como una dependencia de Maven Para utilizar AWS SDK para Java en el proyecto, tendrá que declararlo como una dependencia en el archivo `pom.xml` del proyecto. A partir de la versión 1.9.0, puede importar [componentes individuales](#configuring-maven-individual-components) o [todo el SDK](#configuring-maven-entire-sdk). ### Especificación de módulos del SDK individuales Para seleccionar módulos individuales del SDK, utilice la lista de materiales (BOM) de AWS SDK para Java para Maven, con lo que se asegurará de que los módulos que especifique utilicen la misma versión del SDK y que sean compatibles entre sí. Para utilizar la lista de materiales, añada una sección `` al archivo `pom.xml` de su aplicación, añadiendo `aws-java-sdk-bom` como una dependencia y especificando la versión del SDK que desee utilizar: ``` com.amazonaws aws-java-sdk-bom 1.11.1000 pom import ``` Para ver la última versión de la lista de materiales de AWS SDK para Java disponible en Maven Central, visite: [https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom). También puede utilizar esta página para ver qué módulos (dependencias) administrados por la lista de materiales puede incluir en la sección `` del archivo `pom.xml` de su proyecto. Ahora puede seleccionar los módulos individuales del SDK que desea usar en su aplicación. Como ya ha declarado la versión del SDK en la lista de materiales, no necesita especificar el número de versión de cada componente. ``` com.amazonaws aws-java-sdk-s3 com.amazonaws aws-java-sdk-dynamodb ``` También puede consultar el *AWS Code Sample Catalog* para saber qué dependencias utilizar para un servicio de Servicio de AWS determinado. Consulte el archivo POM en un ejemplo de servicio específico. Por ejemplo, si está interesado en las dependencias del servicio AWS S3, consulte el [ejemplo completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/java/example_code/s3/src/main/java/aws/example/s3/GetAcl.java) en GitHub. (Vea el pom en /java/example\$1code/s3). ### Importación de todos los módulos del SDK Si desea incluir *todo* el SDK como una dependencia, no utilice el método de lista de materiales; simplemente declárelo en su archivo `pom.xml` de la manera siguiente: ``` com.amazonaws aws-java-sdk 1.11.1000 ``` ## Compilación del proyecto Una vez que haya configurado su proyecto, puede compilarlo mediante el comando `package` de Maven: ``` mvn package ``` Esto creará el archivo `–0—jar` en el directorio `target`. ## Compilación del SDK con Maven Puede utilizar Apache Maven para compilar el SDK desde el origen. Para ello, [descargue el código del SDK de GitHub](https://github.com/aws/aws-sdk-java), desempaquételo localmente y, a continuación, ejecute el siguiente comando de Maven: ``` mvn clean install ``` # Usar el SDK con Gradle. Para administrar las dependencias del SDK de tu proyecto de [Gradle](https://gradle.com/), importa la BOM de Maven correspondiente AWS SDK para Java al archivo de la aplicación. `build.gradle` **nota** En los siguientes ejemplos, reemplaza el archivo *1.12.529* de compilación por una versión válida de. AWS SDK para Java Busque la última versión disponible en el [repositorio central de Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest). ## Configuración del proyecto en Gradle 4.6 o posterior [A partir de Gradle 4.6](https://docs.gradle.org/4.6/release-notes.html#bom-import), puede utilizar la característica de soporte de POM mejorada de Gradle para importar archivos de lista de materiales (BOM) declarando una dependencia en una BOM. 1. Si está utilizando Gradle 5.0 o posterior, vaya al paso 2. De lo contrario, habilite la característica *IMPROVED\$1POM\$1SUPPORT* en el archivo `settings.gradle`. ``` enableFeaturePreview('IMPROVED_POM_SUPPORT') ``` 1. Añada la BOM a la sección de *dependencias* del archivo `build.gradle`. ``` ... dependencies { implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529') // Declare individual SDK dependencies without version ... } ``` 1. Especifique los módulos del SDK que desea usar en la sección *dependencias*. Por ejemplo, lo siguiente incluye una dependencia 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' ... } ``` Gradle resuelve automáticamente la versión correcta de las dependencias del SDK con la información de la BOM. A continuación se muestra un ejemplo de un `build.gradle` archivo completo que incluye una dependencia 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** En el ejemplo anterior, sustituya la dependencia por Amazon S3 las dependencias de los AWS servicios que utilizará en el proyecto. Los módulos (dependencias) que administra la AWS SDK para Java BOM se enumeran en el repositorio central de [Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest). ## Configuración del proyecto para versiones de Gradle anteriores a 4.6 Las versiones de Gradle anteriores a 4.6 carecen de soporte de BOM nativo. Para administrar AWS SDK para Java las dependencias de tu proyecto, usa el [complemento de administración de dependencias](https://github.com/spring-gradle-plugins/dependency-management-plugin) de Spring para Gradle a fin de importar la BOM de Maven para el SDK. 1. Añada el complemento de administración de dependencias a su archivo `build.gradle` de aplicación. ``` buildscript { repositories { mavenCentral() } dependencies { classpath "io.spring.gradle:dependency-management-plugin:1.0.9.RELEASE" } } apply plugin: "io.spring.dependency-management" ``` 1. Añada la lista de materiales a la sección *dependencyManagement* del archivo. ``` dependencyManagement { imports { mavenBom 'com.amazonaws:aws-java-sdk-bom:1.12.529' } } ``` 1. Especifique los módulos del SDK que va a usar en la sección *dependencies*. Por ejemplo, en el siguiente se incluye una dependencia para Amazon S3. ``` dependencies { compile 'com.amazonaws:aws-java-sdk-s3' } ``` Gradle resuelve automáticamente la versión correcta de las dependencias del SDK con la información de la BOM. El siguiente es un ejemplo de un `build.gradle` archivo completo que incluye una dependencia 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** En el ejemplo anterior, sustituya la dependencia por Amazon S3 las dependencias del AWS servicio que utilizará en el proyecto. Los módulos (dependencias) que administra la AWS SDK para Java BOM se enumeran en el repositorio central de [Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest). Para obtener más información sobre cómo especificar las dependencias del SDK mediante la BOM, consulte [Uso del SDK con Apache Maven](setup-project-maven.md).