安裝 - SDK參考

直接用gem安裝：

 
  gem install aliyun-sdk

如果無法訪問https://rubygems.org，則可以使用淘寶的鏡像源：

 
  gem install aliyun-sdk --clear-sources --source https://ruby.taobao.org

或者通過bundler安裝，首先在你的應用程式的Gemfile中添加：

 
  gem 'aliyun-sdk', '~> 0.3.0'

然後運行：

 
  # 使用淘寶的鏡像源，可選
  bundle config mirror.https://rubygems.org https://ruby.taobao.org
  
  bundle install

注意：https://ruby.taobao.org 是完整的rubygems.org的鏡像，自動和官方源同步。不方便訪問rubygems.org的使用者可以使用此源。

注意：

SDK依賴的一些gem是本地擴充的形式，因此需要安裝ruby-dev以支援編譯本地擴充的gem

SDK依賴的處理XML的gem(nokogiri)要求環境中包含zlib庫

Linux中以Ubuntu為例，安裝上述依賴的方法：

 
  sudo apt-get install ruby ruby-dev zlib1g-dev

各個Linux發行版都有自己的包管理工具，安裝的方法類似。

前往Ruby Installer下載RubyInstaller，雙擊安裝，在安裝時選中”Add Ruby executables to your PATH”。

注意：請下載2.1或以下版本。2.2版本因為存在問題無法順利安裝。
前往Ruby Installer下載DEVELOPMENT KIT，注意選擇相應的版本。下載後是一個壓縮包，在解壓前首先在C盤根目錄建立一個檔案夾C:\RubyDev，然後將壓縮包解壓到此檔案夾。
按Windows + R輸入cmd後回車進入到命令列視窗，輸入以下命令：
```
   
     cd C:\RubyDev
     ruby dk.rb init
     ruby dk.rb install
   
```
如果最後一步install時顯示“config.yml配置錯誤”，則用文字編輯器開啟 C:\RubyDev\config.yml，將其內容改為：
```
   
     ---
     - C:/Ruby21
   
```
保存config.yml然後繼續ruby dk.rb install。其中”Ruby21”是Ruby的安裝目錄。根據具體的名字填寫。完成後關閉此命令列視窗。
按Windows + R輸入cmd後回車進入到命令列視窗，輸入以下命令：
```
   
     gem install aliyun-sdk
   
```
安裝順利完成後，輸入irb進入Ruby互動式命令列，輸入require 'aliyun/oss'，如果顯示”true”則SDK已經順利安裝。

OS X系統預設已經安裝了ruby，但是為了方便使用和管理，建議使用者再安裝一個開發用的版本。
在終端輸入xcode-select --install安裝”Xcode command line tools”。如果安裝失敗，可選擇手動下載安裝（見下載的步驟）。
從蘋果開發人員網站下載”Xcode command line tools”，需要用您的Apple ID登入後才能下載。注意選擇與您的系統匹配的版本。下載完成後雙擊載入dmg檔案，然後在開啟的視窗中雙擊安裝程式進行安裝。在安裝的過程中需要輸入您的系統密碼。

安裝brew，在終端輸入以下命令：

   
     ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

安裝ruby，在終端輸入以下命令：

   
     brew install ruby
     exec $SHELL -l

在終端輸入以下命令驗證SDK安裝成功：

   
     irb
     > require 'aliyun/oss'
     => true