前言
什么是CocoaPods?
CocoaPods是OS X和iOS下的一个第三类库管理工具,通过CocoaPods工具我们可以为项目添加被称为“Pods”的依赖库(这些类库必须是CocoaPods本身所支持的),并且可以轻松管理其版本。
Cocoapods意义体现在两个方面。
- 第一,在引入第三方库时它可以自动为我们完成各种各样的配置,包括配置编译阶段、连接器选项、甚至是ARC环境下的-fno-objc-arc配置等。
- 第二,使用CocoaPods可以很方便地查找新的第三方库,这些类库是比较“标准的”,而不是网上随便找到的,这样可以让我们找到真正好用的类库。
接下来我们将介绍CocoaPods的使用。
下载和安装CocoaPods
CocoaPods是用Ruby写的,所以运行需要安装Ruby环境。Mac中已经自带Ruby环境,这个不用我们担心,如果认为Ruby环境不够新,我们可以先更新,打开终端,输入以下命令:
- gem update --system
接下来我们可以安装CocoaPods了,在安装前,我们先做点小动作。
- 由于安装CocoaPods时我们要访问cocoapods.org,该网站可能被我们大天朝墙了,这样下载安装可能会是龟速,
幸好我们可以用淘宝的Ruby镜像来访问该网站,方法如下:
- $ gem sources --remove https://rubygems.org/
- $ gem sources -a http://ruby.taobao.org/
- 成功后,使用以下命令查看:
- $ gem sources -l
可以看到替换镜像成功:http://ruby.taobao.org/
接下来是真正的安装,在终端输入以下命令:
- $ sudo gem install cocoapods
安装输出非常长,这里就不贴出来了。
然后使用setup命令配置CocoaPods(这个命令也可以不运行,但是第一次使用pod命令时这个setup过程也会自动执行)
- 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命令搜索类库名:
- $ pod search AFNetworking
如果CocoaPods支持,将会输出搜索到的所有类库版本和信息,以及在Podfile中配置的写法,例如
- -> 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)
首先在我们的工程目录下创建Podfile文件,该文件用来控制CocoaPods的下载内容,该文件是没有后缀的,每个项目只需要一个Podfile文件;
创建过程:首先cd到工程目录,然后创建Podfile并且使用vim编写:
使用CocoaPods管理第三方库的步骤 在终端中输入步骤中所需的命令
1.先进入工程所在的文件夹
cd /Users/Documents/Desktop/Frame_test
2.创建 Podfile 文件
vim Podfile
3.进入编辑模式
在终端命令生成Podfile文件之后 按键盘上的字母 i 进入编辑模式
4.在终端进入编辑模式之后输入要用到的第三方库名称
比如:
platform:ios, ‘7.0‘
pod "AFNetworking", "~>2.1"
5.在将上述步骤完成之后
先按 esc键 之后是 :(说明按完esc 再输入冒号)接着是输入 wq(保存并退出);输入wq之后回车即可
6 导入生成 pod-- 输入pod install
pod install --verbose --no-repo-update
注意:在终端输入此命令时
将pod install 替换为 pod install --verbose --no-repo-update
安装完成后,输出信息如下:(有绿色文字提示:说明文件安装成功,在打开工程的时候直接打开:.xcworkspace的工程文件,不再打开原来的工程文件)
打开Build Phases,可以看到CocoaPods已经自动为我们完成了所有设置:
之后我们可以在工程中导入AFNetworking、JSONKit和MBProgressHUD的任意头文件并使用其所有接口了:
- #import "ViewController.h"
- #import <AFNetworking/AFNetworking.h>
- #import <JSONKit-NoWarning/JSONKit.h>
- #import <MBProgressHUD/MBProgressHUD.h>
新建Podfile文件并编写要导入的类库信息,打开终端输入pod install命令安装,完成。一切都是如此的方便。
补充
当Cocoapods向项目中增加了一个第三方库的时候,不仅仅只是添加代码,由于每个第三方类库有不同的target,所以每次添加第三方库时,都会有几个文件被写入磁盘,包括Podfile.lock和Manifest.lock文件等。
其中Podfile.lock记录了需要被安装的pod的每个已安装的版本。如果你想知道已安装的pod是哪个版本,可以查看这个文件。
Manifest.lock是每次运行pod install时创建的Podfile.lock文件的副本。