前言

在iOS项目中使用第三方类库可以说是非常常见的事，但是要正确地配置他们有时候是非常繁琐的事情，幸运的是CocoaPods是一个很好的解决方案。

什么是CocoaPods

CocoaPods是OS X和iOS下的一个第三类库管理工具，通过CocoaPods工具我们可以为项目添加被称为“Pods”的依赖库（这些类库必须是CocoaPods本身所支持的），并且可以轻松管理其版本。

Cocoapods意义体现在两个方面。第一，在引入第三方库时它可以自动为我们完成各种各样的配置，包括配置编译阶段、连接器选项、甚至是ARC环境下的-fno-objc-arc配置等。第二，使用CocoaPods可以很方便地查找新的第三方库，这些类库是比较“标准的”，而不是网上随便找到的，这样可以让我们找到真正好用的类库。

接下来我们将介绍CocoaPods的使用。

CocoaPods的核心组件

CocoaPods是用Ruby写的，并划分成了若干个Gem包。

CocoaPods在解析执行过程中最重要的几个包的路径分别是：CocoaPods/CocoaPods、 CocoaPods/Core 和 CocoaPods/Xcodeproj。

CocoaPods / CocoaPod：这是面向用户的组件，每当执行一个pod命令时，这个组件将被激活。它包括了所有实用CocoaPods的功能，并且还能调用其他gem包来执行任务。

CocoaPods / Core：Core gem提供了与CocoaPods相关的文件（主要是podfile和podspecs）的处理。

Podfile：该文件用于配置项目所需要的第三方库，它可以被高度定制。本文中我们主要在这里做动作。Podspec：该文件描述了一个库将怎样被添加进工程中。.podspec文件可以标识该第三方库所需要的源码文件、依赖库、编译选项，以及其他第三方库需要的配置。 CocoaPods / Xcodeproj：这个包负责处理工程文件，它能创建以及修改.xcodeproj文件和.xcworkspace文件。它也可以作为一个独立的包使用，当你要编写修改项目文件的脚本时，可以考虑使用CocoaPods/Xcodeproj。

下载和安装CocoaPods

上面已经提到，CocoaPods是用Ruby写的，所以运行需要安装Ruby环境。Mac中已经自带Ruby环境，这个不用我们担心，如果认为Ruby环境不够新，我们可以先更新，打开终端，输入以下命令：

1.gem update --system

接下来我们可以安装CocoaPods了，在安装前，我们先做点小动作。

由于安装CocoaPods时我们要访问cocoapods.org，该网站可能被我们大天朝墙了，这样下载安装可能会是龟速，幸好我们可以用淘宝的Ruby镜像来访问该网站，方法如下：

1.$ gem sources --remove https://rubygems.org/
2.$ gem sources -a http://ruby.taobao.org/

成功后，使用以下命令查看：

1.$ gem sources -l

可以看到替换镜像成功：

1.*** CURRENT SOURCES ***
2. 
3.http://ruby.taobao.org/

接下来是真正的安装，在终端输入以下命令：

1.$ sudo gem install cocoapods

安装输出非常长，这里就不贴出来了。

然后使用setup命令配置CocoaPods（这个命令也可以不运行，但是第一次使用pod命令时这个setup过程也会自动执行）

1.AppledeMacBook-Pro:~ apple$ pod setup
2.Setting up CocoaPods master repo
3.Setup completed (read-only access)

这个时间可能比较长，耐心等待下。

使用CocoaPods为工程配置第三方类库

首先打开Xcode新建一个工程，假设为Desktop/CocoaPodsDemo，并且我们要往该工程中导入AFNetworking这个类库。

AFNetworking在Github中的地址为：https://github.com/AFNetworking/AFNetworking

这里也说明了如何使用CocoaPods配置该类库：

以上说明是我们应该如何书写Podfile文件。一般非常流行和成熟的类库都得到了CocoaPods的支持，并且有这个说明。

如何确定CocoaPods是否支持我们想要加入的目标类库？使用Search命令搜索类库名：

1.$ pod search AFNetworking

如果CocoaPods支持，将会输出搜索到的所有类库版本和信息，以及在Podfile中配置的写法，例如：

