使用CocoaPods(一)为项目配置第三方类库

时间:2023-02-01 14:03:05

前言
在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环境不够新,我们可以先更新,打开终端,输入以下命令:

gem update –system  

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

由于安装CocoaPods时我们要访问cocoapods.org,该网站可能被我们大天朝墙了,这样下载安装可能会是龟速,幸好我们可以用淘宝的Ruby镜像来访问该网站,方法如下:(其中$后面的才是要输入的东西!!!)

[plain] view plaincopy

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

成功后,使用以下命令查看:

[plain] view plaincopy

$ gem sources -l  

可以看到替换镜像成功:

[plain] view plaincopy

* CURRENT SOURCES *  
  
http://ruby.taobao.org/  

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

[plain] view plaincopy

$ sudo gem install cocoapods  

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

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

[plain] view plaincopy

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

这个时间可能会比较长!!!!!!!有可能等的时间很长。耐心等待下。

使用CocoaPods为工程配置第三方类库
首先打开Xcode新建一个工程,假设为Desktop/CocoaPodsDemo,并且我们要往该工程中导入AFNetworking这个类库。
AFNetworking在Github中的地址为:https://github.com/AFNetworking/AFNetworking
这里也说明了如何使用CocoaPods配置该类库:

以上说明是我们应该如何书写Podfile文件。一般非常流行和成熟的类库都得到了CocoaPods的支持,并且有这个说明。
如何确定CocoaPods是否支持我们想要加入的目标类库?使用Search命令搜索类库名:

[plain] view plaincopy

$ pod search AFNetworking  

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

[plain] view plaincopy

-> AFNetworking (2.1.0)  
   A delightful iOS and OS X networking framework.  
   pod ‘AFNetworking’, ‘~> 2.1.0’  
   - Homepage: https://github.com/AFNetworking/AFNetworking  
   - Source:   https://github.com/AFNetworking/AFNetworking.git  
   - 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,  
   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,  
   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  
   repo]  
   - 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)  
   Auto Retries for AFNetworking requests  
   pod ‘AFNetworking+AutoRetry’, ‘~> 0.0.2’  
   - Homepage: https://github.com/shaioz/AFNetworking-AutoRetry  
   - Source:   https://github.com/shaioz/AFNetworking-AutoRetry.git  
   - Versions: 0.0.2, 0.0.1 [master repo]  
  
  
-> AFNetworking-RACExtensions (0.1.2)  
   AFNetworking-RACExtensions is a delightful extension to the AFNetworking  
   classes for iOS and Mac OS X.  
   pod ‘AFNetworking-RACExtensions’, ‘~> 0.1.2’  
   - Homepage: https://github.com/CodaFi/AFNetworking-RACExtensions  
   - Source:   https://github.com/CodaFi/AFNetworking-RACExtensions.git  
   - Versions: 0.1.2, 0.1.1, 0.0.1 [master repo]  
  
  
-> AFNetworking-ReactiveCocoa (0.0.2)  
   Make AFNetworking reactive.  
   pod ‘AFNetworking-ReactiveCocoa’, ‘~> 0.0.2’  
   - Homepage: https://github.com/uasi/AFNetworking-ReactiveCocoa  
   - Source:   https://github.com/uasi/AFNetworking-ReactiveCocoa.git  
   - Versions: 0.0.2, 0.0.1 [master repo]  
  
  
-> AFNetworking-Synchronous (0.2.0)  
   Synchronous requests for AFNetworking  
   pod ‘AFNetworking-Synchronous’, ‘~> 0.2.0’  
   - Homepage: https://github.com/paulmelnikow/AFNetworking-Synchronous  
   - Source:   https://github.com/paulmelnikow/AFNetworking-Synchronous.git  
   - Versions: 0.2.0, 0.1.0 [master repo]  

先看看普通的工程目录:


好吧,进入主题,首先在我们的工程目录下创建Podfile文件,该文件用来控制CocoaPods的下载内容,该文件是没有后缀的,每个项目只需要一个Podfile文件,如果需要导入多个类库那么统一在该文件中书写下载内容。
创建过程:首先cd到工程目录,然后创建Podfile并且使用vim编写:如何使用vim编写<在终端输入vim Podfile>然后回车,然后在出现的vim编辑器里面点击字母i,就可以进行编辑。
[plain] view plaincopy

AppledeMacBook-Pro:~ apple cdDesktop/CocoaPodsDemo/AppledeMacBookPro:CocoaPodsDemoapple  touch Podfile  

[plain] view plaincopy

platform:ios, ‘7.0’  
pod “AFNetworking”, “~>2.1”  
~                                                                                 
~                                                                                 
~                                                                                 
~                                                                                 
~                                                                                 
~                                                                                 
~                                                                                 
~                                                                                 
~                                                                                 
~                                                                                 
~                                                                                 
~                                                                                 
~                                                                                 
~                                                                                 
~                                                                                 
~                                                                                 
~                                                                                 
~                                                                                 
~                                                                                 
~                                                                                 
~                                                                                 
:wq  

在编辑完成后先按esc,再按“:”,输入wq保存并退出。
Podfile中的两句文字的意思是,当前AFNetworking支持的iOS最高版本是iOS 7.0, 要下载的AFNetworking版本是2.1。(目前的最高版本是2.3.1)

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

[plain] view plaincopy

open -e Podfile  

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

[plain] view plaincopy

platform:ios, ‘7.0’    
pod ‘AFNetworking’, ‘~> 2.1.0’  
pod ‘JSONKit-NoWarning’, ‘~> 1.1’  
pod ‘MBProgressHUD’, ‘~> 0.8’  

在有了Podfile后,输入以下命令安装类库:

[plain] view plaincopy

$ pod install  

安装完成后,输出信息如下:

[plain] view plaincopy

$ pod install  
Analyzing dependencies  
Downloading dependencies  
Installing AFNetworking (2.1.0)  
Installing JSONKit-NoWarning (1.1)  
Installing MBProgressHUD (0.8)  
Generating Pods project  
Integrating client project  
  
[!] From now on use CocoaPodsDemo.xcworkspace.  

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

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

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

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

[objc] view plaincopy

import “ViewController.h”  

import 

import 

import