一、什么是CocoaPods
在iOS应用开发过程中,有很多地方需要借助第三方代码,来提高我们的开发效率。但是,一个程序中我们可能会用到许多的第三方,这些第三方的编写方式有很多区别,比如有的是使用MRC编写的,但是我们的项目可能是ARC环境编写的,如何正确的配置各种各样的第三方呢?使用CocoaPods来替我们管理。是我们的最佳选择。
CocoaPods是OS X以及iOS下的第三方管理工具,CocoaPods可以为我们的程序添加一个“Pods”的依赖库,并且可以为我们对这些第三方类库做各种各样的配置,比如ARC环境下使用MRC环境编写的第三方类库的时候,它就会为我们配置-fno-objc-arc,它所管理的第三方类库,必须是要符合它的一种“标准”的,并不是随便一个类库都能在其中管理,这样就保证了第三方类库的质量。
二、CocoaPods的运行原理
CocoaPods的源码在github上,项目中有一个列表,列表内存放着所有符合CocoaPods标准的第三方类库的信息,包括类库名、版本信息、在github上的地址等。我们在本地安装好CocoaPods之后,使用pod init
命令,就是在本地项目中添加一个Podfile文件,该文件中列出了我们需要被管理的第三方的信息,当我们使用pod install
命令的时候就会向CocoaPods发送一个命令,CocoaPods会在本地生成一个Pods依赖库,这个库中就有我们需要的第三方类库。
三、Mac系统下安装CocoaPods
安装CocoaPods需要ruby运行环境,Mac系统中已经为我们集成了ruby运行环境,我们使用ruby的gem命令,就可以轻松安装。在此之前我们先检查一下我们的ruby和gem是不是太老,否则会有问题。
1、检查ruby的版本
// 终端输入
ruby -v
// 如果出现类似如下的信息则表示系统安装了最新的版本
ruby 2.0.0p481 (2014-05-08 revision 45883) [universal.x86_64-darwin14]
2、查看gem版本
gem -v
3、更新ruby环境
检查完后,如果你的gem太老,可以使用gem的更新命令进行升级
// 终端输入
sudo gem update -system
// 注意这里要加sudo不然会提示没有权限操作
// 终端提示输入密码,有时候可能你输入密码,终端看上去没有反应,不用管直接输入完密码回车即可
4、更换软件源
因为默认的官方的安装源https://rubygem.org/ 使用的是亚马逊的云服务,被“墙”了,所以需要更换其他的软件源,下面是淘宝提供的安装源https://ruby.taobao.org/
// 移除默认的安装源 终端输入
gem sources --remove https://rubygems.org/
// 终端显示:https://rubygems.org/ removed from sources
// 添加淘宝源gem sources --add https://ruby.taobao.org/
// 终端显示:https://ruby.taobao.org/ added to sources
// 查看一下更换结果
// 终端输入
gem sources -l
// 终端显示:
*** CURRENT SOURCES ***https://ruby.taobao.org/
5、开始安装cocoaPods
// 终端输入:
sudo gem install cocoapods
// 注意 前面一定要加sudo
终端提示输入系统密码,输入密码回车后会输出一大串信息,出现类似21 gem install
,表示安装完毕:(这里可能会花一点时间,这是因为CocoaPods正在下载一些信息到你的项目中),如果你嫌慢,可以使用国内服务器上的CocoaPods索引库的镜像来更新索引。以下是使用oschina上的镜像,当然你也可以使用其他的镜像。
// 终端输入
pod repo remove master
// 移除原来的版本控制
pod repo add master http://git.oschina.net/akuandev/Specs.git
// 添加新的版本控制pod repo update
// 更新
6、使用CocoaPods来简化我们的开发吧
Podfile 文件是用来用来声明项目代码相关性的,我们要在这个文件中写入我们需要添加管理的第三方类库。
在终端中用cd命令进入你的项目.xcodeproj文件所在的目录,通过以下命令来创建一个Podfile文件
cd "项目路径"
pod init
你生成的Podfile文件中可能包含如下信息
platform :ios, '9.0' target "你的项目名"
do end
编辑Podfile文件,这里可以用vim编辑,也可以用文本编辑工具打开Podfile文件进行编辑,将需要的第三方的名字以及版本信息加入文件. (注:以下内容不是终端中输入的代码,是要写在Podfile文件里面的)
pod "AFNetworking", "~> 2.0"
pod 'SDWebImage', '~>3.7'
接下来,通过以下代码就可以轻松安装第三方了
// 终端输入
pod install
// 等待安装完成
Updating local specs repositories
Analyzing dependencies
Downloading dependencies
Installing AFNetworking (2.6.1)
Installing SDWebImage (3.7.3)
Generating Pods project
Integrating client project
[!] Please close any current Xcode sessions and use `AVPlayerTest.xcworkspace` for this project from now on.
Sending stats
Pod installation complete! There are 2 dependencies from the Podfile and 2 total
pods installed.
到此CocoaPods就安装完成了。需要注意的是:1、打开你的项目,你会发现多处许多文件,下次打开项目时,需要打开.xcworkspace文件才可以使用刚添加的Pods依赖库里面的第三方类库。而不是以前的.xcodeproj文件。2、当你想添加新的第三方的时候,只需要在Podfile文件里面写入,然后执行一次pod update
命令。3、如果你想卸载不需要的第三方,直接在Podfile文件里面删除那个第三方的信息,然后执行一次pod update
即可。
7、Podfile.lock
安装过程中,CocoPods会使用递归来分析所有的需求,并且建立一个代码相关性的图,最后将Podfile序列化为Podfile.lock比如,如果两个库都需要使用AFNetworking,CocoaPods会确定一个同时能被这两库使用的版本,然后将同一个安装版本链接到两个不同的库中。
8、pod try
如果你在安装一个第三方库之前,想要先试用一下,就可以使用try命令。只需要在try的后面加上你想试用的第三方的名称即可
pod try AFNetworking
四、其他问题
1、CocodaPods遵循语义化版本规范,有时候,我们需要的第三方可能不在CocoaPods公共git仓库中,此时,你可以使用其它的Git或者SVN仓库取代,并可以指定具体的commit、branch或tag2、在安装过程中,可能会有如下错误:
这是因为Xcode未安装或者未启用command line developer tools只需在Xcode中安装或启用一下即可:打开Xcode,commend+,打开偏好设置,选择启用Command Line Tools版本