01.-> AFNetworking (2.1.0)
02.A delightful iOS and OS X networking framework.
03.pod 'AFNetworking', '~> 2.1.0'
04.- Homepage: https://github.com/AFNetworking/AFNetworking
05.- Source:   https://github.com/AFNetworking/AFNetworking.git
06.- Versions: 2.1.0, 2.0.3, 2.0.2, 2.0.1, 2.0.0-RC3, 2.0.0-RC2, 2.0.0-RC1,
07.2.0.0, 1.3.3, 1.3.2, 1.3.1, 1.3.0, 1.2.1, 1.2.0, 1.1.0, 1.0RC3, 1.0RC2,
08.1.0RC1, 1.0.1, 1.0, 0.9.2, 0.9.1, 0.9.0, 0.7.0, 0.5.1, 0.10.1, 0.10.0 [master
09.repo]
10.- Sub specs:
11.- AFNetworking/Serialization (2.1.0)
12.- AFNetworking/Security (2.1.0)
13.- AFNetworking/Reachability (2.1.0)
14.- AFNetworking/NSURLConnection (2.1.0)
15.- AFNetworking/NSURLSession (2.1.0)
16.- AFNetworking/UIKit (2.1.0)
17. 
18. 
19.-> AFNetworking+AutoRetry (0.0.2)
20.Auto Retries for AFNetworking requests
21.pod 'AFNetworking+AutoRetry', '~> 0.0.2'
22.- Homepage: https://github.com/shaioz/AFNetworking-AutoRetry
23.- Source:   https://github.com/shaioz/AFNetworking-AutoRetry.git
24.- Versions: 0.0.2, 0.0.1 [master repo]
25. 
26. 
27.-> AFNetworking-RACExtensions (0.1.2)
28.AFNetworking-RACExtensions is a delightful extension to the AFNetworking
29.classes for iOS and Mac OS X.
30.pod 'AFNetworking-RACExtensions', '~> 0.1.2'
31.- Homepage: https://github.com/CodaFi/AFNetworking-RACExtensions
32.- Source:   https://github.com/CodaFi/AFNetworking-RACExtensions.git
33.- Versions: 0.1.2, 0.1.1, 0.0.1 [master repo]
34. 
35. 
36.-> AFNetworking-ReactiveCocoa (0.0.2)
37.Make AFNetworking reactive.
38.pod 'AFNetworking-ReactiveCocoa', '~> 0.0.2'
39.- Homepage: https://github.com/uasi/AFNetworking-ReactiveCocoa
40.- Source:   https://github.com/uasi/AFNetworking-ReactiveCocoa.git
41.- Versions: 0.0.2, 0.0.1 [master repo]
42. 
43. 
44.-> AFNetworking-Synchronous (0.2.0)
45.Synchronous requests for AFNetworking
46.pod 'AFNetworking-Synchronous', '~> 0.2.0'
47.- Homepage: https://github.com/paulmelnikow/AFNetworking-Synchronous
48.- Source:   https://github.com/paulmelnikow/AFNetworking-Synchronous.git
49.- Versions: 0.2.0, 0.1.0 [master repo]

先看看普通的工程目录：

好吧，进入主题，首先在我们的工程目录下创建Podfile文件，该文件用来控制CocoaPods的下载内容，该文件是没有后缀的，每个项目只需要一个Podfile文件，如果需要导入多个类库那么统一在该文件中书写下载内容。

创建过程：首先cd到工程目录，然后创建Podfile并且使用vim编写：

1.AppledeMacBook-Pro:~ apple$ cd Desktop/CocoaPodsDemo/
2.AppledeMacBook-Pro:CocoaPodsDemo apple$ touch Podfile
01.platform:ios, '7.0'
02.pod "AFNetworking", "~>2.1"
03.~                                                                              
04.~                                                                              
05.~                                                                              
06.~                                                                              
07.~                                                                              
08.~                                                                              
09.~                                                                              
10.~                                                                              
11.~                                                                              
12.~                                                                              
13.~                                                                              
14.~                                                                              
15.~                                                                              
16.~                                                                              
17.~                                                                              
18.~                                                                              
19.~                                                                              
20.~                                                                              
21.~                                                                              
22.~                                                                              
23.~                                                                              
24.:wq

在编辑完成后先按esc，再按“:”，输入wq保存并退出。

Podfile中的两句文字的意思是，当前AFNetworking支持的iOS最高版本是iOS 7.0, 要下载的AFNetworking版本是2.1。

也可以用文本编辑工具打开该文件进行编辑，命令如下：

1.open -e Podfile

这里我同时为Demo安装AFNetworking，JSONKit和MBProgressHUD三个类库，Podfile文件内容如下：

1.platform:ios, '7.0' 
2.pod 'AFNetworking', '~> 2.1.0'
3.pod 'JSONKit-NoWarning', '~> 1.1'
4.pod 'MBProgressHUD', '~> 0.8'

