一. 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 现在应该是最新的1.1.1版本了
二. CocoaPods的安装
1. 替换ruby源
CocoaPods是基于ruby ecosystem的,需要ruby环境,使用ruby的gem命令。所以我们的系统要有ruby环境。然而Mac系统默认会安装好ruby环境。可在终端ruby -v
查看ruby版本:
//查看ruby版本ruby -v//输出信息ruby 2.0.0p648 (2015-12-16 revision 53162) [universal.x86_64-darwin15]
查看ruby源
gem sources -l
默认情况下,终端会显示下面:
*** CURRENT SOURCES ***https://rubygems.org/
当然这个源在墙内是访问不到的,所以要更换到ruby-china的镜像
// 1.移除掉原有的源
gem sources --remove https://rubygems.org
///2.淘宝的源已经不更新维护了,现在使用ruby-china的源
gem source -a https://gems.ruby-china.org
以下命令添加淘宝的源:(不建议继续使用)
gem sources -a https://ruby.taobao.org
/// 3.验证是否替换成功
gem sources -l
如果显示下面输出就说明正确:
*** CURRENT SOURCES ***https://gems.ruby-china.org
2. 更新升级 Gem 版本
Gem是管理Ruby库和程序的标准包,如果它的版本过低也可能导致安装失败,解决方案自然是升级Gem,执行下述命令即可:
// 更新升级gem,国内需要切换源sudo gem update --system
查看gem版本
gem -v2.6.8
3. 安装CocoaPods
OS X 10.11 以前安装命令为:
sudo gem install cocoapods// 安装cocoapods
Mac系统为OS X EL Capitan安装命令为:
//安装最新版本
sudo gem install -n /usr/local/bin cocoa pods
//安装指定版本
sudo gem install -n /usr/local/bin cocoapods -v 1.0.0
//安装最新的release beta版本
sudo gem install -n /usr/local/bin cocoapods --pre
如果你想卸载CocoaPods怎么办?看下面:
//卸载CocoaPodssudo
gem uninstall cocoapods
4. 更新Podspec索引文件
如果按照上面3个步骤没问题,用命令pod --version 查看是否安装成功,如果成功会显示pod的版本。
- 但是 会出现如下问题
ERROR: SSL verification error at depth 1: unable to get local issuer certificate (20)
ERROR: You must add /C=IL/O=StartCom Ltd./OU=Secure Digital Certificate Signing/CN=StartCom Certification Authority to your local trusted store
ERROR: SSL verification error at depth 2: self signed certificate in certificate chain (19)
ERROR: Root certificate is not trusted (/C=US/O=GeoTrust Inc./CN=GeoTrust Global CA)
出现这个问题的原因主要是Ruby环境需要2.2版本以上,所以要更新Ruby环境。
更新Ruby环境
//首先安装Homebrew 终端输入这条命令
/usr/bin/ruby -e "$(curl -fsSl https://raw.githubusercontent.com/Homebrew/install/master/install)"
//安装rvm
curl -Lget.rvm.io | bash -s stable
//装载rvm
source ~/.rvm/scripts/rvm
//安装2.3.0版本ruby
rvm install 2.3.0
//将2.3.0设为默认
rvm use 2.3.0 --default
这样就解决了上面的error
如果按照上面3个步骤没问题,用命令pod --version 查看是否安装成功,如果成功会显示pod的版本。
pod setup作用:将所有第三方的Podspec索引文件更新到本地的~/.cocoapods/repos
目录下
pod安装成功之后一个首先的操作就是执行命令(不是必须的):
pod setup
所有的第三方开源库的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 索引库的镜像了。
由于网络原因,,有时候会出现连接超时,,多试几次 就会好了
如果一直卡在 Setting up CocoaPods master repo
可以进去目录~/.cocoapods/repos
使用命令du -sh 查看文件大小 如下图所示 就耐心等待
你妹的 ,最后竟然 940M 我都服了 但是repos 文件的大小是500多M 不管了 反正下载完事了
三. CocoaPods的使用
//cd进入项目的根目录
//会生成模板的Podfile文件
pod init
然后添加 例如下面的库
pod 'AFNetworking'
pod 'JYCarousel', '0.0.1'
pod 'WCJCache', :git => "http://gitlab.9ijx.com/iOS/WCJCache.git"
最后 pod install 安装
关于Podfile.lock
的文件
执行pod install
之后,CocoaPods会生成一个名为Podfile.lock
的文件。并锁定当前各依赖库的版本,之后如果多次执行pod install
或者团队中的其它人check下来这份包含Podfile.lock
文件的工程后再执行pod install
命令时,获取下来的Pods依赖库的版本就和最开始用户获取到的版本一致。如果没有Podfile.lock
文件,执行pod install
命令会获取第三方库的最新版本,这就有可能造成同一个团队使用的依赖库版本不一致,这对团队协作的危害无疑是灾难性的!在这种情况下,如果团队想使用当前最新版本的依赖库,有两种方案可修改Podfile.lock
的纪录:
更改Podfile
中各依赖库的版本
执行pod update
命令
鉴于Podfile.lock
文件对团队协作如此重要,我们应该将它添加到版本控制里。
点击前往CocoaPods官网查看对Podfile.lock
的介绍。