一、CocoaPods安装步骤
1、查看当前源
$ gem sources -l
如果输出下面的 Ruby 默认源需要移除更换:
*** CURRENT SOURCES ***
https://rubygems.org/
2.移除现有 Ruby 默认源
$ gem sources --remove https://rubygems.org/
3.添加新的Ruby 源(以下添加新的Ruby 源任选一种)
(1)、添加淘宝的Ruby 源,如果不报错就继续第4步骤的操作
$ gem sources -a https://ruby.taobao.org/
(2)、有时候输入$ gem sources -a https://ruby.taobao.org/会报出以下两种错误:
错误一:
ERROR: Could not find a valid gem 'cocoapods' (>= 0), here is why:
Unable to download data from http://ruby.taobao.org/ - bad response Not
Found 404 (http://ruby.taobao.org/latest_specs.4.8.gz)
解决方法:
因为淘宝是基于 HTTP 协议的镜像服务 需要改用https的协议:
gem sources --remove http://ruby.taobao.org/ (移除原来带http的ruby源)
gem sources -a https://ruby.taobao.org/ (添加带https的ruby源)
输入 $ gem sources -l输出以下内容正常
*** CURRENT SOURCES ***
https://ruby.taobao.org/
错误二:
ERROR: Could not find a valid gem 'cocoapods' (>= 0), here is why:
Unable to download data from https://ruby.taobao.org/ - SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed (https://ruby.taobao.org/specs.4.8.gz)
解决办法:
切换源,不用淘宝的了,用基于腾讯云的:http://gems.ruby-china.org/
输入$ gem sources -l如果输出以下内容证明替换成功:
*** CURRENT SOURCES ***
http://gems.ruby-china.org/
4.安装 CocoaPods
$ sudo gem install cocoapods
$ pod setup
备注:苹果系统升级 OS X EL Capitan 后安装改为:
$ sudo gem install -n /usr/local/bin cocoapods*
$ pod setup
5.如果ruby源旧的话可以更新一下 gem
$ sudo gem update --system
如果能顺利执行完上边的操作就证明你cocoapods安装成功了。
二、常见问题及解决办法:
有时候在执行 sudo gem install cocoa pods这一句命令的时候会出现以下错误:
ERROR: installing cocoapods :acyivesupport requires Ruby version >=2.2.2
出现着中错误的原因是因为:你的Ruby环境需要升级更新,从提示中可以看出你的Ruby环境的版本必须是Ruby version >=2.2.2版本的,而目前使用的Ruby版本是Mac系统自带的1.8.7。所以需要对Ruby进行升级。
升级Ruby环境的方法应该有好几种,这里我选择的是使用RVM baby 版本管理器进行Ruby环境升级。
(一)、安装 RVM 版本管理器
RVM:Ruby Version Manager,Ruby版本管理器,包括Ruby的版本管理和Gem库管理(gemset)
- 终端中输入:
$ curl -L get.rvm.io | bash -s stable
安装完成 出现下面提示:
In case of problems: https://rvm.io/helpandhttps://twitter.com/rvm_io
2、继续在终端输入:
(1)、$source ~/.bashrc
(2)、$source ~/.bash_profile (上边执行完在输入这一句)
3、 测试是否安装正常终端中执行
$rvm -v
/*********************/出现以下提示/****************/
rvm 1.27.0 (latest) by Wayne E. Seguin wayneeseguin@gmail.com, Michal Papis mpapis@gmail.com [https://rvm.io/]
(二)、使用RVM 版本管理器升级Ruby
(1)、查看当前ruby版本
执行: $ruby -v
(2)、列出已知的Ruby版本
执行:$rvm list known*
/*********************/出现以下提示/****************/
MRI Rubies
[ruby-]1.8.6[-p420]
[ruby-]1.8.7[-head] # security released on head
[ruby-]1.9.1[-p431]
[ruby-]1.9.2[-p330]
[ruby-]1.9.3[-p551]
[ruby-]2.0.0[-p648]
[ruby-]2.1[.8]
[ruby-]2.2[.4]
[ruby-]2.3[.0]
[ruby-]2.2-head
ruby-head
for forks use: rvm install ruby-head-<name> --url https://github.com/github/ruby.git --branch 2.2
JRuby
jruby-1.6[.8]
jruby-1.7[.23]
jruby[-9.0.5.0]
jruby-head
Rubinius
rbx-1[.4.3]
rbx-2.3[.0]
rbx-2.4[.1]
rbx[-2.5.8]
rbx-head
Opal
opal
Minimalistic ruby implementation - ISO 30170:2012
mruby[-head]
Ruby Enterprise Edition
ree-1.8.6
ree[-1.8.7][-2012.02]
GoRuby
goruby
Topaz
topaz
MagLev
maglev[-head]
maglev-1.0.0
Mac OS X Snow Leopard Or Newer
macruby-0.10
macruby-0.11
macruby[-0.12]
macruby-nightly
macruby-head
IronRuby
ironruby[-1.1.3]
ironruby-head
(3)、安装ruby 2.2.2
这里如果直接执行$rvm install 2.2.2的话可能还会有问题,所以为了保险起见可以在执行$rvm install 2.2.2之前先执行一下$rvm autolibs disable命令可能就不会有问题了
备注:
如果还有报错话可以试试以下方法:
/(1)清理原来brew/
rm -rf /usr/local/Cellar /usr/local/.git && brew cleanup
/(2)安装/
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
/(3) 检查有无问题/
brew doctor
brew解决后,重新执行$rvm install ruby-2.2命令
/如果又出现以下提示**/
Already installed ruby-2.2.4.
To reinstall use:
rvm reinstall ruby-2.2.4
可以试一试将$rvm install ruby-2.2换成$rvm reinstall ruby-2.2.4,
这下应该就好了然后就可以继续去安装cocoapods了。
(4)、执行完之后执行
ruby -v
/*********************/出现以下提示/****************/
ruby 2.2.2p95 (2015-04-13 revision 50295) [x86_64-darwin14]
(5)、继续安装 CocoaPods执行以下命令
sudo gem install cocoa pods
pod setup
备注:苹果系统升级 OS X EL Capitan 后安装改为:
sudo gem install -n /usr/local/bin cocoapods
pod setup
/*********************/出现以下提示/****************/
setting up cocoaPods master repo(这里可能需要花费一些时间,所以耐心等待)
/*********************/安装成功提示/****************/
Done installing documentation for nap, fourflusher, escape, colored, concurrent-ruby, thread_safe, tzinfo, i18n, activesupport, claide, xcodeproj, molinillo, cocoapods-try, netrc, cocoapods-trunk, cocoapods-stats, cocoapods-search, cocoapods-plugins, cocoapods-downloader, cocoapods-deintegrate, fuzzy_match, cocoapods-core, cocoapods after 21 seconds
23 gems installed
如果你出现上边的安装成功提示的话,那么恭喜你表明你已经安装成功了,但是有时候可能明明安装成功了还是会报错(嘿嘿...具体报什么错误给忘了,但是有可能是因为后边所说的原因),由于通常情况下我们使用cocoaPods创建出来的podfile文件是通过文本编辑器打开的,所以如果报错的小伙伴你可以试试以下解决方案。
Snip20160820_1.png
网友评论