在有了Podfile后，输入以下命令安装类库：

1.$ pod install

安装完成后，输出信息如下：

01.$ pod install
02.Analyzing dependencies
03.Downloading dependencies
04.Installing AFNetworking (2.1.0)
05.Installing JSONKit-NoWarning (1.1)
06.Installing MBProgressHUD (0.8)
07.Generating Pods project
08.Integrating client project
09. 
10.[!] From now on use `CocoaPodsDemo.xcworkspace`.

最后一句表面，如果要正确打开工程我们应该打开最新生成的.xcworkspace文件。

可以看到工程目录发生变化了，三个类库都安装上了：

打开Build Phases，可以看到CocoaPods已经自动为我们完成了所有设置：

之后我们可以在工程中导入AFNetworking、JSONKit和MBProgressHUD的任意头文件并使用其所有接口了：

1.#import "ViewController.h"
2.#import <afnetworking afnetworking.h="">
3.#import <jsonkit-nowarning jsonkit.h="">
4.#import <mbprogresshud mbprogresshud.h=""></mbprogresshud></jsonkit-nowarning></afnetworking>

上面说的内容略多。。。但是总的来说我们就做了两件事：新建Podfile文件并编写要导入的类库信息，打开终端输入pod install命令安装，完成。一切都是如此的方便。

Damn, it is awesome.

正确编译运行一个包含CocoaPods类库的项目

如果一个项目中已经包含了CocoaPods的配置文件，但是编译却出现错误，那么我们仅需要一行命令就可以配置好所有的第三方类库了：

1.$ pod update

参考Demo的项目地址：https://github.com/UrbanApps/UAAppReviewManager

打开Demo的UAAppReviewManagerExample目录，可以发现少了一个xcworkspace文件，另外还有几个CocoaPods的配置文件在这里：

打开Podfile文件看看：

01.target 'UAAppReviewManagerExampleiOS' do
02.platform :ios, '5.1'
03.pod 'UAAppReviewManager', :path => '..'
04.end
05. 
06.target 'UAAppReviewManagerExampleMac' do
07.platform :osx, '10.7'
08.pod 'UAAppReviewManager', :path => '..'
09.end

platform表示类库支持的最高版本，该类库的target包括了iOS和Mac。而path指定了到上级目录去查找该类库的安装信息。

编译工程，将会出错，原因是我们没有将类库链接到工程中：

因此我们要用pod命令进行安装。cd到Example目录下执行pod install命令，将会报错：

1.$ pod install
2.Analyzing dependencies
3.Fetching podspec for `UAAppReviewManager` from `..`
4.[!] Unable to satisfy the following requirements:
5.- `UAAppReviewManager (from `..`)` required by `Podfile`

原因是要添加的类库已经有最新版本推出，而Podfile文件并没有更改其下载版本（Podfile文件过期），于是获取安装数据失败。

因此我们要用update命令获取最新版本的类库：

01.$ pod update
02.Analyzing dependencies
03.Fetching podspec for `UAAppReviewManager` from `..`
04.Downloading dependencies
05.Installing UAAppReviewManager (0.2.1)
06.Generating Pods project
07.Integrating client project
08. 
09.[!] From now on use `UAAppReviewManagerExample.xcworkspace`.

同样地我们成功生成了xcworkspace文件：

再编译运行就没问题了。

补充

当Cocoapods向项目中增加了一个第三方库的时候，不仅仅只是添加代码，由于每个第三方类库有不同的target，所以每次添加第三方库时，都会有几个文件被写入磁盘，包括Podfile.lock和Manifest.lock文件等。

其中Podfile.lock记录了需要被安装的pod的每个已安装的版本。如果你想知道已安装的pod是哪个版本，可以查看这个文件。

Manifest.lock是每次运行pod install时创建的Podfile.lock文件的副本。

源自：http://www.it165.net/pro/html/201402/9213.html

