Erstellen des SDK für Browser - AWS SDK for JavaScript

Wir haben das Kommende end-of-support für AWS SDK for JavaScript v2 angekündigt. Wir empfehlen Ihnen, auf AWS SDK for JavaScript Version 3 zu migrieren. Termine, weitere Details und Informationen zur Migration finden Sie in der verlinkten Ankündigung.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erstellen des SDK für Browser

Das SDK für JavaScript wird als JavaScript Datei mit Unterstützung für eine Reihe von Standarddiensten bereitgestellt. Diese Datei wird in der Regel mithilfe eines <script>-Tags in Browser-Skripts geladen, das das gehostete SDK-Paket referenziert. Möglicherweise benötigen Sie Unterstützung für andere Services als die im Standardsatz enthaltenen Services oder müssen das SDK auf andere Weise anpassen.

Wenn Sie mit dem SDK außerhalb einer Umgebung arbeiten, in der CORS in Ihrem Browser durchgesetzt wird, und wenn Sie Zugriff auf alle vom SDK bereitgestellten Dienste für haben möchten JavaScript, können Sie lokal eine benutzerdefinierte Kopie des SDK erstellen, indem Sie das Repository klonen und dieselben Build-Tools ausführen, mit denen die gehostete Standardversion des SDK erstellt wird. In den folgenden Abschnitten werden die Schritte erklärt, anhand derer das SDK zusammen mit zusätzlichen Services und API-Versionen erstellt werden kann.

Verwenden Sie den SDK Builder zum Erstellen des SDK für JavaScript

Der einfachste Weg, Ihren eigenen Build von zu erstellen, AWS SDK for JavaScript ist die Verwendung der SDK Builder-Webanwendung unter https://sdk.amazonaws.com/builder/js. Verwenden Sie den SDK-Builder, um die Services und deren API-Versionen, die in Ihrem Build eingeschlossen werden sollen, anzugeben.

Wählen Sie zu Beginn Select all services (Alle Services auswählen) oder Select Standard Services (Standard-Services auswählen) aus. Hier haben Sie die Möglichkeit, Services hinzuzufügen oder zu entfernen. Wählen Sie Development (Entwicklung) aus, wenn Sie einen besser lesbaren Code wünschen, oder Minified (Minimiert), um einen minimierten Build bereitzustellen. Nachdem Sie die gewünschten Services und Versionen ausgewählt haben, wählen Sie Build aus, um Ihr benutzerdefiniertes SDK zu erstellen und herunterzuladen.

Verwenden der CLI zum Erstellen des SDK für JavaScript

Um das SDK für die JavaScript Verwendung von zu erstellen AWS CLI, müssen Sie zuerst das Git-Repository klonen, das die SDK-Quelle enthält. Git und Node.js müssen auf Ihrem Computer installiert sein.

Klonen Sie zunächst das Repository aus dem Verzeichnis GitHub und ändern Sie das Verzeichnis in das Verzeichnis:

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

Nachdem Sie das Repository geklont haben, laden Sie das Abhängigkeitsmodul für das SDK und das Build-Tool herunter:

npm install

Sie können jetzt eine verpackte Version des SDK erstellen.

Die Erstellung von der Befehlszeile

Das Builder-Tool befindet sich hier: dist-tools/browser-builder.js. Führen Sie dieses Skript aus, indem Sie Folgendes eingeben:

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

Dieser Befehl erstellt die aws-sdk.js-Datei. Diese Datei ist unkomprimiert. Standardmäßig enthält dieses Paket nur den Standardsatz an Services.

Minimierte Build-Ausgabe

Um die Datenmenge im Netzwerk zu reduzieren, können JavaScript Dateien mithilfe eines Prozesses, der als Minimierung bezeichnet wird, komprimiert werden. Bei der Minimierung werden Kommentare, überflüssige Leerzeichen und andere Zeichen entfernt, die die Lesbarkeit unterstützen, jedoch keine Auswirkungen auf die Ausführung des Codes haben. Das Builder-Tool kann unkomprimierte oder minimiert Ausgaben generieren. Um Ihre Build-Ausgabe zu minimieren, legen Sie die Umgebungsvariable MINIFY fest:

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

Erstellen von bestimmten Services und API-Versionen

Sie können auswählen, welche Dienste im SDK erstellt werden sollen. Um die Services auszuwählen, geben Sie die Namen der Services durch Kommas getrennt als Parameter ein. Um beispielsweise nur Amazon S3 und Amazon EC2 zu erstellen, verwenden Sie den folgenden Befehl:

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

Indem Sie die Versionsbezeichnung nach dem Service-Namen hinzufügen, können Sie auch spezifische API-Versionen des Services erstellen. Um beispielsweise beide API-Versionen von Amazon DynamoDB zu erstellen, verwenden Sie den folgenden Befehl:

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

Service-IDs und API-Versionen sind in den dienstspezifischen Konfigurationsdateien unter https://github.com/aws/ /tree/master/apis verfügbar. aws-sdk-js

Erstellen aller Services

Sie können alle Services und API-Versionen erstellen, indem Sie den all-Parameter verwenden:

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

Erstellen bestimmter Services

Um die Auswahl der Services, die im Build eingeschlossen sein sollen, anzupassen, übergeben Sie die Umgebungsvariable AWS_SERVICES an den Browserify-Befehl, der die Liste der gewünschten Services enthält. Im folgenden Beispiel werden die Amazon EC2-, Amazon S3- und DynamoDB-Services erstellt.

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

Erstellen des SDK als Abhängigkeit mit Browserify

Node.js verfügt über einen modulbasierten Mechanismus, um Code und Funktionen von externen Entwicklern einzuschließen. Dieser modulare Ansatz wird bei der JavaScript Ausführung in Webbrowsern nicht nativ unterstützt. Jedoch steht Ihnen mithilfe des Browserify-Tools der Node.js-Modulansatz zur Verfügung und Sie können Module verwenden, die im Browser für Node.js geschrieben wurden. Browserify baut die Modulabhängigkeiten für ein Browserskript in einer einzigen, eigenständigen JavaScript Datei auf, die Sie im Browser verwenden können.

Sie können mithilfe von Browserify das SDK als Bibliotheksabhängigkeit für jedes Browser-Skript erstellen. Beispielsweise erfordert der folgende Node.js-Code das SDK:

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

Dieses Beispiel kann mithilfe von Browserify in eine Browser-kompatible Version kompiliert werden:

$ browserify index.js > browser-app.js

Die Anwendung, einschließlich der SDK-Abhängigkeiten, wird dann im Browser mithilfe von browser-app.js zur Verfügung gestellt.

Weitere Informationen über Browserify finden Sie auf der Browserify-Website.