適用於 JavaScript 的 AWS SDK v2 已end-of-support。我們建議您遷移至 [適用於 JavaScript 的 AWS SDK v3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/)。如需如何遷移的其他詳細資訊和資訊，請參閱此[公告](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 建立適用於瀏覽器的軟體開發套件
<a name="building-sdk-for-browsers"></a>

適用於 JavaScript 的 SDK 以 JavaScript 檔案提供，並支援預設的服務集。此檔案通常會使用 ` <script>` 標籤載入瀏覽器指令碼，參考託管的軟體開發套件套件。但是，您可能需要預設服務之外其他服務的支援，否則便需要自訂軟體開發套件。

如果您在瀏覽器中強制執行 CORS 的環境之外使用 開發套件，並且想要存取 開發套件 for JavaScript 提供的所有服務，您可以複製儲存庫並執行建置軟體開發套件預設託管版本的相同建置工具，以在本機建置軟體開發套件的自訂複本。以下區段說明使用額外服務和 API 版本來建立軟體開發套件的步驟。

**Topics**
+ [使用 SDK Builder 建置適用於 JavaScript 的 SDK](#using-the-sdk-builder)
+ [使用 CLI 建置適用於 JavaScript 的 SDK](#using-command-line-tools)
+ [建立特定服務和 API 版本](#building-specific-services-versions)
+ [使用 Browserify 來將軟體開發套件建立為相依性](#building-using-browserify)

## 使用 SDK Builder 建置適用於 JavaScript 的 SDK
<a name="using-the-sdk-builder"></a>

建立自有建置的最簡單方法是使用 SDK 建置器 Web 應用程式，網址 適用於 JavaScript 的 AWS SDK 為 https：//[https://sdk.amazonaws.com/builder/js](https://sdk.amazonaws.com/builder/js)。使用軟體開發套件建置器，來指定要包含在建置中的服務和其 API 版本。

選擇 **Select all services (選取所有服務)**，或選擇 **Select default services (選取預設服務)** 做為您可以新增或移除服務的起點。選擇 **Development (開發)** 來取得可讀性更高的程式碼，或選擇 **Minified (壓縮)** 來建立要部署的壓縮建置。在您選擇要包含的服務和版本後，請選擇 **Build (建置)** 來建置及下載您的自訂軟體開發套件。

## 使用 CLI 建置適用於 JavaScript 的 SDK
<a name="using-command-line-tools"></a>

若要使用 建置適用於 JavaScript 的 SDK AWS CLI，您必須先複製包含 SDK 來源的 Git 儲存庫。您必須在電腦上安裝 Git 和 Node.js。

先從 GitHub 複製儲存庫，並將目錄變更為該目錄：

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

複製儲存庫後，下載同時適用於軟體開發套件和建置工具的相依性模組：

```
npm install
```

您就可以立即建立軟體開發套件的套件版本。

### 從命令列建立
<a name="building-from-command-line"></a>

建置器工具位於 `dist-tools/browser-builder.js` 中。輸入以下資訊來執行此指令碼：

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

此命令會建立 aws-sdk.js 檔案。此檔案未壓縮。依預設，此套件僅包含一套標準的服務。

### 壓縮建置輸出
<a name="minifying-build-output"></a>

為了降低網路上的資料量，您可以透過名為*壓縮*的程序來壓縮 JavaScript 檔案。壓縮指令碼評論、不必要的空間和有助於人類讀取的其他特性，但不會影響程式碼執行。建置器工具可產生解壓縮或已壓縮的輸出。若要壓縮建置輸出，請設定 `MINIFY` 環境變數：

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

## 建立特定服務和 API 版本
<a name="building-specific-services-versions"></a>

您可以選取要在軟體開發套件中建立哪些服務。若要選取服務，請指定做為參數的服務名稱 (以逗號分隔)。例如，若要僅建置 Amazon S3 和 Amazon EC2，請使用下列命令：

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

您也可以透過在服務名稱後新增版本名稱，來選取服務建置的特定 API 版本。例如，若要建置 Amazon DynamoDB 的兩個 API 版本，請使用下列命令：

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

服務識別符和 API 版本可在 https：//[https://github.com/aws/aws-sdk-js/tree/master/apis ](https://github.com/aws/aws-sdk-js/tree/master/apis)的服務特定組態檔案中取得。

### 建置所有服務
<a name="building-all-services"></a>

您可以透過包含 `all` 參數來建立所有服務和 API 版本：

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

### 建立特定服務
<a name="building-specific-services"></a>

若要自訂在建置中包含的特定一組服務，請將 ` AWS_SERVICES` 環境變數傳遞給 Browserify 命令，其中包含您需要的服務清單。下列範例會建置 Amazon EC2、Amazon S3 和 DynamoDB 服務。

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

## 使用 Browserify 來將軟體開發套件建立為相依性
<a name="building-using-browserify"></a>

Node.js 擁有以模型為基礎的機制，可用來包含來自第三方開發人員的程式碼和功能。web 瀏覽器中執行的 JavaScript 並未原生支援此模組化方法。然而，您可以使用名為 Browserify 的工具，來使用 Node.js 模組方法和使用瀏覽器中為 Node.js 所寫的模組。Browserify 會在您可以與瀏覽器搭配使用的單一、可獨立自主運作的 JavaScript 檔案中，建立適用於瀏覽器指令碼的模組相依性。

您可以使用 Browserify 來建立做為任何瀏覽器指令碼程式庫相依性的軟體開發套件。例如，以下 Node.js 程式碼需要軟體開發套件：

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

您可以使用 Browserify 來將此範例程式碼編譯為與瀏覽器相容的版本：

```
$ browserify index.js > browser-app.js
```

可透過 `browser-app.js` 在瀏覽器中取得應用程式 (包含其軟體開發套件相依性)。

如需 Browserify 的詳細資訊，請參閱 [Browserify 網站](http://browserify.org/)。