cocoapods安装使用及遇到的坑

一、什么是CocoaPods

CocoaPoads类似于java的Maven,是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的安装(重点!!!)

打开Terminal(Mac电脑自带的终端),然后按照以下提示操作即可:

1.设置ruby的软件源

这是因为ruby的软件源rubygems.org因为使用亚马逊的云服务,被我天朝屏蔽了,需要更新一下ruby的源,过程如下:
gem sources -l #(查看当前ruby的源)

gem sources –remove https://rubygems.org/ #(移除当前ruby的源)

之前我使用的是淘宝的源https://ruby.taobao.org/但是现在该源已经不维护了,所以要使用下面的源https://gems.ruby-china.org/

gem sources -a https://gems.ruby-china.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命令(非常重要,前面一般都能一次性完成)

注意:OS X 10.11 升级,虽然官方声称只是一个小的升级,但对于开发者而言,cocoapods需要重新安装,但按照以前的安装方式,在Terminal输入以下命令:

sudo gem install cocoapods
如果报以下错误:

ERROR: While executing gem … (Errno::EPERM)

Operation not permitted - /usr/bin/xcodeproj

解决方案1:(不推荐,使用无效果)

执行下面的命令并重启

sudo nvram boot-args=”rootless=0”

sudo reboot

重启之后, 执行这个命令检查

sudo gem install cocoapods -V

如果依旧有错误,使用第二个方案

解决方案2:

sudo gem install -n /usr/local/bin cocoapods

pod setup

如果我们一开始的源使用的是淘宝的,那么使用第二种方法也是会执行失败的,所以不能使用淘宝的源了。还有一点需要注意,pod setup在执行时,会输出Setting up CocoaPods master repo,但是会等待比较久的时间。这步其实是 Cocoapods 在将它的信息下载到 ~/.cocoapods目录下,如果你等太久,可以试着 cd 到那个目录,用du -sh *来查看下载进度。

安装成功后,你会看到:Setup completed

五、Cocoapods的使用(最最重要!!!)

随便以一种方式新建一个名为Podfile的文件放到你的工程根目录下(不能写成别的名字,也可以自己在工程根目录里面直接新建)
然后Podfile文件内容的格式如下

platform :ios, ‘8.0’#(注明你的开发平台以及版本,’8.0’忽略不写即为最新版本)

target ‘ios’ do
pod ‘AFNetworking’, ‘~> 2.5.3’#(‘~> 2.5.3’为版本号,忽略不写即为最新版本)
end
podfile文件内容
target后面跟的是你的工程名 target和end非常重要,如果不写会报
CocoaPods报错:The dependency AFNetworking is not used in any concrete target 这个错误

然后在Terminal进入工程所在的根目录(工程根目录)中执行 :

pod install

当我执行了该命令后,还是报错
pod install 报错
查了网上的资料,说是gem和cocoapods版本不匹配,但是我都升级到最新版本了,尝试了多遍后还是失败,最后看到一个人的解决办法

自定义GEM_HOME
$ mkdir -p $HOME/Software/ruby
$ export GEM_HOME=$HOME/Software/ruby
$ gem install cocoapods
[…]
1 gem installed
$ export PATH=$PATH:$HOME/Sofware/ruby/bin
$ pod –version
0.37.2
使用自定义的GEM_HOME作为环境变量,最后我试了一下,居然真的成功了
自定义GEM_HOME
以上如果成功了,我们就可以调用pod install命令了,这样,AFNetworking就已经下载完成并且设置好了编译参数和依赖,以后使用的时候切记如下两点:

1.从此以后需要使用Cocoapods生成的 .xcworkspace文件来打开工程,而不是使用以前的.xcodeproj文件

2.每次更改了Podfile文件,都需要重新执行一次pod update命令

关于 Podfile.lock
当你执行pod install之后,除了 Podfile 外,CocoaPods 还会生成一个名为Podfile.lock的文件,Podfile.lock 应该加入到版本控制里面,不应该把这个文件加入到.gitignore中。因为Podfile.lock会锁定当前各依赖库的版本,之后如果多次执行pod install 不会更改版本,要pod update才会改Podfile.lock了。这样多人协作的时候,可以防止第三方库升级时造成大家各自的第三方库版本不一致

搞了好久,终于弄好了,非常坑!