一、简介
CocoaPods是一款为iOS程序提供依赖管理的第三方开源库管理工具,CocoaPods项目的源码在Github上管理。该项目开始于2011年8月12日,经过多年发展,现在已经成为iOS开发事实上的依赖管理标准工具。开发iOS项目不可避免地要使用第三方开源库,CocoaPods的出现使得我们可以节省设置和更新第三方开源库的时间。
在没有使用CocoaPods以前,当需要使用开源库的时候,我们需要把这些第三方开源库的源代码下载下来并拖拽到项目里,开源库所依赖的一些系统的framework也需要手动一个一个的添加,某些开源库还需要设置一些编译参数,比如:-licucore或者-fno-objc-arc等,非常琐碎并且没什么技术含量,浪费时间。
在使用CocoaPods之后,只需要将用到的第三方开源库放到一个名为Podfile的文件中,然后执行pod install。CocoaPods就会自动将这些第三方开源库的源码下载下来,并且为工程设置好相应的系统依赖和编译参数。
二、安装
CocoaPods是用Ruby实现的,OS X系统默认可以运行Ruby,而Gem是一个管理Ruby库和程序的标准包,它通过Ruby Gem(如http://rubygems.org/)源来查找、安装、升级和卸载软件包。
1、更换 Gem 的源
2、更新升级Gem版本
Gem是管理Ruby库和程序的标准包,版本过低会导致安装失败。
3、安装CocoaPods
4、更换repo镜像为国内服务器
Podspec文件托管在https://github.com/CocoaPods/Specs 。第一次执行 pod setup时,CocoaPods会将这些podspec索引文件更新到本地的 ~/.cocoapods/目录下,因为文件大,第一次更新会非常非常慢。有人在gitcafe和oschina上建立了CocoaPods索引库的镜像,因为都是国内的服务器,所以更新时会快很多。
第一种做法是使用gitcafe镜像。
第二种做法是手动去github将Specs索引文件下载到本地,再拖拽到~/.cocoapods/目录下。
三、使用
在工程根目录下新建一个Podfile文件,将需要的依赖库的名称依次列在文件中,然后执行 pod install 就可以了
1、新建Podfile文件
注:cd后面加空格,然后把项目拖拽进命令窗口,回车进入工程根目录。
此时在项目根目录下会多了一个Podfile文件,如图:
2、编辑Podfile文件
在浏览器输入http://cocoapods.org,搜索需要的开源库,弹出框里的【pod 'MJRefresh', '~> 3.1'】就是我们需要在Podfile文件里写入的代码
回到命令窗口,编辑Podfile文件
点键盘上的字母i进入可编辑状态,写入代码,其中'Pods使用'是项目的名称
写完后,点键盘上的esc退出键,输入:wq并回车,回到命令窗口
在命令窗口输入pod install
pod install命令执行成功后,会看到工程目录下多出Podfile.lock文件、Pods使用.xcworkspace和Pods目录。
再看看刚才执行完pod install命令打印出来的内容的最后一行:
以后开发需要使用 '*.xcworkspace' 文件。
3、开源库更新
只需要在Podfile文件中添加相应的开源库信息,执行pod update命令即可。
4、说明
5、问题解决方法
如果无法引入头文件,可以在target-Build Settings下修改“User Header Search Paths”项,新增${SRCROOT}并选择rcursive
四、原理和说明
五、更多
分享链接:
CocoaPods官方