开源框架:CocoaPods 安装学习教程
转载 开源框架:CocoaPods
引言:
CocoaPods是一个可以帮你集中管理第三方库的开源项目,运行在Ruby的环境下,基于GitHub托管优势,你可以很方便的查阅目前依赖于CocoaPods的资源.
并且,CocoaPods是可靠,稳定,安全的.可以为你在使用第三方库资源时节省大部分的配置和部署时间.更专心的专注于Coding!
部署的环境:
硬件:Retina Macbook Pro
软件:OS X Mountain Lion 10.8.2
Ruby版本:1.9.3-p385
参考文章:
1:如何安装Ruby(如果打不开请使用百度快照)
http://www.zikercn.com/node/41
2:如何使用CocoaPods
http://blog.devtang.com/blog/2012/12/02/use-cocoapod-to-manage-ios-lib-dependency/
3:Ruby中国针对2.0.0发布帖子:
http://ruby-china.org/topics/8896
4:如果安装失败,请参考下面两贴
http://stackoverflow.com/questions/9626729/how-do-you-install-build-ruby-1-9-3-on-osx-lion
http://stackoverflow.com/questions/14592945/cannot-compile-ruby-1-9-3/14594287#14594287
第一步:安装RVM
命令:
curl -L get.rvm.io | bash -s stable
成功以后继续执行如下:
命令: source ~/.bashrc
命令: source ~/.bash_profile
然后查看rvm的版本:
命令:
rvm -v
第二步开始安装Ruby:
在执行以下所有命令之前请确保你已经安装了Xcode. 否则将无法成功.
安装前检查可安装的Ruby版本:
命令:rvm list known
正常情况执行后,可以看到所有Ruby的版本,这里安装指定的版本:
在执行下面两个命令之前先,删除残留的Ruby版本:rvm remove 1.8.7
命令:export CC=gcc
命令:rvm install 1.9.3-p385
如果以上命令安装失败,就关掉中断,直接执行第二行,失败了以后再来一次.
目前Ruby最新的版本是2.0 但是在我本机上面屡次安装失败. 但是使用CocoPods并不需要很高级的Ruby版本.
我在安装 1.9.3-p385中 顺利完成.
如果安装速度太慢可以使用淘宝提供一个加速链接来更新Ruby
成功以后设置默认使用的Ruby版本
命令:rvm use 1.9.3-p385 --default
不出意外就安装成功了.安装成功以后通过如下命令查看已经安装的Ruby版本:
命令:rvm list
检查一下Ruby当前使用的版本:
命令:ruby -v
检查一下Gem:
命令:gem -v
第三步,安装CocoaPods
接下来开始安装CocoaPods.在安装之前,还需要将XCode里的Command line工具安装好.如下图所示:
安装成功后以后回到Shell,输入如下命令:
命令:sudo gem install cocoapods
命令:pod setup
pod setup命令执行后原理是将Spec项目复制到当前用户的.cocoapods\master目录下,以后的查找、安装使用都是基于该本地目录的.
安装成功后，就可以尝试使用了,以后更新新版本的Spec项目只需要再次执行pod setup即可
使用Search命令来看看你需要的第三方库是否存在!
命令:pod search SDWebImage
到此,CocoaPods的安装就完成了.
第四步,使用CocoaPods
接下来,你需要建立一个主工程.建立成功以后,再次启动终端, 利用cd命令进入到工程文件夹内,此时需要创建一个特殊的文本文件,命令如下:
命令: touch Podfile 创建
命令: open -e Podfile 打开
此时,Mac应该是自动打开记事本. 接下来就开始加入我们要使用的库了.
编制格式可以参考CocoaPods的官方文档
示例:
platform :ios,5.0 pod 'SDWebImage'
上面的代码中:指定了平台最低支持的版本
pod通过Search查到的库 如果没有指定版本号,那么配置出来的版本是最新版.
对这个文本文件保存以后,执行如下命令:
命令:pod install
在每次执行前请确保终端所处于的文件夹目录已经是当前目录. 否则将安装失败.
另外本次成功安装以后,如果 SDWebImage 的作者更新了它的库并提交到了CocoaPods里面,此时我们也想在项目中使用新版本的SDWebImage. 这个时候需要执行如下命令:
命令:pod update
和pod install命令一样 需要将终端所处于的文件夹目录是当前Podfile文件所在的目录
执行后,CocoaPods首次会创建一个同工程名的工作空间(xcworkspace). 以后就打开这个工作空间来进行接下来的开发工作.
这里也证明了一点,以后新项目启动时,应该先配置和部署CocoaPods.
另外,如果指定了某个开源库的版本号,此时pod update 会忽略版本号, 所以需要使用pod install来安装指定的版本
Date:2013-05-13 23:24:47
今天用CocaPods的 pod install 命令时 出现如下错误:
The `master` repo requires CocoaPods 0.18.1
解决办法见此贴.
总结:
CocoaPods的部署与配置还是较为繁琐的,博文流程中记录的每一天都要去执行.不然都有可能产生失败.
题外话:
关于Spec
简单的说,Spec就是每个包在CocoaPods中的配置文件,其中包括Package的名字,版本号,每个版本对应的下载地址,编译时的参数等等。
这是该项目的地址:https://github.com/CocoaPods/Specs
在页面上有介绍如何创新新的包，可以Fork该项目，然后通过pull request提交所建的新包。
附上一篇详细的教程
http://ishalou.com/blog/2012/10/16/how-to-create-a-cocoapods-spec-file/
关于生成代码文档
详细见我的另外一篇教程:
