转载自：https://www.jianshu.com/p/dfe970588f95
前言
前几天发布我的开源库<最简单方便的iOS轮播开源库：JYCarousel>到CocoaPods的时候。对CocoaPods重新学习了一下，之前只是会简单的使用，并没有全面的了解。现在要对它做一个学习记录吧，现在我还是只会简单的使用_，教程只是我夸大的说法（别骂我）。
下面的操作都是经过亲自验证通过的，放心操作！Cocoapods这部分知识一共有三篇博客：
那就跟我一起来学习一下CocoaPods吧
一. CocoaPods的介绍
什么是CocoaPods？CocoaPods是一个负责管理iOS项目中第三方开源库的工具，CocoaPods的项目源码在https://github.com/CocoaPods/Specs上管理。
经过CocoaPods团队的不懈努力，2016年5月10号，CocoaPods终于在其官方博客上宣布正式发布CocoaPods 1.0。与此同时，公开了相应的Mac版App——CocoaPods App 1.0 。
CocoaPods App 1.0 的下载地址：https://cocoapods.org/app
二. CocoaPods的安装
1. 替换ruby源
CocoaPods是基于ruby ecosystem的，需要ruby环境，使用ruby的gem命令。所以我们的系统要有ruby环境。然而Mac系统默认会安装好ruby环境。可在终端ruby -v查看ruby版本：
查看ruby源
默认情况下，终端会显示下面：
当然这个源在墙内是访问不到的,所以要更换到ruby-china的镜像
如果显示下面输出就说明正确：
2. 更新升级 Gem 版本
Gem是管理Ruby库和程序的标准包，如果它的版本过低也可能导致安装失败，解决方案自然是升级Gem，执行下述命令即可:
查看gem版本
3. 安装CocoaPods
OS X 10.11 以前安装命令为：
Mac系统为OS X EL Capitan安装命令为：
如果你想卸载CocoaPods怎么办？看下面：
4. 更新Podspec索引文件
如果按照上面3个步骤没问题，用命令pod --version查看是否安装成功，如果成功会显示pod的版本。
pod setup作用：将所有第三方的Podspec索引文件更新到本地的~/.cocoapods/repos目录下
pod安装成功之后一个首先的操作就是执行命令（不是必须的）：
所有的第三方开源库的Podspec文件都托管在https://github.com/CocoaPods/Specs
我们需要把这个Podspec文件保存到本地，这样才能让我们使用命令pod search 开源库搜索一个开源库，怎样才能把github上的Podspec文件保存本地呢？那就是 pod setup
执行pod setup时，CocoaPods 会将第三方的podspec索引文件更新到本地的~/.cocoapods/repos目录下
如果没有执行过 pod setup，那用户根目录下～找不到.cocoapods/repos目录的，没有创建这个目录。
如果执行 pod setup，并且命令没有执行成功，那么会创建~/.cocoapods/repos目录，只不过目录是空的。
如果执行 pod setup，并且命令执行成功，说明把github上的Podsepc文件更新到本地，那么会创建~/.cocoapods/repos目录，并且repos目录里有一个master目录，这个master目录保存的就是github上所有第三方开源库的Podspec索引文件。
但是第一次执行pod setup时，这个github的Podspec索引文件比较大，有 300M 左右(以后会越来越大的)，所以第一次更新时非常慢.要耐心等待......可以进去目录~/.cocoapods/repos使用命令du -sh *来查看下载文件的大小了
怎么才能快点呢？网上好多给出都是更换索引库的镜像，gitcafe
和oschina， gitcafe已经被coding收购了（2016年3月份左右收购）。这两个我亲测，现在都不行了（可能是我网速不好，基本上就是连接失败，有空网速好点的时候我在测试一下）。所以还是别更换 CocoaPods 索引库的镜像了。
三. CocoaPods的使用
1. 新建 Podfile文件
使用时需要在你的项目根目录下新建一个名为Podfile的文件（文件名一定为Podfile，不能更改），将依赖的库名字依次列在文件中即可.
2. 编辑 Podfile文件
CococaPods升级到1.0.0版本之后，Podfile文件的格式也发生了很大改变
我来带领大家写一个完整的Podfile文件 ,各个选项的解释在文件后面一起解释。
假设我们的项目名称为JYCocoaPodsTest, 为JYCocoaPodsTest新建了一个UITarget。打开JYCocoaPodsTest.xcodeproj结构如下：
JYCocoaPodsTest.xcodeproj结构.png
1. 简单的Podfile：
2. 稍微复杂的Podfile：
3. Podfile的语法解释：
指定了开源库应该被编译在哪个平台以及平台的最低版本。
若不指定平台版本，官方文档里写明各平台默认值为iOS：4.3,OS X：10.6,tvOS：9.0,watchOS：2.0
屏蔽cocoapods库里面的所有警告
这个特性也能在子target里面定义,如果你想屏蔽某pod里面的警告也是可以的:
允许你指定需要链接的工程
指定应该包含所有projects的Xcode workspace.
如果没有显示指定workspace并且在Podfile所在目录只有一个project，那么project的名称会被用作于workspace的名称
默认情况下是没有指定的，当没有指定时，会使用Podfile目录下与target同名的工程：(我们只有一个工程JYCocoaPodsTest)
# JYCocoaPodsTest这个Target只有在JYCocoaPodsTest工程中才会链接
target 'JYCocoaPodsTest' do
project 'JYCocoaPodsTest'
...
end
指定特定Target的依赖库
可以嵌套子Target的依赖库
明确指定继承于父层的所有pod，默认就是继承的
指定specs的位置,自定义添加自己的podspec。公司内部使用
cocoapods 官方source是隐式的需要的，一旦你指定了其他source 你就需要也把官方的指定上
例如：
当我们使用pod install或者pod setup时，会自动在~/.cocoapods/repo目录下更新项目需要的podspec索引文件如下：
本地podspec索引文件.png
4. 依赖库的基本写法：
5. 依赖库的自定义写法
下面都会用到podspec文件，所以要熟悉这个文件的构成才可以.
我会在下一篇博客编辑这个文件
Using the files from a local path (使用本地文件)
From a podspec in the root of a library repository (引用仓库根目录的podspec)
在仓库根目录下加入podsepc文件上传到git上就可以了（比较简单）
需要特别注意的是，虽然这样将会满足任何在Pod中的依赖项通过其他Pods
但是 podspec必须存在于仓库的根目录 中，如果根目录中没有存在这个podspec文件，你将不得不使用下面提到的几种方式之一
From a podspec outside a spec repository, for a library without podspec（在一个不带podsepec的库里引用外部的spec）
如果一个podspec能够从外部的仓库源的获取，设想一下，也通过HTTP来获取podspec:
pod spec
使用一个在给定podspec中声明的Pod的依赖项。如果如果没有参数被传递，那么在Podfile根部的第一个podspec会被使用。它将会被库所在的工程所使用
注意:这个不会包含哪些来自于podspec的资源而仅仅是来自于CocoaPods基础架构
例子:
上面的基本够我们日常使用。如果你还想了解更多。请到CocoaPods官方博客学习：https://guides.cocoapods.org
3. 安装依赖开源库
第二步中我们编辑好的Podfile文件保存好，进入项目根目录执行命令
pod install.png
pod install命令执行成功后，会看到项目根目录下多出xxx.xcworkspace、Podfile.lock文件和Pods目录。再看看刚才执行完pod install命令打印出来的内容的最后一行：From now on use CocoaPodsDemo.xcworkspace.提示我们从现在起，我们需要使用JYCocoaPodsTest.xcworkspace文件来开发。
4. 第三方库更新
跟pod install相似的一个命令就是pod update.
如果未指定特定版本的话,pod update将所有第三方框架更新到最新版本。
5. pod文件和命令说明
会根据Podfile.lock文件中列举的版本号来安装第三方框架
如果一开始Podfile.lock文件不存在, 就会按照Podfile文件列举的版本号来安装第三方框架
安装开源库之前, 默认会执行pod repo update指令
将所有第三方框架更新到最新版本, 并且创建一个新的Podfile.lock文件
安装开源库之前, 默认会执行pod repo update指令
四. CocoaPods相关的两个目录
目录~/.cocoapods/repos/这个目录存储远端的podspec文件到本地。master是所有第三方的pod spec索引文件。其他的使我们自定义的podspec索引文件。
~/.cocoapods/repos/目录.png
目录~/Library/Caches/CocoaPods/这个目录就是缓存文件的存储目录。
~/Library/Caches/CocoaPods/目录.png
如果我们使用pod search xxx 提示没有找到,但是我们这个第三方确实存在。
1.我们可以使用pod setup更新本地pod spec索引文件。然后pod search xxx
2.按照1的方法如果还是pod search xxx找不到，那我们就把~/Library/Caches/CocoaPods/的缓存文件删除。然后pod setup。最后pod search xxx这样应该就可以了
CocoaPods的常见错误：http://blog.csdn.net/wangyanchang21/article/details/51437934
五. CocoaPods的说明
1、第三方库会被编译成.a静态库或者.framwork的动态链接库供我们真正的工程使用。
CocoaPods会将所有的第三方库以target的方式组成一个名为Pods的工程，该工程就放在刚才新生成的Pods目录下。整个第三方库工程会生成一个名称为libPods.a的静态库提供给我们自己的CocoaPodsTest工程使用。
对于资源文件，CocoaPods提供了一个名为Pods-resources.sh的bash脚本，该脚本在每次项目编译的时候都会执行，将第三方库的各种资源文件复制到目标目录中。
2、我们的工程和第三方库所在的工程会由一个新生成的workspace管理
为了方便我们直观的管理工程和第三方库，CocoaPodsTest工程和Pods工程会被以workspace的形式组织和管理，也就是我们刚才看到的JYCocoaPodsTest.xcworkspace文件。
3、原来的工程设置已经被更改了，这时候我们直接打开原来的工程文件去编译就会报错，只能使用新生成的workspace来进行项目管理。
4、CocoaPods通过一个名为Pods.xcconfig的文件来在编译时设置所有的依赖和参数。
六. 总结：
CocoaPods主要还是侧重于使用，网速太慢我亲测的都有点烦躁了。当然理解原理过程更好，我现在还是有很多地方不是很理解。希望共同努力吧。还是多看看官方文档来学习一下不了解的。如果你喜欢就请点个喜欢吧_