这两年因为升级系统、更换电脑,帮助同事等前前后后安了4次CocoaPods,整理了一下CocoaPods的安装流程及过程中遇到的一些坑,算是比较全面,覆盖了所有可能碰到的问题。(taobao Gems 源已停止维护，现由 ruby-china 提供镜像服务.)

CocoaPods是什么?

CocoaPods 是开发 OS X 和 iOS 应用程序的一个第三方库的依赖管理工具。利用 CocoaPods，可以定义自己的依赖关系 (称作 pods)，并且随着时间的变化，以及在整个开发环境中对第三方库的版本管理非常方便。 CocoaPods 背后的理念主要体现在两个方面。 首先，在工程中引入第三方代码会涉及到许多内容。对开发者来说，工程文件的配置会让人很沮丧。在配置 build phases 和 linker flags 过程中，会引起许多人为因素的错误。CocoaPods 简化了这一切，它能够自动配置编译选项。 通过 CocoaPods，可以很方便的查找到新的第三方库。 CocoaPods是用 Ruby 写的，想要使用它首先要有Ruby环境. RubyGems简称gems,是一个用于对Ruby组件进行打包的Ruby打包系统

一. 流程

第一步：安装rvm

不管需不需要升级ruby，rvm可以让你拥有多个版本的Ruby，并且可以在多个版本之间自由切换。如果已经安装过跳到第2步（rvm -v 查看是否安装）

$ curl -L get.rvm.io | bash -s stable//需要等一会$ source ~/.bashrc$ source ~/.bash_profile复制代码

等待终端加载完毕,后输入

rvm -v复制代码

如果能显示版本好则安装成功了。

第二步：安装ruby

CocoaPods目前安装需要Ruby的版本大于2.2.2,不然会报错：Error installing pods: activesupport requires Ruby version >= 2.2.2。目前Mac系统默认自带是2.0，所以需要升级。

查看已安装的ruby:

rvm list//ruby -v  //也可以查看ruby版本复制代码

如果已安装版本大于2.2.2，直接到第3步。

//列出ruby可安装的版本信息

rvm list knownrvm install 2.2.2  //安装一个ruby版本复制代码

这里一定要设置为默认版本

rvm use 2.2.2 --default复制代码

第三步：更换源

我们需要来修改更换源（由于国内被墙）所以要把源切换至 ruby-china 在终端执行以下命令

网上文章大都是这面这种：

$ sudo gem update --system$ gem sources --remove https://rubygems.org/复制代码

等有反应之后再敲入以下命令

$ gem sources -a https://ruby.taobao.org/复制代码

