阿里雲團隊努力不懈,力求將最新的技術內容更快地以您最熟悉的語言呈現。本文由簡體中文內容自動轉碼而成,過程無人工干預。阿里雲不保證此自動轉碼的準確性、完整性及時效性。因轉碼造成的任何內容錯誤及因此可能帶來的損失,阿里雲概不負責,敬請見諒。本文内容請以簡體中文版本為準。
全部產品
Search
文件中心

安裝

更新時間: Oct 30, 2018

要求

  • 開通阿里雲OSS服務,並建立了AccessKeyId 和AccessKeySecret。
  • 如果您還沒有開通或者還不瞭解阿里雲OSS服務,請登入OSS產品首頁瞭解。
  • 如果還沒有建立AccessKeyId和AccessKeySecret,請到阿里雲Access Key管理創建Access Key。

安裝

直接用gem安裝:

  1. gem install aliyun-sdk

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

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

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

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

然後運行:

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

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

依賴

  • Ruby版本 >= 1.9.3
  • 支援Ruby運行環境的Windows/Linux/OS X系統

注意:

  • SDK依賴的一些gem是本地擴充的形式,因此需要安裝ruby-dev以支援編譯本地擴充的gem
  • SDK依賴的處理XML的gem(nokogiri)要求環境中包含zlib庫

Linux

Linux中以Ubuntu為例,安裝上述依賴的方法:

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

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

Windows

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

    注意:請下載2.1或以下版本。2.2版本因為存在問題無法順利安裝。

  2. 前往Ruby Installer下載DEVELOPMENT KIT,注意選擇相應的版本。下載後是一個壓縮包,在解壓前首先在C盤根目錄建立一個檔案夾C:\RubyDev,然後將壓縮包解壓到此檔案夾。
  3. Windows + R輸入cmd後回車進入到命令列視窗,輸入以下命令:

    1. cd C:\RubyDev
    2. ruby dk.rb init
    3. ruby dk.rb install

    如果最後一步install時顯示“config.yml配置錯誤”,則用文字編輯器開啟 C:\RubyDev\config.yml,將其內容改為:

    1. ---
    2. - C:/Ruby21

    保存config.yml然後繼續ruby dk.rb install。其中”Ruby21”是Ruby的安裝目錄。根據具體的名字填寫。完成後關閉此命令列視窗。

  4. Windows + R輸入cmd後回車進入到命令列視窗,輸入以下命令:

    1. gem install aliyun-sdk

    安裝順利完成後,輸入irb進入Ruby互動式命令列,輸入require 'aliyun/oss',如果顯示”true”則SDK已經順利安裝。

OS X

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

    1. ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  5. 安裝ruby,在終端輸入以下命令:

    1. brew install ruby
    2. exec $SHELL -l
  6. 安裝SDK,在終端輸入以下命令:

    1. gem install aliyun-sdk
  7. 在終端輸入以下命令驗證SDK安裝成功:

    1. irb
    2. > require 'aliyun/oss'
    3. => true