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

# 安裝適用於 Ruby 的 AWS SDK
<a name="setup-install"></a>

本節包含適用於 Ruby 的 AWS SDK 的先決條件和安裝指示。

## 先決條件
<a name="aws-ruby-sdk-prerequisites"></a>

在使用適用於 Ruby 的 AWS SDK 之前，您必須先向 進行身分驗證 AWS。如需設定身分驗證的資訊，請參閱 [AWS 使用適用於 Ruby 的 AWS SDK 透過 驗證](credentials.md)。

## 安裝 開發套件
<a name="installing-the-sdk"></a>

您可以像安裝 Ruby Gem 套件一樣安裝適用於 Ruby 的 AWS SDK。Gem 套件可在 [RubyGems](https://rubygems.org/gems/aws-sdk/) 取得。適用於 Ruby 的 AWS SDK 設計為模組化，並以 分隔 AWS 服務。安裝整個 `aws-sdk` Gem 套件很大，可能需要一個小時的時間。

建議您只為您 AWS 服務 使用的 安裝 Gem 套件。這些名稱命名為 ，`aws-sdk-service_abbreviation`完整清單位於適用於 Ruby README 的 AWS SDK 檔案的[支援服務](https://github.com/aws/aws-sdk-ruby/#supported-services)資料表中。例如，與 Amazon S3 服務連接的 Gem 套件可直接在 取得[https://rubygems.org/gems/aws-sdk-s3](https://rubygems.org/gems/aws-sdk-s3)。

### Ruby 版本管理員
<a name="installing-rvm"></a>

建議使用 Ruby 版本管理工具，而不是使用系統 Ruby，如下所示：
+ [RVM](http://rvm.io/)
+ [夏爾比](https://github.com/postmodern/chruby)
+ [rbenv](https://github.com/rbenv/rbenv)

例如，如果您使用的是 Amazon Linux 2 作業系統，下列命令可用來更新 RVM、列出可用的 Ruby 版本，然後選擇您想要使用適用於 Ruby 的 AWS SDK 進行開發的版本。Ruby 最低必要版本為 2.5。

```
$ rvm get head
$ rvm list known
$ rvm install ruby-3.1.3
$ rvm --default use 3.1.3
```

### Bundler
<a name="bundler"></a>

 如果您使用 [Bundler](http://bundler.io/)，下列命令會安裝適用於 Amazon S3 的 Ruby Gem AWS 開發套件：

1. 安裝 Bundler 並建立 `Gemfile`：

   ```
   $ gem install bundler
   $ bundle init
   ```

1. 開啟已建立的 `Gemfile`，並為程式碼將使用的每個 AWS 服務 Gem 新增一`gem`行。若要遵循 Amazon S3 範例，請將以下行新增至檔案底部：

   ```
   gem "aws-sdk-s3"
   ```

1. 儲存 Gemfile。

1. 安裝 中指定的相依性`Gemfile`：

   ```
   $ bundle install
   ```