使用cocoapods管理第三方类库的更多相关文章

  1. iOS 如何在一个已经存在多个project的workspace中引入cocoapods管理第三方类库

    一种新的第三方库管理工具:Carthage 如何使用Carthage管理iOS依赖库 Podfile Syntax Reference v1.1.0.rc.3 https://guides.cocoa ...

  2. iOS开发 使用Cocoapods管理第三方类库

    每次上github看到一些优秀的代码,总能看到Podfile,也了解是个管理第三方类库的,今天抽时间学习了一下,挺简单的! 作用:      太多  还是复制一下把!!! CocoaPods是什么? ...

  3. 使用CocoaPods管理第三方类库[效率]

    项目文件夹   加入第三方框架后的项目文件夹例如以下图 为什么要用Cocoapods?   iOS开发中经常使用的第三方库,比方: 1.FMDB:在使用SQLite是仅仅须要加入libsqlite3. ...

  4. 使用CocoaPods管理第三方开源类库

    iOS开发中经常会用到许多第三方开源类库,比如AFNetworking.FMDB.JSONKit等等,使用CocoaPods这个工具就能很方便得对工程中用到的类库进行管理,包括自动下载配置以及更新. ...

  5. Xcode工程使用CocoaPods管理第三方库新建工程时出现错误

    工程使用CocoaPods管理第三方库,在新的目录update版本的时候出现如下问题   问题1描述: diff: /../Podfile.lock: No such file or director ...

  6. Xcode工程使用CocoaPods管理第三方库新建工程时出现异常

    Xcode工程使用CocoaPods管理第三方库新建工程时出现异常 Xcode工程使用CocoaPods管理第三方库新建工程时出现错误工程使用CocoaPods管理第三方库,在新的目录update版本 ...

  7. CocoaPods管理第三方

    之前听伟哥说用CocoaPods做第三方库的管理很方便,今天看了下自己做了下感觉确实不错.下面开始,Let's go!! 1.安装CocoaPods之前,先确保本地有Ruby环境,因为CocoaPod ...

  8. iOS边练边学--cocoaPods管理第三方框架--命令行方式实现

    更换源 Gem是一个管理Ruby库和程序的标准包,它通过Ruby Gem(如 http://rubygems.org/)源来查找.安装.升级和写在软件包 gem sources --remove ht ...

  9. 使用cocoapods导入第三方类库后 头文件没有代码提示？

    选择Target -> Build Settings 菜单,找到\”User Header Search Paths\”设置项 新增一个值"${SRCROOT}",并且选择\ ...

随机推荐

  1. HDU-4570 Multi-bit Trie

    http://acm.hdu.edu.cn/showproblem.php?pid=4570 Multi-bit Trie Time Limit: 2000/1000 MS (Java/Others) ...

  2. Hadoop的文件读写操作流程

    以下主要讲解了Hadoop的文件读写操作流程: 读文件 读文件时内部工作机制参看下图: 客户端通过调用FileSystem对象(对应于HDFS文件系统,调用DistributedFileSystem对 ...

  3. 265行JavaScript代码的第一人称3D H5游戏Demo【个人总结1】

    本文目的是分解前面的代码.其实,它得逻辑很清楚,只是对于我这种只是用过 Canvas 画线(用过 Fabric.js Canvas库)的人来说,这个还是很复杂的.我研究这个背景天空也是搞了一天,下面就 ...

  4. Android客户端调用Asp.net的WebService

    Android客户端调用Asp.net的WebService 我来说两句 |2011-11-23 13:39:15 在Android端为了与服务器端进行通信有几种方法:1.Socket通信2.WCF通 ...

  5. shadowgun的飘扬旗帜shader

    MADFINGER-Lightmap-Unlit-Wind用于模拟布料和树被风吹的弯曲摆动效果 这个来自于<GPU GEMS 3>中的 “Chapter 16 Vegetation Pro ...

  6. UIImageVIew的使用

    UIImageView是一个用于显示图片的控件 构造方法:     UIImage * tempImage = [UIImage imageNamed:IMAGE_NAME];     imageVi ...

  7. Android WebRTC 音视频开发总结

    www.cnblogs.com/lingyunhu/p/3621057.html 前面介绍了WebRTCDemo的基本结构,本节主要介绍WebRTC音视频服务端的处理,,转载请说明出处(博客园RTC. ...

  8. JavaEE学习笔记---数据库操作篇

    测试JDBC和SQLServer的插入操作,源码如下: import java.sql.Connection;import java.sql.DriverManager;import java.sql ...

  9. ecshop判断搜索引擎是否为蜘蛛

    <?php /** * 判断是否为搜索引擎蜘蛛 * * @access public * @return string */ function is_spider($record = true) ...

  10. opencv学习笔记-图像叠加、混合

    在图像处理中,目标区域定义为感兴趣区域ROI(region of Interest),这是后期图像处理的基础,在获取ROI后,进行一些列的处理.ROI区域在Opencv中就是Rect,先构建Rect, ...