一.CocoaPods是什么?
CocoaPods是一个负责管理iOS项目中第三方开源库的工具。CocoaPods的项目源码在Github上管理。该项目开始于2011年8月12日,在这两年多的时间里,它持续保持活跃更新。开发iOS项目不可避免地要使用第三方开源库,CocoaPods的出现使得我们可以节省设置和更新第三方开源库的时间,在iOS开发中经常会用到第三方库如AFNetworking,ASIHttpRequest等,在使用第三方库时,你除了要导数源码外,但是,集成这些依赖库需要我们手动去配置,还有当这些第三方库发生了更新,还需要手动去更新项目。这就显得非常麻烦。有麻烦自然有解决办法,CocoaPods就是为了解决这个问题而生的。通过CocoaPods,我们可以将第三方的依赖库统一管理起来,配置和更新只需要通过简单的几行命令即可完成。
二.CocoaPods的下载及安装
mac系统已经默认安装好Ruby环境,如果你不确定自己系统中是否有Ruby的,可以在终端中输入命令行:ruby -v查看当前ruby版本。如图:
确定以后,接下来就可以下载和安装CocoaPods,只需要一行命令。在Terminator(也就是终端)中输入以下命令:
sudo gem install cocoa pods
但是,在终端中敲入这个命令之后,会发现半天没有任何反应。原因是那堵墙阻挡了cocoapods.org。
首先,检查你的ruby源:
$gem sources -l
默认情况下,终端应该返回如下信息:
*** CURRENT SOURCES ***
https://rubygems.org/
当然这个源在墙内是访问不到的。因此我们需要寻找一个可以在国内访问到的镜像。目前笔者找到的是https://gems.ruby-china.org/这个镜像,淘宝的镜像已经不能用了。
确认镜像可用后,现在就要开始修改ruby源了。首先执行以下命令删除原来的ruby源:
$gem sources --remove https://rubygems.org/
执行命令后可在终端看见以下信息:
https://rubygems.org/ removed from sources
然后下一步添加你找到的可用的镜像源:
$gem sources -a https://gems.ruby-china.org/
此时如果你再执行gem sources -l命令,就能看到当前镜像源里只有https://gems.ruby-china.org/ 这一个了。此时你就可以重新执行这一段开头的那句命令了:
$sudo gem install cocoa pods
如果一切正常,你应该能看到一段安装进度,以及最后有一条信息:
3 gems installed
确认看见这条信息,后先判断的CocoaPods是否可以使用,可以用CocoaPods的搜索功能验证一下。在终端中输入:
pod search AFNetworking;
执行后可能会一直停在
Setting up CocoaPods master repo然后(很久)会出现如下错误:
解决办法是:
这说明CocoaPods还不能正常使用,需要更新pod,下载它的一些依赖包;在终端中输入:
$ pod setup
过一段时间之后,你会在终端中看到跟上面同样的红色的错误信息。
这说明某些环境原因导致pod更新不了,可能原因有,1)gem版本太低;2)github无法链接;3).cocoapods目录下的配置信息错误。我们可以一个一个来排除,
首先更新gem到最新版本,在终端中输入:
$ sudo gem update --system
然后检查是否可以ping通github,在终端中输入:
$ ping github.com
然后查看pob repo list:
$ pod repo list
说明Cocoapods在将它的信息下载到 ~/.cocoapods里;
cd 到该目录里,用du -sh *命令来查看文件大小,结果显示0 repos,说明没有安装成功;
在终端输入:
cd ~/.cocoapods
进入cocoapods文件后在终端输入:**du -sh ***
重新执行pod setup,过一段时间后提示setup completed,在终端中输入 pod list,展示出安装列表;
这样总算安装好了。接下来再一次输入:
pod search AFNetworking
输入过后它可能会报:
[!] Unable to find a pod with name, author, summary, or descriptionmatching `AFNetworking`
解决方案是:
输入:
rm ~/Library/Caches/CocoaPods/search_index.json
后在一次输入:
pod search AFNetworking
就可以咯。
三. cocoapods的使用
首先来到你的项目文件:
cd 项目文件的位置
然后,添加一个Podfile文件: vim Podfile
然后按i进入插入模式,进行编辑,在文件中输入以下内容:
注意百度上很多旧版本输入的类容:
platform :ios, '8.1'pod 'AFNetworking', '~> 2.0'它会报:[!] The dependency `AFNetworking (~> 3.0)` is not used in any concrete target.
现在版本升级官方给的文档是:
platform :ios, '8.0'
target '你的项目名称' do
pod 'AFNetworking', '~> 3.0'
end
注意:'你的项目名称'是你项目文件中'xx.xcodeproj'文件,'xx.xcodeproj'去掉后缀名所得的‘xx’==(就是)‘你的项目名称’
输入完成后按ESC退出编辑模式,最后输入:wq保存并退出文件。此时可以发现在项目目录下多了一个Podfile的文件,请注意这个文件必须与.xcodeproj在同一目录下。
最后:
pod install
没报错就可以了。
四. cocoapods安装以及使用,安装过程中ruby版本过低
- 打开终端
- 移除现有 Ruby 默认源
$ gem sources --remove https://rubygems.org/
- 使用新的源
$ gem sources -a https://ruby.taobao.org/
- 验证是否替换成功
$ gem sources -l
- 安装 CocoaPods (注意:此时如果提示ruby版本过低,请参考下边进行ruby升级)
$ sudo gem install cocoapods(比较费时)
$ sudo gem update --system(gem版本太老也可能导致安装失败,所以先更新一下)
$ pod setup
五. cocoa pods使用(新建工程,并在终端用 cd 指令进入工程根目录)
1. touch Podfile : 创建 Podfile 文件夹
2. pod search + 第三方库
3. pod -e Podfile :进入Podfile 文件夹
4. Podfile 文件格式如下:
platform :ios, '7.0'
pod 'AFNetworking', '~> 2.5.3'
5. 关闭Podfile文件夹
6. pod install
7. 每次更改了Podfile文件,都需要重新执行一次pod update命令
8. 当执行pod install之后,除了Podfile,还会生成一个名为Podfile.lock的文件,它会锁定当前各依赖库的版本,之后即使多次执行pod install也不会更改版本,只有执行pod update才会改变Podfile.lock.在多人协作的时候,这样可以防止第三方库升级时候造成大家各自的第三方库版本不一致。所以在提交版本的时候不能把它落下,也不要添加到.gitignore中.
注: 使用RVM对Ruby进行升级,升级过程如下:
1、安装 RVM
(RVM:Ruby Version Manager,Ruby版本管理器,包括Ruby的版本管理和Gem库管理(gems))
安装 RVM。
$ curl -L get.rvm.io | bash -s stable
$ source ~/.bashrc
$ source ~/.bash_profile
测试是否安装正常
rvm -v
2、用RVM升级Ruby
查看当前ruby版本
$ ruby -v
列出已知的ruby版本
$ rvm list known
选择想要安装的ruby版本
$ rvm install x.x.x