- CocoaPods 是什么?
CocoaPods 是开发 OS X 和 iOS 应用程序的一个第三方库的依赖管理工具。利用 CocoaPods,可以定义自己的依赖关系 (称作 pods),并且随着时间的变化,以 及在整个开发环境中对第三方库的版本管理非常方便
- CocoaPods 背后的理念主要体现在两个方面
在工程中引入第三方代码 会涉及到许多内容。针对 Objective-C 初级开发者来说,工程文件的配置会让 人很沮丧
在配置buildphases和linker flags过程中,会引起许多人为因素的 错误
CocoaPods 简化了这一切,它能够自动配置编译选项
- CocoaPods的原理
- 它是将所有的依赖库都放到另一个名为Pods项目中,然后 让主项目依赖Pods项目,这样,源码管理工作都从主项目移到了Pods项目中
- Pods项目最终会编译成一个名为libPods.a的文件,主项目只需要依赖这个.a 文件即可。
- 对于资源文件,CocoaPods提供了一个名为Pods-resources.sh的bash脚本, 该脚本在每次项目编译的时候都会执行,将第三方库的各种资源文件复制到目 标目录中。
- CocoaPods通过一个名为Pods.xcconfig的文件来在编译时设置所有的依赖和 参数。
- CocoaPods安装
-
CocoaPods的安装
安装方式异常简单 , Mac 下都自带 ruby，使用 ruby 的 gem 命令即可下载安装
- 更新gem(如果你的 gem 太老,一般我会选择先更新)
sudo gem update --system - 更新ruby的软件源
ruby 的软件源 https://rubygems.org 因为使用的是亚马逊的云服务，所以被墙了，需要更新一下 ruby 的源，使用如下代码将官方的 ruby 源替换成国内淘宝的源：
- 先移除现有的源
gem sources --remove https://rubygems.org/
- 使用新的源
**gem sources -a https://ruby.taobao.org/ **
- 验证新源是否替换成功
gem sources -l
> 如果上面都做完，说明cocoapods前期配置完毕。。可以使用如下两行语句来安装cocoapods和设置索引仓库了
- sudo gem install cocoapods
- pod setup（网速慢可以先替换索引再执行,如下）
-
替换CocoaPods 的镜像索引<注意>
当第一次执行pod setup时,cocoapods将会下载podspec索引文件到本地目录~/.cocoapods/下,这个索引文件比较大，大概80M左右，更新比较慢..所以在执行pod setup之前最好先替换更新下CocoaPods的镜像索引。
一个叫 akinliu 的朋友在 gitcafe 和 oschina 上建立了 CocoaPods 索引库的镜像，因为 gitcafe 和 oschina 都是国内的服务器，所以在执行索引更新操作时，会快很多,如下操作可以将 CocoaPods 设置成使用 gitcafe 镜像：
+ pod repo remove master
+ pod repo add master http://git.oschina.net/akuandev/Specs.git
+ pod repo update
即可使用 oschina 上的镜像。
- 更新gem(如果你的 gem 太老,一般我会选择先更新)
-
CocoaPods的使用
-
验证是否安装成功
pod --version
> 如果验证成功，显示版本号，如，**0.39.0**，说明可以安装全部完成. > 如果显示**-bash: po: command not found**，说明没有装好-
开始使用
使用时需要新建一个名为 Podfile 的文件，以如下格式，将依赖的库名字依次列在文件中即可
platform :ios
pod 'AFNetworking', '~> 1.4'
'~> 1.4'表示安装三方库版本号，可以不写，默认为索引库中最新版本
- 注意事项
1. 利用CocoPods管理类库后, 以后打开项目就用xxxx.xcworkspace 打开,而不是 之前的.xcodeproj文件
2. 每次更改了Podfile文件,你需要重新执行一次pod update命令。
3. CocoaPods在执行pod install和pod update时,会默认先更新一次CocoPods的 spec仓库索引。使用--no-repo-update参数可以禁止其做索引更新操作
pod install --no-repo-update pod update --no-repo-update
4. 验证框架是否支持cocoaPods
+ 终端指令
pod search MJRefresh
+ https://cocoapods.org,在线搜索验证在线,能搜出说明支持。
5. cocoaPods隐藏目录
> + 前往—>个人—>.cocoapods
> + .cocoapods/repos/master/Specs放着所有第三方库的索引文件，如下图技巧:如果master/Specs下载不成功，试着，手动拷贝这个目录试试
6. cocoaPods插件
> cocoapods-xcode-plugin,cocoapods插件，管理cocoaPods框架.例如,有了这个插件就不用我们手动创建Profile文件了。
-
验证是否安装成功
-
卸载CocoaPods安装
sudo gem uninstall cocoapods
-
回退到指定cocoapods版本(如0.39)
sudo gem install -n /usr/local/bin cocoapods --version 0.39
** cocoaPods遇到问题**
-
查看下载进度
- 还有一点需要注意，
pod setup在执行时，会输出Setting up CocoaPods master repo，但是会等待比较久的时间。这步其实是 Cocoapods 在将它的信息下载到~/.cocoapods目录下，如果你等太久，可以试着 cd 到那个目录，用du -sh *来查看下载进度。
- 还有一点需要注意，
执行sudo gem install cocoapods,如下
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/fuzzy_match
将执行语句替换为sudo gem install -n /usr/local/bin cocoapods
(备注：苹果系统升级 OS X EL Capitan造成)
[!] Your Podfile has had smart quotes sanitised. To avoid issues in the future, you should not use TextEdit for editing it. If you are not using TextEdit, you should turn off smart quotes in your editor of choice.
查看Podfile文件内容是否编写语法有误！
