- github地址:https://github.com/aliyun/aliyun-oss-ruby-sdk
- API文檔地址:http://www.rubydoc.info/gems/aliyun-sdk/
- ChangeLog:https://github.com/aliyun/aliyun-oss-ruby-sdk/blob/master/CHANGELOG.md
要求
- 開通阿里雲OSS服務,並建立了AccessKeyId 和AccessKeySecret。
- 如果您還沒有開通或者還不瞭解阿里雲OSS服務,請登入OSS產品首頁瞭解。
- 如果還沒有建立AccessKeyId和AccessKeySecret,請到阿里雲Access Key管理創建Access Key。
安裝
直接用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的使用者可以使用此源。
依賴
- Ruby版本 >= 1.9.3
- 支援Ruby運行環境的Windows/Linux/OS X系統
注意:
- SDK依賴的一些gem是本地擴充的形式,因此需要安裝ruby-dev以支援編譯本地擴充的gem
- SDK依賴的處理XML的gem(nokogiri)要求環境中包含zlib庫
Linux
Linux中以Ubuntu為例,安裝上述依賴的方法:
sudo apt-get install ruby ruby-dev zlib1g-dev
各個Linux發行版都有自己的包管理工具,安裝的方法類似。
Windows
- 前往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
- 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,在終端輸入以下命令:
gem install aliyun-sdk
在終端輸入以下命令驗證SDK安裝成功:
irb
> require 'aliyun/oss'
=> true