CocoaPods问题总结

前言

在微博上看到，Ruby的淘宝镜像源停止更新了，所以现在使用CocoaPods的同学，都请更新到Ruby China社区网站下的镜像源，具体方法请参考Ruby-China.

---

CocoaPods安装问题

1.安装命令发生变化

OS X 10.11以前，在终端输入以下命令安装CocoaPods：

sudo gem install cocoapods

OS X 10.11以后，如果继续使用上面的命令，终端会提示如下错误

1

解决办法换成了在终端输入以下命令：

sudo gem install -n /usr/local/bin cocoapods

2.

安装CocoaPods之前，需要将RubyGems 升级到最新版本，不然有可能导致配置CocoaPods失败。

sudo gem update --system

最新的sudo gem update -n /usr/local/bin --system

CocoaPods使用问题

初始化pod的时候，在终端中输入了下面的命令

  pod setup

出现了下面截图的错误

2

网上关于这个问题的解答有以下几种：

1.第一种是说gem的版本太低，但是我出现这个问题的时候，已经将RubyGems升级到了最新版本，所以这种办法可能在个别情况下是可以解决上面的那个问题的。
2.第二种原因是网络问题，断网后重连，有多数出现上述问题的原因是因为网络问题，建议你多尝试几次。下面截图出现的情况，就是因为网络原因。

屏幕快照 2016-10-28 下午4.02.34.png

3.打开终端，cd到 ~/.cocoapods/repos该文件夹目录下，然后输入下列命令

 git clone https://github.com/CocoaPods/Specs.g

其实pod setup命令的作用和上面的命令作用一样，都是在github上克隆一个CocoaPods的Specs的分支。
右击Finder前往文件夹，输入地址~/.cocoapods/repos，如果克隆成功或者pod setup命令成功，那么repos目录下会有一个子集目录master，master下有一个Specs文件夹，你打开后发现所有可以pod install的第三方库都可以在Specs文件夹下找到，每个迭代版本打开后是一个json格式的文件。这就是一个本地仓库版的CocoaPods目录。你在AppStore上下载一个JSONModel的软件，可以打开查看这些json文件。比如著名的代码布局库Masonry,如下图所示

Masonry

可以看到这个json文件，包含了Masonry这个库的基本信息，连作者信息都有。你感兴趣的话，可以查看你常用的第三方库的信息。

还有一个方法，我建议直接将CocoaPods卸载后重新安装，这个方法我试了很有用，而且也不麻烦。执行下面的命令即可

 sudo gem uninstall cocoapods 卸载pod

 sudo gem install -n /usr/local/bin cocoapods 重新安装

 sudo pod setup  配置pod

出现下面的内容，表示配置成功了

3

2.在CornerStone上checkout 了新的项目，打开项目发现pods目录不存在。

打开终端，cd到项目的文件目录，输入下列的命令

 pod install --verbose --no-repo-update
 pod update --verbose --no-repo-update

使用上面的命令，而不是直接使用pod install，可以省略升级CocoaPods的specs仓库，这样速度就会提升不少。

3.pod 命令运行报下面错误

4

出现这个错误，是因为你使用了文件编辑去修改Podfile文件，建议你直接在终端中使用下面的命令修改Podflie文件

vim Podfile

并且现在编辑Podfile文件，一定要注意格式

  platform :ios,'7.0'   （可以使用的最低的iOS系统版本）
  target '项目的target名称' do （不同的target可以指定不同的依赖库）
  pod 'AFNetworking', '2.0'  （指定第三方库的版本号，也可以不指定版本，每次都获取最新版本）
  pod 'SDWebImage', '3.7'
  ...
  end     

4.需要克隆到本地的CocoaPods的specs文件太大了，超出了git的限制

5

解决办法如下：

git config http.postBuffer 524288000
git config --list
pod setup 最后重新执行该命令

5.Ruby版本的问题

有人说Ruby版本必须是2.2.2以上才行，可我的另一台电脑，同样是重新配置CocoaPods，我的ruby版本是2.0.0，但是并没有出现Ruby版本过低的错误。这里也顺便请教一下大家，能不能帮我答疑解惑一下。

Rubygems

6.cocoapods本地的仓库没有更新

截图

解决方案：

$ sudo rm -rf ~/.cocoapods/repos/master

$ pod setup

---

还有很多有关配置和使用CocoaPods的问题，下面的博客都有说明或解决办法，许多办法都是相同的，就不一一说明了，你可以参考下
CocoaPods的安装使用和常见问题
cocoapods:常见错误总结