最新MacOS 10.12.2 安装cocoapods以及使用

cocoapods官网

一、什么是cocoapods

语言发展到一定的地步就会出现相应的依赖管理工具，就像Java语言的Maven，nodejs的npm。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的源)

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

3.执行安装cocoapods命令

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

//sudo gem install cocoapods

如果报以下错误：

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

Operation not permitted - /usr/bin/xcodeproj

sudo gem install cocoapods -V

解决方案：

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

pod setup

还有一点需要注意，pod setup在执行时，会输出Setting up CocoaPods master repo，但是会等待比较久的时间。这步其实是 Cocoapods 在将它的信息下载到 ~/.cocoapods目录下。

安装成功后，会看到setup completed

五、cocoapods的使用

在终端中进入（cd命令）你项目所在目录，然后在当前目录下，利用vim创建Podfile

$vim Podfile

然后在Podfile文件中输入以下文字:

platform:ios, '8.0'
use_frameworks!

#inhibit_all_warnings!
target 'ProjectName' do #ProjectName必须是项目名称
    pod 'AFNetworking'
    #...
end

添加完所需要的第三方库，然后保存退出：

:wq

退出之后执行命令

$pod install

等到执行完成之后，关闭项目，重新打开ProjectName.xcworkspace文件即可。

关于Podfile.lock

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

附：如何使用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上的镜像。