安装CocoaPods:
在安装CocoaPods之前,首先要在本地安装好Ruby环境(上一章已经简述如何配置Ruby环境)。
在Terminator(也就是终端)中输入以下命令:
$ gem install cocoapods (需要输入管理员密码)
可能出现Error的情况1:
在终端中敲入这个命令之后,会发现半天没有任何反应。原因无他,那就是国内的网络环境的问题访问镜像源超时。我们可以用淘宝的Ruby镜像来访问cocoapods。按照下面的顺序在终端中敲入依次敲入命令:
$ sources --remove https://rubygems.org/
等有反应之后再敲入以下命令:
$ gem sources -a http://ruby.taobao.org/
为了验证你的Ruby镜像是并且仅是taobao,可以用以下命令查看:
$ gem sources -l
只有在终端中出现下面文字才表明你上面的命令是成功的:
*** CURRENT SOURCES ***
这时候,你再次在终端中运行:
$ gem install cocoapods
等上十几秒钟,CocoaPods就可以在你本地下载并且安装好了,不再需要其他设置。
验证cocoapods是否安装成功 :
$ pod
可能出现Error的情况2:
安装过程还可能出现这个错误ERROR: While executing gem ... (Gem::FilePermissionError) You don't have write permissions for the /Library/Ruby/Gems/2.0.0 directory.我采取的做法是把权限修改过来用命令$ sudo chmod 777 /Library/Ruby/Gems/2.0.0;然后就安装好了。
CocoaPods简单的使用:
1> 查看第三方库是否支持CocoaPods
$ pod search SDWebImage (以SDWebImage为例)
只截取前面一部分,列表会给出所有cocoapods支持的与关键字有关的第三方框架和版本号
2> 项目中加入cocoapods的支持
在桌面上新建一个test项目为例.在终端中进入项目所在目录:$ cd 项目根目录路径
$ vim Podfile (利用vim创建Podfile文件)
输入: i 进入编辑状态
输入: $ platform :ios, '6.1'
$ pod ‘SDWebImage’,’~>3.6’
输入完成后退出编辑模式,按Esc,然后输入:wq保存退出
这段内容来自于github的SDWebImage,一般你需要添加什么样的第三方库,第三方库说明文档中会有pods怎么添加的介绍
这时,项目目录会有一个podfile文件,文件内容即为刚输入的那两句话
在终端运行命令: $pod install (会安装Podfile里面记录的第三方库)
取决于网速的环境,安装时间可能会比较久. 注意最后一句话,from now on use ‘podsTest.xcworkspace’,
安装完的目录结构如下:
多了4个东西,Pods文件夹存放你下载的第三方库.以后打开工程不再是使用xcodeproj,而是使用xcworkspace…因为你打开workspace工作空间,你发现里面包含两个xcodeproj工程文件。一个是本身的工程,一个是Pods管理第三方库的工程。
3> 正确编译运行一个包含cocoapods类库的第三方库 (就是你要用的第三方库又包含依赖其它的第三方库采用cocoapods管理)
进入项目所在目录,输入命令:$ pod update (将文件中的所有第三方库更新到最新版本)
这里就不再举例子了,掌握前面的,这个也就会了。
小结:Podfile文件控制cocoapods该下载什么,文件名一定叫做Podfile且没有后缀。
每次都优先使用$ pod update 命令
出现Error的情况
(1)输入$ pod install。如果出现[!] /usr/local/bin/git remote update
error: cannot open FETCH_HEAD: Permission denied那么用$ sudo chown -R mac ~/Library/Caches/CocoaPods/和sudo chown -R mac ~/.cocoapods/就能搞定了。
(2)安装完成会出现.xcworkspace文件和podfile.lock和pods文件夹。打开前者可以看到新增的pod工程。
(3)如果想在自己的工程中添加pod中的文件需要在xcode的target的bulidsetting中添加头文件的搜索路径添加一个输入${SRCROOT} 后面选上recursive。然后就能使用了。
(4)如果输入$ pod install 会出现 [!] Unable to satisfy the following requirements: 这样一个错误信息时(错误原因是:要添加的类库已经有最新版本推出,而Podfile文件并没有更改其下载版本(Podfile文件过期),于是获取安装数据失败。) 因此我们要用update命令获取最新版本的类库:$ pod update --verbose Update all pods