这里是个大坑：会报错 _connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed (https://ruby.taobao.org/specs.4.8.gz) 这是因为taobao Gems 源已停止维护，现由 ruby-china 提供镜像服务，正确的操作是：

$ sudo gem update --system$ gem sources --remove https://rubygems.org/$ gem sources --remove https://ruby.taobao.org/       //如果安装了淘宝的镜像复制代码

等有反应之后再敲入以下命令

gem sources -a https://gems.ruby-china.org/复制代码

为了验证你的Ruby镜像是并且仅是ruby-china，可以用以下命令查看：

$ gem sources -l复制代码

只有在终端中出现下面文字才表明你上面的命令是成功的：

*** CURRENT SOURCES ***https://gems.ruby-china.org/复制代码

确保只有 gems.ruby-china.org

第四步：安装CocoaPods

sudo gem install -n /usr/local/bin cocoapods(苹果系统 OS X EL Capitan 前为sudo gem install cocoapods)复制代码

看看这样就成功了

Fetching: nap-1.1.0.gem (100%)Successfully installed nap-1.1.0Fetching: fourflusher-0.3.2.gem (100%)Successfully installed fourflusher-0.3.2...Parsing documentation for cocoapods-1.0.1Installing ri documentation for cocoapods-1.0.1Done 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 146 seconds23 gems installed复制代码

再加一句，完美解决

sudo xcode-select --switch/Applications/Xcode.app复制代码

在终端中输入如下命令来完成安装：

pod setup复制代码

它需要一点时间来完成，你等就是了

如果安装失败 ~/.cocoapods 里面是空的，就需要重新setup

命令如下：

pod repo remove masterpod setup复制代码

完毕之后这个文件夹大概有 100多M，需要花费比较多时间，请耐心等待。

到这里你已经成功安装了CocoaPods

终极办法：把你已经装好了cocoaPods同时~/.cocoapods目录下的repo目录拷贝下来，放进自己的目录里。再  pod setup

为了确定CocoaPods是否可以使用，可以用CocoaPods的搜索功能验证一下。在终端中输入：

$ pod search AFNetworking复制代码

过一段时间之后（可能会比较久），你会在终端中看到一些红色的错误信息，Setting up CocoaPods master repo如下：

Setting up CocoaPods master repo[!] /usr/bin/[Git](http://lib.csdn.net/base/28)clone 'https://github.com/CocoaPods/Specs.git' master --depth=1Cloning into 'master'...error: RPC failed; result=52, HTTP code = 0fatal: The remote end hung up unexpectedly复制代码

这说明CocoaPods还不能正常使用，需要更新pod，下载它的一些依赖包；在终端中输入：

$ pod setup复制代码

过一段时间之后，你会在终端中看到跟上面同样的红色的错误信息。

敲入以上命令时，我终端上是这个样子的（由于太长，仅截取前面一部分）：

这说明某些环境原因导致pod更新不了，可能原因有，1）gem版本太低；2）github无法链接；3）.cocoapods目录下的配置信息错误。我们可以一个一个来排除，

首先更新gem到最新版本，在终端中输入：

$ sudo gem update --system复制代码

然后检查是否可以ping通github，在终端中输入：

$ ping github.com复制代码

然后查看pob repo list：

$ pod repo list复制代码

cd 到该目录里，用du -sh *命令来查看文件大小 cd ~/.cocoapods 进入cocoapods文件后在终端输入：du -sh * 结果显示0 repos，说明没有安装成功； 在终端输入： 删除.cocoapods目录，重新下载pod更新：

$ cd ~/.cocoapods/$ sudo -rm -rf ~/.cocoapods/复制代码

重新执行pod setup，过一段时间后提示setup completed,在终端中输入 pod list，展示出安装列表；

敲入以上命令时，小编终端上是这个样子的（由于太长，仅截取前面一部分）：

如果还是报错unable to access 'https://github.com/CocoaPods/Specs.git/': SSLRead() return error -9806 遇到这种问题的话，可以手动去克隆一份到repos目录下面。

1.通过finder的前往文件夹进行查看       ~/.cocoapods/repos2.通过终端，进入到   ~/.cocoapods/repos3.然后通过   git clone https://github.com/CocoaPods/Specs.git复制代码

可怜的你发现，速度真是慢啊，你等不了，还有一个解决方法

直接打开仓库链接，下载下来拷贝到相应的文件夹复制代码

可怜的你还是发现，下载速度也很慢啊，这里还有一个解决方案

终极解决方案，找一台工作正常的电脑，到他的~/.cocoapods/repos目录下面拷贝出master文件到自己的Mac上的相应位置复制代码

好了，现在我们重新检测一下是否能正常运行。 如果又报错：[!] Unable to find a pod with name, author, summary, or descriptionmatching 'AFNetworking' 重置下json文件

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

看到这里，你心里会不会说，我靠！太爽了，终于下载并且安装好了！接下来看下如何使用吧。。

关于vim命令 比如打开_config.yml文件:vim _config.yml 先按ESC键，然后敲：，这是才可以敲命令，比如强行退出可以敲 q! ，如果需要保存退出就敲 x 或者 wq . vim命令合集: http://www.cnblogs.com/softwaretesting/archive/2011/07/12/2104435.html

我们先创建这个神奇的PodFile。在终端中进入（cd命令）你项目所在目录，然后在当前目录下，利用vim创建Podfile，运行：

$ vim Podfile复制代码

或者

$ touch Podfile复制代码

然后在Podfile文件中输入以下文字：

需要注意的是podfile里面输入的格式变了。

platform :ios, '8.0'#use_frameworks!个别需要用到它，比如reactiveCocoatarget '你的项目名称' dopod 'AFNetworking', '~> 3.1.0'end复制代码

然后保存退出。vim环境下，保存退出命令是：

:wq复制代码

这时候，你会发现你的项目目录中，出现一个名字为Podfile的文件，而且文件内容就是你刚刚输入的内容。注意，Podfile文件应该和你的工程文件.xcodeproj在同一个目录下。

这时候，你就可以利用CocoPods下载AFNetworking类库了。还是在终端中的当前项目目录下，运行以下命令：

$ pod install复制代码

使用下面的命令会更快

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

注意最后一句话，意思是：以后打开项目就用 CocoaPodsDemo.xcworkspace 打开，而不是之前的.xcodeproj文件。否则无法关联pod下来的类库。

#二. 遇到的一些坑 ##Setting up CocoaPods master repo 卡着不动 1、那是因为 淘宝的那个镜像(https://ruby.taobao.org/ )已经不可用了。所以我们现在用最新支持的ruby镜像(https://gems.ruby-china.org/)

需要的命令行：

$ gem sources -r https://rubygems.org/ （移除旧版本的镜像，如果你不知道你电脑上目前用的是什么镜像，可用  $ gem sources -l  来查看）$ gem sources -a https://gems.ruby-china.org/ （增加可用的镜像）$ gem sources -l  （用来检查使用替换镜像位置成功）复制代码

2、当pod setup 进入Setting up CocoaPods master repo 等待的时候表示正在下载了，此时你可通过新开一个终端窗口，输入"cd ~/.cocoapods/"命令行跳到cocoapods文件夹内，执行"du -sh *"查看正在下载的文件夹的大小

3、当出现如下

[!] An error occurred while performing `git pull` on repo `master`.[!] /usr/bin/git pull --ff-only复制代码

这个错误应该是说这个节点有问题。试试把cocoapods的节点删除，重新添加一个节点，或许就行，说干就干：

原因： Cocoapods的分支不支持当前最新的Xcode版本

解决办法: 删除master分支 重新建立新的分支

sudo rm -fr ~/.cocoapods/repos/master然后再: pod setup复制代码

##Cocoapods的安装报错 - （ERROR: Error installing cocoapods: activesupport requires Ruby version >= 2.2） 1.移除现有 Ruby 默认源

$gem sources --remove https://rubygems.org/复制代码

2.使用新的源 淘宝镜像

$gem sources -a https://ruby.taobao.org/复制代码

3.验证新源是否替换成功

$gem sources -l复制代码

成功后提示：

*** CURRENT SOURCES ***https://ruby.taobao.org/复制代码

4.开始安装cocoapods

$sudo gem install cocoapods复制代码

这时候提示：

Fetching: i18n-0.7.0.gem (100%)Successfully installed i18n-0.7.0Fetching: thread_safe-0.3.5.gem (100%)Successfully installed thread_safe-0.3.5Fetching: tzinfo-1.2.2.gem (100%)Successfully installed tzinfo-1.2.2Fetching: minitest-5.9.0.gem (100%)Successfully installed minitest-5.9.0Fetching: concurrent-ruby-1.0.2.gem (100%)Successfully installed concurrent-ruby-1.0.2Fetching: activesupport-5.0.0.gem (100%)ERROR:  Error installing cocoapods:activesupport requires Ruby version >= 2.2.2.复制代码

这个地方很坑，之前安装cocoapods一直是没有这个问题的，这里提示Ruby版本要大于或等于2.2.2 于是查看已安装的ruby版本

$ruby -v复制代码

ruby 2.0.0p648 (2015-12-16 revision 53162) [universal.x86_64-darwin15] 果然这里就要升级ruby版本啦 列出ruby可安装的版本信息：

$rvm list known复制代码

如果提示command not found,说明没安装RVM;否则跳过 安装rvm baby 版本管理器

$curl -L get.rvm.io | bash -s stable复制代码

//等安装完成 出现下面这行提示以下___

In case of problems: https://rvm.io/helpandhttps://twitter.com/rvm_io复制代码

执行

$source ~/.bashrc$source ~/.bash_profile复制代码

测试 RVM baby 版本管理器 是否安装正常

$rvm -v复制代码

//提示以下___

rvm 1.27.0 (latest) by Wayne E. Seguin, Michal Papis[https://rvm.io/]复制代码

用RVM升级Ruby 查看当前已安装ruby版本

$ruby -v$rvm list known复制代码

列出ruby可安装的版本信息

# 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-headruby-head# for forks use: rvm install ruby-head-
    
      --url https://github.com/github/ruby.git --branch 2.2# JRubyjruby-1.6[.8]jruby-1.7[.23]jruby[-9.0.5.0]jruby-head# Rubiniusrbx-1[.4.3]rbx-2.3[.0]rbx-2.4[.1]rbx[-2.5.8]rbx-head# Opalopal# Minimalistic ruby implementation - ISO 30170:2012mruby[-head]# Ruby Enterprise Editionree-1.8.6ree[-1.8.7][-2012.02]# GoRubygoruby# Topaztopaz# MagLevmaglev[-head]maglev-1.0.0# Mac OS X Snow Leopard Or Newermacruby-0.10macruby-0.11macruby[-0.12]macruby-nightlymacruby-head# IronRubyironruby[-1.1.3]ironruby-head复制代码
    

这里我们安装2.2.2:

$rvm install 2.2.2复制代码

终端运行结果：（如果直接成功请绕过homebrew的卸载安装）

Searching for binary rubies, this might take some time.Found remote file https://rvm_io.global.ssl.fastly.net/binaries/osx/10.11/x86_64/ruby-2.2.2.tar.bz2Checking requirements for osx.About to install Homebrew, press `Enter` for default installation in `/usr/local`,type new path if you wish custom Homebrew installation (the path needs to be writable for user):复制代码

回车：

It appears Homebrew is already installed. If your intent is to reinstall youshould do the following before running this installer again:ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/uninstall)"The current contents of /usr/local are .gitRequirements installation failed with status: 1.复制代码

这里执行：

$ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/uninstall)"复制代码

卸载home-brew

Warning: This script will remove:/Library/Caches/Homebrew//usr/local/.git/Are you sure you want to uninstall Homebrew? [y/N] y==> Removing Homebrew installation...==> Removing empty directories...==> Homebrew uninstalled!You may want to restore /usr/local's original permissionssudo chmod 0755 /usr/localsudo chgrp wheel /usr/local复制代码

再执行：

$ rvm install 2.2.2提示：Searching for binary rubies, this might take some time.Found remote file https://rvm_io.global.ssl.fastly.net/binaries/osx/10.11/x86_64/ruby-2.2.2.tar.bz2Checking requirements for osx.About to install Homebrew, press `Enter` for default installation in `/usr/local`,type new path if you wish custom Homebrew installation (the path needs to be writable for user):复制代码

按回车：

==> This script will install:/usr/local/bin/brew/usr/local/Library/.../usr/local/share/doc/homebrew/usr/local/share/man/man1/brew.1/usr/local/share/zsh/site-functions/_brew/usr/local/etc/bash_completion.d/brewPress RETURN to continue or any other key to abort==> /usr/bin/sudo /bin/mkdir /Library/Caches/HomebrewPassword:复制代码

这里需要输入电脑密码：

==> /usr/bin/sudo /bin/chmod g+rwx /Library/Caches/Homebrew==> /usr/bin/sudo /usr/sbin/chown haha /Library/Caches/Homebrew==> Downloading and installing Homebrew...remote: Counting objects: 501, done.remote: Compressing objects: 100% (445/445), done.remote: Total 501 (delta 29), reused 360 (delta 27), pack-reused 0Receiving objects: 100% (501/501), 787.83 KiB | 169.00 KiB/s, done.Resolving deltas: 100% (29/29), done.From https://github.com/Homebrew/brew* [new branch]      master     -> origin/masterHEAD is now at 32f7e73 download_strategy: ensure fixed commit hash length==> Tapping homebrew/coreCloning into '/usr/local/Library/Taps/homebrew/homebrew-core'...remote: Counting objects: 3714, done.remote: Compressing objects: 100% (3598/3598), done.remote: Total 3714 (delta 14), reused 2112 (delta 6), pack-reused 0Receiving objects: 100% (3714/3714), 2.88 MiB | 240.00 KiB/s, done.Resolving deltas: 100% (14/14), done.Checking connectivity... done.Checking out files: 100% (3717/3717), done.Tapped 3591 formulae (3,740 files, 9.0M)==> Installation successful!==> Next stepsRun `brew help` to get startedFurther documentation: https://git.io/brew-docs==> Homebrew has enabled anonymous aggregate user behaviour analyticsRead the analytics documentation (and how to opt-out) here:https://git.io/brew-analyticsInstalling requirements for osx.Updating system.....Installing required packages: autoconf, automake, libtool, pkg-config, libyaml, readline, libksba, openssl........Certificates in '/usr/local/etc/openssl/cert.pem' are already up to date.Requirements installation successful.ruby-2.2.2 - #configureruby-2.2.2 - #download% Total    % Received % Xferd  Average Speed   Time    Time     Time  CurrentDload  Upload   Total   Spent    Left  Speed100 6854k  100 6854k    0     0  61342      0  0:01:54  0:01:54 --:--:--  132kruby-2.2.2 - #validate archive...ruby-2.2.2 - #generating default wrappers........Updating certificates in '/etc/openssl/cert.pem'.mkdir: /etc/openssl: Permission deniedmkdir -p "/etc/openssl" failed, retrying with sudohaha password required for 'mkdir -p /etc/openssl':and sudo mkdir worked复制代码

这样ruby2.2.2就安装好了 现在就可以安装cocoapods啦 (上跳流程第四步)：

##安装ruby遇到" Installing Homebrew - Brew Command Not Found"命令找不到解决方案： Check XCode is installed or not.

$gcc --version$ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"$brew doctor$brew update.复制代码

完成后 执行

$ruby -v复制代码

//–––––打印输出–––––––

ruby 2.2.2p95 (2015-04-13 revision 50295) [x86_64-darwin14]复制代码

##CocoaPods报错：The dependency AFNetworking is not used in any concrete target 在创建Podfile的时候，用这种格式使用

platform :ios, '8.0'#use_frameworks!个别需要用到它，比如reactiveCocoatarget 'MyApp' dopod 'AFNetworking', '~> 2.6'pod 'ORStackView', '~> 3.0'pod 'SwiftyJSON', '~> 2.3'end复制代码

里面的 MyApp 记得替换为自己攻城里面的target。这样就基本OK了，执行pod install / pod update 就都可以了。（use_frameworks! 这个是个别需要的，这里修改一下，可以把我上面的代码中的这一行【删除】） 下面是另外一种写法:

platform :ios, '8.0'#use_frameworks!个别需要用到它，比如reactiveCocoadef podspod 'AFNetworking', '~> 2.6'pod 'ORStackView', '~> 3.0'pod 'SwiftyJSON', '~> 2.3'endtarget 'MyApp' dopodsend复制代码

##运行 sudo gem update --system 终端提示Updating rubygems-update ERROR: While executing gem ... (Errno::EPERM) Operation not permitted - /usr/bin/update_rubygems

Mac OS X 10.11后不能使用sudo gem update --system了 需要替换成：sudo gem update -n /usr/local/bin —system $ sudo gem update -n /usr/local/bin —system 终端提示貌似没有可以更新的内容 Updating installed gems Nothing to update

本文参考: