1695人阅读
iOS（401）
在iOS项目中使用第三方类库可以说是非常常见的事，但是要正确地配置他们有时候是非常繁琐的事情，幸运的是CocoaPods是一个很好的解决方案。
什么是CocoaPods
CocoaPods是OS X和iOS下的一个第三类库管理工具，通过CocoaPods工具我们可以为项目添加被称为“Pods”的依赖库（这些类库必须是CocoaPods本身所支持的），并且可以轻松管理其版本。
Cocoapods意义体现在两个方面。第一，在引入第三方库时它可以自动为我们完成各种各样的配置，包括配置编译阶段、连接器选项、甚至是ARC环境下的-fno-objc-arc配置等。第二，使用CocoaPods可以很方便地查找新的第三方库，这些类库是比较“标准的”，而不是网上随便找到的，这样可以让我们找到真正好用的类库。
接下来我们将介绍CocoaPods的使用。
CocoaPods的核心组件
CocoaPods是用写的，并划分成了若干个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环境。Mac中已经自带Ruby环境，这个不用我们担心，如果认为Ruby环境不够新，我们可以先更新，打开终端，输入以下命令：
update --system
接下来我们可以安装CocoaPods了，在安装前，我们先做点小动作。
由于安装CocoaPods时我们要访问cocoapods.org，该网站可能被我们大天朝墙了，这样下载安装可能会是龟速，幸好我们可以用淘宝的Ruby镜像来访问该网站，方法如下：
gem sources --remove https:
gem sources -a http:
成功后，使用以下命令查看：
gem sources -l
可以看到替换镜像成功：
CURRENT SOURCES ***
接下来是真正的安装，在终端输入以下命令：
sudo gem install cocoapods
安装输出非常长，这里就不贴出来了。
然后使用setup命令配置CocoaPods（这个命令也可以不运行，但是第一次使用pod命令时这个setup过程也会自动执行）
1.AppledeMacBook-Pro:~
apple$ pod setup
up CocoaPods master repo
completed (read-only access)
这个时间可能比较长，耐心等待下。
使用CocoaPods为工程配置第三方类库
首先打开Xcode新建一个工程，假设为Desktop/CocoaPodsDemo，并且我们要往该工程中导入AFNetworking这个类库。
AFNetworking在Github中的地址为：/AFNetworking/AFNetworking
这里也说明了如何使用CocoaPods配置该类库：
以上说明是我们应该如何书写Podfile文件。一般非常流行和成熟的类库都得到了CocoaPods的支持，并且有这个说明。
如何确定CocoaPods是否支持我们想要加入的目标类库？使用Search命令搜索类库名：
pod search AFNetworking
如果CocoaPods支持，将会输出搜索到的所有类库版本和信息，以及在Podfile中配置的写法，例如：
AFNetworking (2.1.0)
delightful iOS and OS X networking framework.
03.pod&'AFNetworking',&'~&
Homepage: https:
Source:&& https:
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
Sub specs:
AFNetworking/Serialization (2.1.0)
AFNetworking/Security (2.1.0)
AFNetworking/Reachability (2.1.0)
AFNetworking/NSURLConnection (2.1.0)
AFNetworking/NSURLSession (2.1.0)
AFNetworking/UIKit (2.1.0)
AFNetworking+AutoRetry (0.0.2)
Retries&for&AFNetworking
21.pod&'AFNetworking+AutoRetry',&'~&
Homepage: https:
Source:&& https:
Versions:&0.0.2,&0.0.1&[master
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',&'~&
Homepage: https:
Source:&& https:
Versions:&0.1.2,&0.1.1,&0.0.1&[master
AFNetworking-ReactiveCocoa (0.0.2)
AFNetworking reactive.
38.pod&'AFNetworking-ReactiveCocoa',&'~&
Homepage: https:
Source:&& https:
Versions:&0.0.2,&0.0.1&[master
AFNetworking-Synchronous (0.2.0)
45.Synchronous
requests&for&AFNetworking
46.pod&'AFNetworking-Synchronous',&'~&
Homepage: https:
Source:&& https:
Versions:&0.2.0,&0.1.0&[master
先看看普通的工程目录：
好吧，进入主题，首先在我们的工程目录下创建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.~&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&
在编辑完成后先按esc，再按“:”，输入wq保存并退出。
Podfile中的两句文字的意思是，当前AFNetworking支持的iOS最高版本是iOS 7.0, 要下载的AFNetworking版本是2.1。
也可以用文本编辑工具打开该文件进行编辑，命令如下：
-e Podfile
这里我同时为Demo安装AFNetworking，JSONKit和MBProgressHUD三个类库，Podfile文件内容如下：
1.platform:ios,&'7.0'&
2.pod&'AFNetworking',&'~&
3.pod&'JSONKit-NoWarning',&'~&
4.pod&'MBProgressHUD',&'~&
在有了Podfile后，输入以下命令安装类库：
pod install
安装完成后，输出信息如下：
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
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的配置文件，但是编译却出现错误，那么我们仅需要一行命令就可以配置好所有的第三方类库了：
pod update
参考Demo的项目地址：/UrbanApps/UAAppReviewManager
打开Demo的UAAppReviewManagerExample目录，可以发现少了一个xcworkspace文件，另外还有几个CocoaPods的配置文件在这里：
打开Podfile文件看看：
01.target&'UAAppReviewManagerExampleiOS'&do
02.platform
:ios,&'5.1'
03.pod&'UAAppReviewManager',
:path =&&'..'
06.target&'UAAppReviewManagerExampleMac'&do
07.platform
:osx,&'10.7'
08.pod&'UAAppReviewManager',
:path =&&'..'
platform表示类库支持的最高版本，该类库的target包括了iOS和Mac。而path指定了到上级目录去查找该类库的安装信息。
编译工程，将会出错，原因是我们没有将类库链接到工程中：
因此我们要用pod命令进行安装。cd到Example目录下执行pod install命令，将会报错：
pod install
2.Analyzing
dependencies
3.Fetching
podspec&for&`UAAppReviewManager`
Unable to satisfy the following requirements:
`UAAppReviewManager (from `..`)` required by `Podfile`
原因是要添加的类库已经有最新版本推出，而Podfile文件并没有更改其下载版本（Podfile文件过期），于是获取安装数据失败。
因此我们要用update命令获取最新版本的类库：
pod update
02.Analyzing
dependencies
03.Fetching
podspec&for&`UAAppReviewManager`
04.Downloading
dependencies
05.Installing
UAAppReviewManager (0.2.1)
06.Generating
Pods project
07.Integrating
client project
From now on use `UAAppReviewManagerExample.xcworkspace`.
同样地我们成功生成了xcworkspace文件：
再编译运行就没问题了。
当Cocoapods向项目中增加了一个第三方库的时候，不仅仅只是添加代码，由于每个第三方类库有不同的target，所以每次添加第三方库时，都会有几个文件被写入磁盘，包括Podfile.lock和Manifest.lock文件等。
其中Podfile.lock记录了需要被安装的pod的每个已安装的版本。如果你想知道已安装的pod是哪个版本，可以查看这个文件。
Manifest.lock是每次运行pod install时创建的Podfile.lock文件的副本。
&&相关文章推荐
* 以上用户言论只代表其个人观点，不代表CSDN网站的观点或立场
访问：2024714次
积分：18234
积分：18234
排名：第501名
原创：55篇
转载：884篇
评论：98条
(4)(1)(1)(15)(21)(4)(6)(42)(4)(1)(5)(2)(11)(18)(21)(43)(3)(4)(11)(5)(3)(2)(7)(2)(4)(39)(60)(24)(86)(118)(92)(2)(2)(2)(1)(5)(18)(3)(17)(20)(97)(59)(35)(20)(1)之前写了一篇&&，今天记录一下如何用Pods的方式来管理第三方库，包括Swift/Object-C的库。
在这之前请先查阅如何使用的，安装：&，安装遇到问题：。
好的，接下来回到我们的项目中，先把之前引用的五个库删掉，没错，就是下面选中的五个。
删除后记得把SexyGallery-Bridging-Header.h的桥接文件也删除，并将 Objective－C Bridging Header 的Value值也抹掉，如下图：
第一步：Cmmand＋空格，搜索"终端"，使用cd命令进入到我们项目的根目录,就是.xcodeproj文件的同级目录。
第二步：分为以下几个操作：
输入vim Podfile命令，添加并编辑Podfile文件。　
按i进入编辑，内容如下&
编辑完成按Esc键退出编辑，输入 :wq 回车
输入 Pod Install 命令下载第三方库，这里要多等一会，时间比较久。
　　安装成功后的截图：
第三步：找到我们的项目根目录，会发现多了如下文件及文件夹：
podfile里的内容就是在终端使用vim podfile编辑的内容，podfile.lock也可以用记事本打开查看，里面是一些依赖项内容，第三方库的版本号什么的。
OK，进项目看看，这时候就不要在打开.xcodeproj了，直接进入.xcworkspace工作空间。
看，引用的第三方库都在这里了！ SO COOL！&
使用：在需要使用第三方类库的viewcontroller的头部使用import导入相应的类，如下图
日更新： 使用pod install命令会一直卡在Updating local specs repositories，换下面命令就可正常pod第三方库：
pod install --verbose --no-repo-update
日更新：将cocospod版本更新到1.0后，使用pod install --verbose --no-repo-update命令会提示这些库没有使用到依赖的项目：。
解决办法：
将podfile里的内容替换为如下：
source '/CocoaPods/Specs.git'
platform :ios,'8.0'
use_frameworks!
target 'TargetName' to
pod 'AMap2DMap','~& 3.2.0'
pod 'AMapSearch'
pod 'MMDrawerController'
pod 'SwiftyJSON'
pod 'Alamofire'
pod 'MJExtension'
pod 'SwiftForms'
pod 'SDWebImage'
阅读(...) 评论()