Membangun SDK untuk Browser - AWS SDK for JavaScript

Kami mengumumkan yang akan datang end-of-support untuk AWS SDK for JavaScript v2. Kami menyarankan Anda bermigrasi ke AWS SDK for JavaScript v3. Untuk tanggal, detail tambahan, dan informasi tentang cara bermigrasi, silakan merujuk ke pengumuman tertaut.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Membangun SDK untuk Browser

SDK untuk JavaScript disediakan sebagai JavaScript file dengan dukungan yang disertakan untuk set layanan default. File ini biasanya dimuat ke skrip browser menggunakan <script> tag yang mereferensikan paket SDK yang dihosting. Namun, Anda mungkin memerlukan dukungan untuk layanan selain set default atau perlu menyesuaikan SDK.

Jika Anda bekerja dengan SDK di luar lingkungan yang memberlakukan CORS di browser Anda dan jika Anda ingin akses ke semua layanan yang disediakan oleh SDK for JavaScript, Anda dapat membuat salinan khusus SDK secara lokal dengan mengkloning repositori dan menjalankan alat build yang sama yang membangun versi default SDK yang dihosting. Bagian berikut menjelaskan langkah-langkah untuk membangun SDK dengan layanan tambahan dan versi API.

Menggunakan SDK Builder untuk Membangun SDK JavaScript

Cara termudah untuk membuat build Anda sendiri AWS SDK for JavaScript adalah dengan menggunakan aplikasi web pembuat SDK di https://sdk.amazonaws.com/builder/js. Gunakan pembuat SDK untuk menentukan layanan, dan versi API-nya, untuk disertakan dalam build Anda.

Pilih Pilih semua layanan atau pilih Pilih layanan default sebagai titik awal dari mana Anda dapat menambah atau menghapus layanan. Pilih Pengembangan untuk kode yang lebih mudah dibaca atau pilih Diperkecil untuk membuat build yang diperkecil untuk diterapkan. Setelah memilih layanan dan versi yang akan disertakan, pilih Build to build dan download SDK kustom Anda.

Menggunakan CLI untuk Membangun SDK untuk JavaScript

Untuk membangun SDK untuk JavaScript menggunakan AWS CLI, Anda harus terlebih dahulu mengkloning repositori Git yang berisi sumber SDK. Anda harus menginstal Git dan Node.js di komputer Anda.

Pertama, kloning repositori dari GitHub dan ubah direktori ke direktori:

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

Setelah Anda mengkloning repositori, unduh modul dependensi untuk SDK dan alat build:

npm install

Anda sekarang dapat membuat versi paket SDK.

Membangun dari Command Line

Alat pembangun ada didist-tools/browser-builder.js. Jalankan skrip ini dengan mengetik:

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

Perintah ini membangun file aws-sdk.js. File ini tidak terkompresi. Secara default paket ini hanya mencakup serangkaian layanan standar.

Meminimalkan Output Build

Untuk mengurangi jumlah data pada jaringan, JavaScript file dapat dikompresi melalui proses yang disebut minifikasi. Minifikasi menghapus komentar, spasi yang tidak perlu, dan karakter lain yang membantu keterbacaan manusia tetapi itu tidak memengaruhi eksekusi kode. Alat pembangun dapat menghasilkan output yang tidak terkompresi atau diperkecil. Untuk memperkecil keluaran build Anda, setel variabel MINIFY lingkungan:

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

Membangun Layanan Tertentu dan Versi API

Anda dapat memilih layanan mana yang akan dibangun ke dalam SDK. Untuk memilih layanan, tentukan nama layanan, dibatasi oleh koma, sebagai parameter. Misalnya, untuk membangun hanya Amazon S3 dan Amazon EC2, gunakan perintah berikut:

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

Anda juga dapat memilih versi API tertentu dari build layanan dengan menambahkan nama versi setelah nama layanan. Misalnya, untuk membangun kedua versi API Amazon DynamoDB, gunakan perintah berikut:

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

Pengidentifikasi layanan dan versi API tersedia dalam file konfigurasi khusus layanan di https://github.com/aws/ /tree/master/apis. aws-sdk-js

Membangun Semua Layanan

Anda dapat membangun semua layanan dan versi API dengan menyertakan all parameter:

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

Membangun Layanan Khusus

Untuk menyesuaikan kumpulan layanan yang dipilih yang disertakan dalam build, teruskan variabel AWS_SERVICES lingkungan ke perintah Browserify yang berisi daftar layanan yang Anda inginkan. Contoh berikut membangun layanan Amazon EC2, Amazon S3, dan DynamoDB.

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

Membangun SDK sebagai Dependensi dengan Browserify

Node.js memiliki mekanisme berbasis modul untuk memasukkan kode dan fungsionalitas dari pengembang pihak ketiga. Pendekatan modular ini tidak didukung secara native dengan JavaScript berjalan di browser web. Namun, dengan alat yang disebut Browserify, Anda dapat menggunakan pendekatan modul Node.js dan menggunakan modul yang ditulis untuk Node.js di browser. Browserify membangun dependensi modul untuk skrip browser menjadi satu JavaScript file mandiri yang dapat Anda gunakan di browser.

Anda dapat membangun SDK sebagai dependensi pustaka untuk skrip browser apa pun dengan menggunakan Browserify. Misalnya, kode Node.js berikut memerlukan SDK:

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

Contoh kode ini dapat dikompilasi ke dalam versi yang kompatibel dengan browser menggunakan Browserify:

$ browserify index.js > browser-app.js

Aplikasi, termasuk dependensi SDK-nya, kemudian tersedia di browser melalui. browser-app.js

Untuk informasi selengkapnya tentang Browserify, lihat situs web Browserify.