Abbiamo annunciato l'imminente uscita end-of-support per la AWS SDK for JavaScript v2. Ti consigliamo di migrare alla AWS SDK for JavaScript v3. Per date, dettagli aggiuntivi e informazioni su come effettuare la migrazione, consulta l'annuncio collegato.

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à.

Creazione dell'SDK per i browser

L'SDK per JavaScript viene fornito come JavaScript file con supporto incluso per un set predefinito di servizi. Questo file viene in genere caricato negli script di browser utilizzando un tag <script> che fa riferimento al pacchetto SDK ospitato. Tuttavia, potrebbe essere necessario il supporto per i servizi diversi dal set predefinito o comunque si potrebbe rendere necessario personalizzare l'SDK.

Se utilizzi l'SDK al di fuori di un ambiente che applica CORS nel tuo browser e desideri accedere a tutti i servizi forniti dall'SDK per JavaScript, puoi creare una copia personalizzata dell'SDK localmente clonando il repository ed eseguendo gli stessi strumenti di compilazione che creano la versione ospitata predefinita dell'SDK. Le sezioni seguenti descrivono la procedura per creare l'SDK con servizi e versioni dell'API aggiuntivi.

Utilizzo di SDK Builder per creare l'SDK per JavaScript

Il modo più semplice per creare la propria build di AWS SDK for JavaScript è utilizzare l'applicazione web SDK Builder all'indirizzo https://sdk.amazonaws.com/builder/js. Utilizza il builder di SDK per specificare i servizi e le versioni dell'API da includere nella build.

Scegli Select all services (Seleziona tutti i servizi) o Select default services (Seleziona servizi predefiniti) come punto di partenza da cui è possibile aggiungere o rimuovere i servizi. Scegli (Sviluppo) Development per il codice più leggibile oppure Minified (Minimizzato) per creare una build minimizzata da distribuire. Dopo aver scelto i servizi e le versioni da includere, scegli Build (Crea) per creare e scaricare l'SDK personalizzato.

Utilizzo della CLI per creare l'SDK per JavaScript

Per creare l'SDK per l' JavaScript utilizzo di AWS CLI, devi prima clonare il repository Git che contiene il codice sorgente SDK. È necessario avere installato Git e Node.js sul computer.

Innanzitutto, clona il repository da GitHub e modifica la directory nella directory:

git clone https://github.com/aws/aws-sdk-js.git
cd aws-sdk-js

Dopo aver clonato il repository, scarica i moduli di dipendenza sia per l'SDK sia per lo strumento di compilazione:

npm install

Ora puoi creare una versione in pacchetto dell'SDK.

Creazione dalla riga di comando

Lo strumento di creazione si trova in dist-tools/browser-builder.js. Esegui questo script digitando:

node dist-tools/browser-builder.js > aws-sdk.js

Questo comando crea il file aws-sdk.js. Questo file non è compresso. Per impostazione predefinita questo pacchetto include solo il set standard di servizi.

Minimizzate l'output della build

Per ridurre la quantità di dati sulla rete, JavaScript i file possono essere compressi tramite un processo chiamato minificazione. La minimizzazione rimuove commenti, spazi inutili e altri caratteri che facilitano leggibilità umana ma che non influiscono sull'esecuzione del codice. Lo strumento di compilazione è in grado di produrre output non compressi o minimizzati. Per creare l'output della build minimizzato, imposta la variabile di ambiente MINIFY:

MINIFY=1 node dist-tools/browser-builder.js > aws-sdk.js

Creazione di servizi e versioni dell'API specifici

È possibile selezionare quali servizi creare nell'SDK. Per selezionare i servizi, specifica i nomi del servizio, delimitati da virgole, come parametri. Ad esempio, per creare solo Amazon S3 e Amazon EC2, usa il seguente comando:

node dist-tools/browser-builder.js s3,ec2 > aws-sdk-s3-ec2.js

È inoltre possibile selezionare specifiche versioni dell'API della build dei servizi aggiungendo il nome della versione dopo il nome del servizio. Ad esempio, per creare entrambe le versioni API di Amazon DynamoDB, usa il seguente comando:

node dist-tools/browser-builder.js dynamodb-2011-12-05,dynamodb-2012-08-10

Gli identificatori di servizio e le versioni delle API sono disponibili nei file di configurazione specifici del servizio all'indirizzo https://github.com/aws/ /tree/master/apis. aws-sdk-js

Creazione di tutti i servizi

È possibile creare tutti i servizi e le versioni dell'API includendo il parametro all:

node dist-tools/browser-builder.js all > aws-sdk-full.js

Creazione di servizi specifici

Per personalizzare il set selezionato di servizi inclusi nella build, passa la variabile di ambiente AWS_SERVICES al comando Browserify che contiene l'elenco di servizi desiderato. L'esempio seguente crea i servizi Amazon EC2, Amazon S3 e DynamoDB.

$ AWS_SERVICES=ec2,s3,dynamodb browserify index.js > browser-app.js

Creazione dell'SDK come dipendenza con Browserify

Node.js dispone di un meccanismo basato sul modulo per includere il codice e la funzionalità da sviluppatori di terze parti. Questo approccio modulare non è supportato nativamente dall'esecuzione nei browser Web. JavaScript Tuttavia, con uno strumento chiamato Browserify, è possibile utilizzare l'approccio del modulo Node.js e i moduli scritti per Node.js nel browser. Browserify crea le dipendenze del modulo per uno script del browser in un unico JavaScript file autonomo che è possibile utilizzare nel browser.

È possibile creare l'SDK come dipendenza della libreria per qualsiasi script di browser utilizzando Browserify. Ad esempio, il codice Node.js riportato di seguito richiede l'SDK:

var AWS = require('aws-sdk');
var s3 = new AWS.S3();
s3.listBuckets(function(err, data) { console.log(err, data); });

Questo codice di esempio può essere compilato in una versione compatibile con il browser utilizzando Browserify:

$ browserify index.js > browser-app.js

L'applicazione, incluse le dipendenze SDK, è disponibile all'interno del browser tramite browser-app.js.

Per ulteriori informazioni su Browserify, consulta il sito Web di Browserify.