cocapods最新安装教程

引用：http://www.jianshu.com/p/b64b4fd08d3c

cocoapods官网：https://guides.cocoapods.org

1、什么是CocoaPods

每种语言发展到一个阶段，就会出现相应的依赖管理工具，例如 Java 语言的 Maven，nodejs 的 npm。随着 iOS 开发者的增多，业界也出现了为 iOS 程序提供依赖管理的工具，它的名字叫作：CocoaPods。

CocoaPods项目的源码 在 Github 上管理。该项目开始于 2011 年 8 月 12 日，通过多年发展，如今已经成为 iOS 开发事实上的依赖管理标准工具。开发 iOS 项目不可避免地要使用第三方开源库，CocoaPods 的出现使得咱们能够节省设置和更新第三方开源库的时间。

2、为何要使用CocoaPods

在使用CocoaPods以前，开发项目须要用到第三方开源库的时候，咱们须要

1.把开源库的源代码复制到项目中

2.添加一些依赖框架和动态库

3.设置-ObjC，-fno-objc-arc等参数

4.管理他们的更新

在使用CocoaPods后，咱们只须要把用到的开源库放到一个名为Podfile的文件中，而后执行pod install就能够了，Cocoapods就会自动将这些第三方开源库的源码下载下来，而且为咱们的工程设置好响应的系统依赖和编译参数。

3、CocoaPods的原理

CocoaPods的原理是将全部的依赖库都放到另外一个名为Pods的项目中，而后让主项目依赖Pods项目，这样，源码管理工做都从主项目移到了Pods项目中。Pods项目最终会编译成一个名为libPods.a的文件，主项目只须要依赖这个.a文件便可。

4、CocoaPods的安装

CocoaPods能够方便地经过Mac自带的RubyGems安装。

打开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 -a https://gems.ruby-china.com/

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

5、Cocoapods的使用

随便以一种方式新建一个名为Podfile的文件放到你的工程根目录下（不能写成别的名字，也能够本身在工程根目录里面直接新建）

Podfile文件内容的格式应该以下：

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

pod 'AFNetworking', '~> 2.5.3' #('~> 2.5.3'为版本号，忽略不写即为最新版本)

pod 'SDWebImage', '~> 3.7.2'

而后在Terminal进入工程所在的根目录（工程根目录）中执行 ：

pod install

这样，AFNetworking和SDWebImage就已经下载完成而且设置好了编译参数和依赖，之后使用的时候切记以下两点：

1.今后之后须要使用Cocoapods生成的 .xcworkspace文件来打开工程，而不是使用之前的.xcodeproj文件

2.每次更改了Podfile文件，都须要从新执行一次pod update命令

查找第三方库：

你若是不知道 cocoaPods 管理的库中，是否有你想要的库，那么你能够经过 pod search 命令进行查找，如下是我用 pod search json 查找到的全部可用的库：

能够在Terminal中输入：

pod search AFNetworking

回车以后就能够看到和你搜索的关键字相关的一些库类，如图：

关于 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上的镜像

 

推荐阅读：

CocoaPods安装和使用教程

用CocoaPods作iOS程序的依赖管理

CocoaPods极简入门指南

CocoaPods的安装使用和常见问题

2016-10-8号更新

CocoaPods的安装以及遇到的坑

终端安装cocoaPods的方法