

La AWS SDK per Java 1.x è stata raggiunta end-of-support il 31 dicembre 2025. Ti consigliamo di eseguire la migrazione a per continuare [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html)a ricevere nuove funzionalità, miglioramenti della disponibilità e aggiornamenti di sicurezza.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Usa gli strumenti di costruzione
<a name="setup-build-tools"></a>

L'uso di strumenti di compilazione aiuta a gestire lo sviluppo di progetti Java. Sono disponibili diversi strumenti di compilazione, ma mostriamo come iniziare a usare due strumenti di compilazione popolari: Maven e Gradle. Questo argomento mostra come utilizzare questi strumenti di compilazione per gestire le dipendenze SDK for Java necessarie per i tuoi progetti.

**Topics**
+ [Utilizzare gli SDK con Apache Maven](setup-project-maven.md)
+ [Utilizzare gli SDK con Gradle](setup-project-gradle.md)

# Utilizzare gli SDK con Apache Maven
<a name="setup-project-maven"></a>

Puoi usare [Apache Maven](https://maven.apache.org/) per configurare e creare AWS SDK per Java progetti o per creare l'SDK stesso.

**Nota**  
Per utilizzare le linee guida in questo argomento è necessario che sia installato Maven. Se non è già installato, visita [http://maven.apache.org/](http://maven.apache.org/) per scaricarlo e installarlo.

## Crea un nuovo pacchetto Maven
<a name="create-a-new-maven-package"></a>

Per creare un pacchetto Maven di base, apri una finestra di terminale (riga di comando) ed esegui:

```
mvn -B archetype:generate \
  -DarchetypeGroupId=org.apache.maven.archetypes \
  -DgroupId=org.example.basicapp \
  -DartifactId=myapp
```

Sostituisci *org.example.basicapp* con lo spazio dei nomi completo del pacchetto della tua applicazione e *myapp* con il nome del tuo progetto (questo diventerà il nome della directory del tuo progetto).

Per impostazione predefinita, crea un modello di progetto utilizzando l'archetipo [quickstart, che è un buon punto di partenza](http://maven.apache.org/archetypes/maven-archetype-quickstart/) per molti progetti. Sono disponibili altri archetipi; visita la pagina degli archetipi di [Maven per un elenco degli archetipi inclusi](https://maven.apache.org/archetypes/index.html). Può scegliere un determinato archetipo da utilizzare aggiungendo l'argomento `-DarchetypeArtifactId` al comando `archetype:generate`. Per esempio:

```
mvn archetype:generate \
  -DarchetypeGroupId=org.apache.maven.archetypes \
  -DarchetypeArtifactId=maven-archetype-webapp \
  -DgroupId=org.example.webapp \
  -DartifactId=mywebapp
```

**Nota**  
[Molte altre informazioni sulla creazione e la configurazione dei progetti sono disponibili nella Maven Getting Started Guide.](https://maven.apache.org/guides/getting-started/)

## Configura l'SDK come dipendenza Maven
<a name="configuring-maven"></a>

Per utilizzarlo AWS SDK per Java nel tuo progetto, dovrai dichiararlo come dipendenza nel file del tuo progetto. `pom.xml` [A partire dalla versione 1.9.0, puoi importare [singoli componenti](#configuring-maven-individual-components) o l'intero SDK.](#configuring-maven-entire-sdk)

### Specificazione di singoli moduli SDK
<a name="configuring-maven-individual-components"></a>

Per selezionare singoli moduli SDK, utilizza la AWS SDK per Java distinta base (BOM) per Maven, che garantirà che i moduli specificati utilizzino la stessa versione dell'SDK e siano compatibili tra loro.

Per utilizzare il BOM, aggiungi una `<dependencyManagement>` sezione al `pom.xml` file dell'applicazione, aggiungendola `aws-java-sdk-bom` come dipendenza e specificando la versione dell'SDK che desideri utilizzare:

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

[Per visualizzare l'ultima versione della distinta base disponibile su AWS SDK per Java Maven Central, visita: com.amazonaws/. https://mvnrepository.com/artifact/ aws-java-sdk-bom](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom) Puoi anche utilizzare questa pagina per vedere quali moduli (dipendenze) sono gestiti dal BOM che puoi includere nella sezione del file del tuo progetto. `<dependencies>` `pom.xml`

Ora puoi selezionare singoli moduli dall'SDK che usi nella tua applicazione. Poiché la versione SDK è già stata dichiarata nella distinta base, non è necessario specificare il numero di versione di ogni 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>
```

Puoi anche fare riferimento a per * AWS Code Sample Catalog *scoprire quali dipendenze usare per un determinato periodo. Servizio AWS Fare riferimento al file POM in un esempio di servizio specifico. Ad esempio, se sei interessato alle dipendenze per il servizio AWS S3, consulta l'esempio [completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/java/example_code/s3/src/main/java/aws/example/s3/GetAcl.java) su. GitHub (Guardate il pom 3). under /java/example\$1code/s

### Importazione di tutti i moduli SDK
<a name="configuring-maven-entire-sdk"></a>

Se desideri inserire l'*intero* SDK come dipendenza, non utilizzare il metodo BOM, ma dichiaralo semplicemente nel tuo modo: `pom.xml`

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

## Creare il progetto
<a name="build-your-project"></a>

Una volta impostato il progetto, puoi crearlo usando il comando di Maven: `package`

```
mvn package
```

Questo creerà il tuo `0jar` file nella `target` directory.

## Crea l'SDK con Maven
<a name="building-with-maven"></a>

Puoi usare Apache Maven per creare l'SDK dal codice sorgente. Per fare ciò, [scarica il codice SDK da](https://github.com/aws/aws-sdk-java), decomprimilo localmente GitHub, quindi esegui il seguente comando Maven:

```
mvn clean install
```

# Utilizzare gli SDK con Gradle
<a name="setup-project-gradle"></a>

Per gestire le dipendenze SDK per il tuo progetto [Gradle](https://gradle.com/), importa la BOM Maven per the nel file dell'applicazione. AWS SDK per Java `build.gradle`

**Nota**  
Negli esempi seguenti, sostituisci *1.12.529* nel file di build con una versione valida di. AWS SDK per Java Trova la versione più recente nel repository [centrale di Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest).

## Configurazione del progetto per Gradle 4.6 o versioni successive
<a name="project-setup-for-gradle-4-6-or-higher"></a>

 A [partire da Gradle 4.6](https://docs.gradle.org/4.6/release-notes.html#bom-import), è possibile utilizzare la funzionalità di supporto POM migliorata di Gradle per importare file BOM (Bill of Materials) dichiarando una dipendenza da una BOM.

1. Se stai usando Gradle 5.0 o versioni successive, vai al passaggio 2. Altrimenti, abilita la funzione *IMPROVED\$1POM\$1SUPPORT* nel file. `settings.gradle`

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

1. Aggiungete il BOM alla sezione delle *dipendenze del file dell'applicazione*. `build.gradle`

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

1. Specifica i moduli SDK da utilizzare nella sezione *dipendenze*. Ad esempio, quanto segue include una dipendenza per 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 risolve automaticamente la versione corretta delle dipendenze SDK utilizzando le informazioni della distinta base.

Di seguito è riportato un esempio di `build.gradle` file completo che include una dipendenza per. 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**  
Nell'esempio precedente, sostituite la dipendenza per Amazon S3 con le dipendenze dei AWS servizi che utilizzerete nel progetto. [I moduli (dipendenze) gestiti dalla AWS SDK per Java BOM sono elencati nell'archivio centrale di Maven.](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest)

## Configurazione del progetto per le versioni di Gradle precedenti alla 4.6
<a name="project-setup-for-gradle-versions-earlier-than-4-6"></a>

Le versioni di Gradle precedenti alla 4.6 non dispongono del supporto BOM nativo. Per gestire AWS SDK per Java le dipendenze del tuo progetto, usa il [plug-in di gestione delle dipendenze](https://github.com/spring-gradle-plugins/dependency-management-plugin) di Spring per Gradle per importare la BOM Maven per l'SDK.

1. Aggiungi il plug-in di gestione delle dipendenze al file dell'applicazione. `build.gradle`

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

1. Aggiungere la distinta base alla sezione *dependencyManagement* del file.

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

1. Specificate i moduli SDK che utilizzerete nella sezione delle *dipendenze*. Ad esempio, quanto riportato di seguito include una dipendenza per Amazon S3.

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

Gradle risolve automaticamente la versione corretta delle dipendenze SDK utilizzando le informazioni della distinta base.

Di seguito è riportato un esempio di `build.gradle` file completo che include una dipendenza per. 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**  
Nell'esempio precedente, sostituite la dipendenza per Amazon S3 con le dipendenze del AWS servizio che utilizzerete nel progetto. [I moduli (dipendenze) gestiti dalla AWS SDK per Java BOM sono elencati nell'archivio centrale di Maven.](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest)

[Per ulteriori informazioni sulla specificazione delle dipendenze dell'SDK utilizzando il BOM, consulta Uso dell'SDK con Apache Maven.](setup-project-maven.md)