一、CocoaPods的原理
CocoaPods的原理是将所有的依赖库都放到另一个名为Pods的项目中,然后让主项目依赖Pods项目,这样,源码管理工作都从主项目移到了Pods项目中。Pods项目最终会编译成一个名为libPods.a的文件,主项目只需要依赖这个.a文件即可。
二、CocoaPods的安装
CocoaPods可以方便地通过Mac自带的RubyGems安装。
在终端进行命令行操作:
1、查看ruby的软件源
gem sources -l
如果之前没有操作过,会显示 https://rubygems.org/ 软件源。此时安装 CocoaPods 会报错,这是因为 ruby 的软件源 rubygems.org 是使用亚马逊的云服务,被屏蔽了,需要更新一下ruby的源。之前使用淘宝的镜像 https://ruby.taobao.org/ 但是现在不维护了,现在由ruby-china提供镜像服务。如果继续使用https://ruby.taobao.org/ 可能会报错,所以把地址换成 https://gems.ruby-china.com 。
2、移除ruby软件源
gem sources --remove https://rubygems.org/
3、切换ruby软件源
gem source -a https://gems.ruby-china.com
4、如果gem太老,可以尝试用如下命令升级gem(注解: sudo 是以超级管理员的身份操作)
sudo gem update --system
5、执行安装下载
sudo gem install cocoapods
6、查看cocoapods版本
pod --version
7、安装
pod setup
问题:执行pod setup的时候,出现报错
Cloning into 'master'... error: RPC failed; result=56, HTTP code = 200 fatal: The remote end hung up unexpectedly fatal: early EOF fatal: index-pack failed
这个是用于在执行pod setup命令的时候,里面会执行从github上面clone资源到本地的语句,但是要clone的东西太大了,超过的git限制的大小。尝试执行以下语句把默认的限制变大:(52428000=500×1024×1024,即500M)
git config http.postBuffer 524288000
之前git中的配置是没有这一项的,执行完以上语句后输入 git config -l 可以看到配置项的最下面多出了一行我们刚刚配置的内容。
接下来再执行pod setup试试看吧。
三、Cocoapods的使用
1、进入工程所在的目录(工程根目录),新建一个名为Podfile的文件(不能写成别的名字,也可以自己在工程根目录里面直接新建)
touch Podfile
2、然后对改文件进行编辑
open -e Podfile
Podfile文件的格式应该如下:
platform :ios, '8.0'
target '项目名称' do
pod 'AFNetworking', '~> 3.2.1'
end
需要注意的几点:platform那一行,ios三个字母都要小写,而且与前面的冒号之间不能有间隔,后面的版本号也可以不写,但是有些开源库对版本是有要求的,比如要在6.0以上才能运行,遇到这样的开源库就需要写上版本号。
platform下面就是Cocoapods需要集成的开源库,根据你的需要确定集成那些库。
举个例子:我要集成AFNetworking这个库类,需要在Cocoapods里面先搜索是否有需要的库:
pod search AFNetworking
回车之后就可以看到和你搜索的关键字相关的一些库类。然后把需要的那一行复制到我们的Podfile文件中,保存修改。WQ键退出搜索
然后在控制台执行命令:
pod install
这样,AFNetworking就已经下载完成并且设置好了编译参数和依赖,以后使用的时候切记如下两点:
(1)从此以后需要使用Cocoapods生成的 .xcworkspace文件来打开工程,而不是使用以前的.xcodeproj文件
(2)每次更改了Podfile文件,都需要重新执行一次pod update命令
ps:当执行 pod install 之后,除了Podfile,还会生成一个名为 Podfile.lock 的文件,它会锁定当前各依赖库的版本,之后即使多次执行 pod install 也不会更改版本,只有执行 pod update 才会改变 Podfile.lock。在多人协作的时候,这样可以防止第三方库升级时候造成大家各自的第三方库版本不一致。所以在提交版本的时候不能把它落下,也不要添加到 .gitignore 中。
四、卸载cocoapods
1、卸载老版本cocopods
sudo gem uninstall cocoapods
2、查看本地安装过的cocopods相关东西
gem list --local | grep cocoapods
3、然后使用命令逐个删除
sudo gem uninstall xxx