Le AWS SDK pour Java 1.x a été atteint end-of-support le 31 décembre 2025. Nous vous recommandons de migrer vers le pour continuer [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html)à bénéficier des nouvelles fonctionnalités, des améliorations de disponibilité et des mises à jour de sécurité. Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Utiliser des outils de construction L'utilisation d'outils de compilation permet de gérer le développement de projets Java. Plusieurs outils de construction sont disponibles, mais nous montrons comment démarrer avec deux outils de construction populaires : Maven et Gradle. Cette rubrique explique comment utiliser ces outils de génération pour gérer les dépendances du SDK for Java dont vous avez besoin pour vos projets. **Topics** + [Utilisation du kit SDK avec Apache Maven](setup-project-maven.md) + [Utilisation du kit SDK avec Gradle](setup-project-gradle.md) # Utilisation du kit SDK avec Apache Maven Vous pouvez utiliser [Apache Maven](https://maven.apache.org/) pour configurer et créer AWS SDK pour Java des projets, ou pour créer le SDK lui-même. **Note** Maven doit être installé sur votre ordinateur pour que vous puissiez utiliser les instructions de cette rubrique. Si tel n'est pas le cas, rendez-vous sur [http://maven.apache.org/](http://maven.apache.org/) pour le télécharger et l'installer. ## Création d'un package Maven Pour créer un package Maven de base, ouvrez une fenêtre de terminal (ligne de commande) et exécutez : ``` mvn -B archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DgroupId=org.example.basicapp \ -DartifactId=myapp ``` Remplacez *org.example.basicapp* par l'espace de noms complet du package de votre application et *myapp* par le nom de votre projet (celui-ci devient le nom du répertoire de votre projet). Par défaut, crée un modèle de projet pour vous en utilisant l'archétype de [démarrage rapide](http://maven.apache.org/archetypes/maven-archetype-quickstart/), qui constitue un bon point de départ pour de nombreux projets. D'autres archétypes sont disponibles ; visitez la page des archétypes [Maven pour obtenir la liste des archétypes](https://maven.apache.org/archetypes/index.html) fournis avec. Vous pouvez choisir un archétype particulier à utiliser en ajoutant l'argument `-DarchetypeArtifactId` à la commande `archetype:generate`. Par exemple : ``` mvn archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DarchetypeArtifactId=maven-archetype-webapp \ -DgroupId=org.example.webapp \ -DartifactId=mywebapp ``` **Note** De plus amples informations sur la création et la configuration de projets sont fournies dans le [guide de démarrage de Maven](https://maven.apache.org/guides/getting-started/). ## Configuration du kit SDK en tant que dépendance Maven Pour utiliser le AWS SDK pour Java dans votre projet, vous devez le déclarer en tant que dépendance dans le `pom.xml` fichier de votre projet. Depuis la version 1.9.0, vous pouvez importer des [composants individuels](#configuring-maven-individual-components) ou l'[intégralité du kit SDK](#configuring-maven-entire-sdk). ### Spécification individuelle des modules SDK Pour sélectionner des modules du SDK individuels, utilisez la AWS SDK pour Java nomenclature (BOM) de Maven, qui garantit que les modules que vous spécifiez utilisent la même version du SDK et qu'ils sont compatibles les uns avec les autres. Pour utiliser la nomenclature, ajoutez une section `` au fichier `pom.xml` de votre application, en ajoutant `aws-java-sdk-bom` en tant que dépendance et en spécifiant la version du kit SDK que vous voulez utiliser : ``` com.amazonaws aws-java-sdk-bom 1.11.1000 pom import ``` [Pour consulter la dernière version de la AWS SDK pour Java nomenclature disponible sur Maven Central, rendez-vous sur : https://mvnrepository.com/artifact/ com.amazonaws/. aws-java-sdk-bom](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom) Vous pouvez également utiliser cette page pour savoir quels sont les modules (dépendances) gérés par la nomenclature et que vous pouvez inclure dans la section `` du fichier `pom.xml` de votre projet. Vous pouvez maintenant sélectionner individuellement les modules du kit SDK que vous utilisez dans votre application. Dans la mesure où vous avez déjà déclaré la version du kit SDK dans la nomenclature, il n'est pas nécessaire de spécifier le numéro de version de chaque composant. ``` com.amazonaws aws-java-sdk-s3 com.amazonaws aws-java-sdk-dynamodb ``` Vous pouvez également vous référer au * Catalogue d'exemples de code AWS *pour savoir quelles dépendances utiliser pour une donnée Service AWS. Reportez-vous au fichier POM sous un exemple de service spécifique. Par exemple, si vous êtes intéressé par les dépendances du service AWS S3, consultez l'[exemple complet](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/java/example_code/s3/src/main/java/aws/example/s3/GetAcl.java) sur GitHub. (Regardez le pompon under /java/example\$1code/s 3). ### Importation de tous les modules SDK Si vous souhaitez enregistrer l'*intégralité* du kit SDK comme dépendance, n'utilisez pas la méthode de nomenclature, mais déclarez simplement le kit SDK dans votre fichier `pom.xml`, comme suit : ``` com.amazonaws aws-java-sdk 1.11.1000 ``` ## Génération de votre projet Une fois que vous avez configuré votre projet, vous pouvez le générer à l'aide de la commande Maven `package` : ``` mvn package ``` Cette opération crée votre fichier `–0—jar` dans le répertoire `target`. ## Génération du kit SDK avec Maven Vous pouvez utiliser Apache Maven pour générer le kit SDK à partir du code source. Pour ce faire, [téléchargez le code du SDK depuis GitHub](https://github.com/aws/aws-sdk-java), décompressez-le localement, puis exécutez la commande Maven suivante : ``` mvn clean install ``` # Utilisation du kit SDK avec Gradle Pour gérer les dépendances du SDK pour votre projet [Gradle](https://gradle.com/), importez la nomenclature Maven correspondante AWS SDK pour Java dans le fichier de l'application. `build.gradle` **Note** Dans les exemples suivants, remplacez *1.12.529* le fichier de compilation par une version valide du AWS SDK pour Java. Trouvez la dernière version dans le [référentiel central de Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest). ## Configuration du projet pour Gradle version 4.6 ou ultérieure [Depuis Gradle 4.6](https://docs.gradle.org/4.6/release-notes.html#bom-import), vous pouvez utiliser la fonctionnalité de support POM améliorée de Gradle pour importer des fichiers de nomenclature (BOM) en déclarant une dépendance à une nomenclature. 1. Si vous utilisez Gradle version 5.0 ou ultérieure, passez à l'étape 2. Sinon, activez la fonction *IMPROVED\$1POM\$1SUPPORT* dans le fichier `settings.gradle`. ``` enableFeaturePreview('IMPROVED_POM_SUPPORT') ``` 1. Ajoutez la nomenclature à la section des *dépendances* du `build.gradle` fichier de l'application. ``` ... dependencies { implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529') // Declare individual SDK dependencies without version ... } ``` 1. Spécifiez les modules SDK que vous souhaitez utiliser dans la section des *dépendances*. Par exemple, ce qui suit inclut une dépendance pour 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 résout automatiquement la version correcte des dépendances de votre kit SDK à l'aide des informations de la nomenclature. Voici un exemple de `build.gradle` fichier complet qui inclut une dépendance pour 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' } ``` **Note** Dans l'exemple précédent, remplacez la dépendance pour Amazon S3 par les dépendances des AWS services que vous utiliserez dans votre projet. Les modules (dépendances) gérés par le AWS SDK pour Java BOM sont répertoriés dans le référentiel [central Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest). ## Configuration de projet pour les versions de Gradle antérieures à la version 4.6 Les versions de Gradle antérieures à la version 4.6 ne prennent pas en charge la nomenclature native. Pour gérer les AWS SDK pour Java dépendances de votre projet, utilisez le [plugin de gestion des dépendances](https://github.com/spring-gradle-plugins/dependency-management-plugin) de Spring pour Gradle afin d'importer la nomenclature Maven pour le SDK. 1. Ajoutez le plugin de gestion des dépendances au `build.gradle` fichier de votre application. ``` buildscript { repositories { mavenCentral() } dependencies { classpath "io.spring.gradle:dependency-management-plugin:1.0.9.RELEASE" } } apply plugin: "io.spring.dependency-management" ``` 1. Ajoutez la nomenclature dans la section *dependencyManagement* du fichier. ``` dependencyManagement { imports { mavenBom 'com.amazonaws:aws-java-sdk-bom:1.12.529' } } ``` 1. Spécifiez les modules SDK que vous utiliserez dans la section des *dépendances*. L'exemple suivant inclut une dépendance pour Amazon S3. ``` dependencies { compile 'com.amazonaws:aws-java-sdk-s3' } ``` Gradle résout automatiquement la version correcte des dépendances de votre kit SDK à l'aide des informations de la nomenclature. Voici un exemple de `build.gradle` fichier complet qui inclut une dépendance pour 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' } ``` **Note** Dans l'exemple précédent, remplacez la dépendance pour Amazon S3 par les dépendances du AWS service que vous utiliserez dans votre projet. Les modules (dépendances) gérés par le AWS SDK pour Java BOM sont répertoriés dans le référentiel [central Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest). Pour plus de détails sur la spécification des dépendances du kit SDK à l'aide de la nomenclature, consultez [Utilisation du kit SDK avec Apache Maven](setup-project-maven.md).