关于10.12及以后系统安装cocoapods及常遇到的问题
一、什么是CocoaPods
每种语言发展到一个阶段,就会出现相应的依赖管理工具,例如 Java 语言的 Maven,nodejs 的 npm。随着 iOS 开发者的增多,业界也出现了为 iOS 程序提供依赖管理的工具,它的名字叫做:CocoaPods。
CocoaPods项目的源码 在 Github 上管理。该项目开始于 2011 年 8 月 12 日,经过多年发展,现在已经成为 iOS 开发事实上的依赖管理标准工具。开发 iOS 项目不可避免地要使用第三方开源库,CocoaPods 的出现使得我们可以节省设置和更新第三方开源库的时间。
二、为什么要使用CocoaPods
在使用CocoaPods之前,开发项目需要用到第三方开源库的时候,我们需要
1.把开源库的源代码复制到项目中
2.添加一些依赖框架和动态库
3.设置-ObjC,-fno-objc-arc等参数
4.管理他们的更新
在使用CocoaPods后,我们只需要把用到的开源库放到一个名为Podfile的文件中,然后执行pod install就可以了,Cocoapods就会自动将这些第三方开源库的源码下载下来,并且为我们的工程设置好响应的系统依赖和编译参数。
三、CocoaPods的原理
CocoaPods的原理是将所有的依赖库都放到另一个名为Pods的项目中,然后让主项目依赖Pods项目,这样,源码管理工作都从主项目移到了Pods项目中。Pods项目最终会编译成一个名为libPods.a的文件,主项目只需要依赖这个.a文件即可。
四、CocoaPods的安装
打开终端,
1.设置ruby的软件源
gem sources -l #(查看当前ruby的源)
gem sources --remove https://rubygems.org/ #(移除当前ruby的源)
gem sources -a https://ruby.taobao.org/ #(设置当前ruby的源为我天朝的)
gem sources -l #(再次查看当前ruby的源)
如果Terminal输出:
*** CURRENT SOURCES ***
https://ruby.taobao.org/
就证明ruby的软件源已经设置OK了。
2.设置gem为最新版本
如果gem太老,可以尝试用如下命令升级gem:
在Terminal输入以下命令:
sudo gem update --system
升级成功后会提示: Latest version currently installed. Aborting.
3.执行安装CocoaPods命令
sudo gem install cocoapods
如果执行上述命令行时出错:
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/pod
执行以下命令行
sudo gem install -n /usr/local/bin cocoapods
pod setup
值得注意的是,在pod setup的时候,会输出Setting up CocoaPods master repo
但是这个阶段会等很长时间,这步其实是 Cocoapods 在将它的信息下载到 ~/.cocoapods目录下,
警告⚠️:
如果这个过程太久并且没有出现下载进度及网速的话,是因为在执行pod setup的时候master这个库没成功,所以就算移除镜像重新安装的话,默认是从master库里获取,导致安装不成功,解决办法是移除master库,重新创建
pod repo upadte --verbose
rm -rf ~/.cocoapods/repos/master
然后再执行pod setup
安装成功后,你会看到:Setup completed
4.cocoapods使用
cd到工程根目录
vim Podfile
直接输入需要添加的库
pod install
如果pod install被墙的话,改用
pod install --verbose --no-repo-update
附:如何使用CocoaPods的镜像索引:
所有项目的Podspec文件都托管在https://github.com/CocoaPods/Specs,
第一次执行pod setup时,CocoaPods会将这些podspec索引文件更新到本地的~/.cocoapods目录下,
这个索引文件比较大,所以第一次更新时非常慢.
友好人士在国内的服务器建立了Cocoapods索引库的镜像,
所以执行索引跟新操作时候会快很多.具体操作方法如下:
pod repo remove master
pod repo add master https://gitcafe.com/akuandev/Specs.git
pod repo update
这是使用gitcafe上的镜像,将以上代码中的 https://gitcafe.com/akuandev/Specs.git
替换成 http://git.oschina.net/akuandev/Specs.git 即可使用oschina上的镜像。