CocoaPods使用问题总结

如何安装Cocoapods

更改Cocoapods的源

因为在国内资源被墙，所以需要切换源。目前使用的是ruby-china提供的镜像。

gem sources --remove https://rubygems.org/  gem sources -a https://gems.ruby-china.org/

安装完之后进行查看源，检查是否安装正确

gem source -l  // *** CURRENT SOURCES ***//https://gems.ruby-china.org/

安装Cocoapods

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

配置pod

pod setup

安装完成。

如何安装指定版本的Cocoapods？

问题描述：

我们在使用 Cocoapods的工程中进行协同开发的时候，避免不了对 podfile文件的更改，当 podfile文件发生改变的时候，对应的 pofile.lock也会发生更改。当然团队在开发过程中也不希望每次拉一次代码就执行以下 pod install命令。正因为 podfile以及 podfile.lock的改变，我们才需要去执行 pod install或者 pod update命令。 podfile文件的更改，我们开发中可以控制，但是如果团队开发者 Cocoapods版本不一致的时候。每更改一次都需要执行 pod install或者 pod update命令。如果成员都不对 podfile文件做更改，并且Cocoapods版本都一致的时候，每次进行代码提交以及代码拉取的时候都不需要执行pod 更新的命令，那么，如果版本不一致怎么办呢？统一版本呗。

解决方案：

Cocoapods版本的更新这里分两种情况：

Case1：当前安装的 Cocoapods版本比目标版本低但是目标版本又不是最新的，不能够直接用更新命令(因为这样会更新到最新版本)。这个时候我们要怎么做呢？

假设当前 Cocoapods版本为 1.5.0,目标版本为 1.5.2。

这个时候需要执行命令：

sudo gem install cocoapods --version 1.5.2

Case2：当前安装的 Cocoapods版本比目标版本高，这个时候我们不能按照Case1的做法，因为这个时候执行的只是安装版本1.5.2,版本1.5.3还在。cocoapods在使用的时候默认的就是最高版本的cocoapods。那么，我们应该怎么做呢？

* 首先是卸载高版本 Cocoapods。查找当前环境安装的cocoapods版本可以使用命令 gem list。此时控制台打印的可能为：

cocoapods (1.5.3,1.5.0, 1.3.1, 1.1.1)  cocoapods-core (1.5.3,1.5.0, 1.3.1, 1.1.1)  cocoapods-deintegrate (1.0.2, 1.0.1)  cocoapods-downloader (1.2.0, 1.1.3)  cocoapods-plugins (1.0.0)  cocoapods-search (1.0.0)  cocoapods-stats (1.0.0)  cocoapods-trunk (1.3.0, 1.2.0)  cocoapods-try (1.1.0)

1.5.2才是我们的目标版本。1.5.3是最新的版本，我们需要把它卸载掉。命令如下：

sudo gem uninstall cocoapods -v 1.5.3  sudo gem uninstall  cocoapods-core -v 1.5.3

注意：这里必须把cocoapods和cocoapods-core都卸载掉。

• 其次是安装指定版本。命令和Case1的命令一样。 sudo gem install cocoapods --version 1.5.2

  这样，我们就安装了指定版本的 cocoapods。

总结一下：

1. 当前版本比目标版本低的时候，直接安装指定版本的 cocoapods。

sudo gem install cocoapods --version 目标版本

1. 当前版本比目标版本高的时候

   分两步：

卸载当前版本：

sudo gem uninstall cocoapods -v 当前版本  sudo gem uninstall  cocoapods-core -v 当前版本

安装指定版本：

sudo gem install cocoapods --version 目标版本

Swift引用报错的问题

问题描述:

当我们使用 cocoapods安装一个第三方的时候，安装成功以后，在引用第三方头文件的时候可能会报错，报错信息的大概意思是找不到这个头文件( "Cannot load underlying module for 'SnapKit'"类似这样的语句 )。

解决方案：

com+b(把工程编译一下就行了)

// Xcode编译器在第一次使用cocoapods的时候。提示不是很友好，编译一下就好了。

pod search 不到或者搜索到的第三方库版本太低

问题描述：

我们在组件化的时候，组件组的同事提交了最新版本的本地库，然而你搜索到的还是历史版本的，不能使用最新的代码，怎么办？

解决方案：

这是因为本地pod的索引没有及时进行同步。命令行执行：

pod repo update

更新完本地索引之后，就可以search到最新版本的库了。如果这种方法不行的话，那么试试删除~/Library/Caches/CocoaPods目录下的search_index.json文件

• pod setup成功后，依然不能pod search，是因为之前你执行pod search生成了search_index.json，此时需要删掉。
• 终端输入：rm ~/Library/Caches/CocoaPods/search_index.json
• 删除成功后，再执行pod search。

此时终端输入： pod search SKDispatcher(不区分大小写)

输出： Creating search index for spec repo 'master'.. Done!，稍等片刻······就会出现所有带有SKDispatcher字段的类库。