安装 Ruby 环境

• 检查是否已经安装ruby

安装CocoaPods需要ruby环境，因此我们需要先安装ruby环境。

Mac一般都已经装好了ruby环境。

如果不确定，我们可以通过ruby -v检查是否拥有ruby环境

$ ruby -vruby 2.3.3p222 (2016-11-21 revision 56859) [universal.x86_64-darwin17]复制代码

上面显示的内容，表示着我们已经安装了ruby。

• 优化访问速度

绝大多数人在执行安装cocoapods后，会发现半天没有反应，没错，你猜的没错，正是因为那堵至高无上的墙~

因此我们通过下面的方式换个ruby源：

// 移除现有sources$ gem sources --remove https://rubygems.org/// 添加ruby-china sources$ gem sources --add https://gems.ruby-china.com/// 检查ruby源是否更换成功$ gem sources -l*** CURRENT SOURCES ***https://gems.ruby-china.com/复制代码

当终端显示出上面的https://gems.ruby-china.com/，代表我们操作成功。

安装cocoapods

安装cocoapods简单只需要执行下面的代码即可。

// 安装 cocoapods$ sudo gem install cocoapods复制代码

常见坑点

• 依赖的环境版本过低

ERROR:While executing gem ... (Gem::DependencyError)Unable to resolve dependencies: cocoapods requires cocoapods-core (= 1.2.0), cocoapods-downloader (< 2.0, >= 1.1.3), cocoapods-trunk (< 2.0, >= 1.1.2), molinillo (~> 0.5.5), xcodeproj (< 2.0, >= 1.4.1); activesupport requires thread_safe (>= 0.3.4, ~> 0.3); tzinfo requires thread_safe (~> 0.1)复制代码

更新Ruby环境即可

// 更新 gem版本$ sudo gem update --system复制代码

当你看到RubyGems system software updated，意味着环境成功更新

• 没有权限安装cocoapods

苹果系统升级OS X EL Capitan后，使用sudo gem install cocoapods安装时，会发生下面错误

ERROR:While executing gem ... (Errno::EPERM)Operation not permitted - /usr/bin/xcodeproj复制代码

使用下面的代码进行安装

sudo gem install -n /usr/local/bin cocoapods复制代码

• pod setup耗时太久，不知道进度

界面长时间卡在Creating search index for spec repo 'master'..过程，可以通过下面代码查看进度：

du-sh ~/.cocoaPods复制代码

• 搜索类库失败

搜索类库失败时可以尝试通过下面的命令删除本地缓存

rm ~/Library/Caches/CocoaPods/search_index.json复制代码

• 不更新索引库，直接进行安装

想安装某个 pod 库，又不想更新索引

pod install --no-repo-update复制代码

title: 【iOS】CocoaPods安装及错误处理办法

author: zhangpeng

date: 2018.05.24

GitHub: