cocopods的使用方法

虽然网上关于CocoaPods安装教程多不胜数,但是我在安装的过程中还是出现了很多错误,所以大家可以照下来步骤装一下,我相信会很好用.

前言

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

什么是CocoaPods

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

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

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

CocoaPods的核心组件

CocoaPods是用Ruby写的&＃xff0c;并划分成了若干个Gem包。

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

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

CocoaPods / Core&＃xff1a;Core gem提供了与CocoaPods相关的文件&＃xff08;主要是podfile和podspecs&＃xff09;的处理。 

Podfile&＃xff1a;该文件用于配置项目所需要的第三方库&＃xff0c;它可以被高度定制。本文中我们主要在这里做动作。

Podspec&＃xff1a;该文件描述了一个库将怎样被添加进工程中。.podspec文件可以标识该第三方库所需要的源码文件、依赖库、编译选项&＃xff0c;以及其他第三方库需要的配置。 

CocoaPods / Xcodeproj&＃xff1a;这个包负责处理工程文件&＃xff0c;它能创建以及修改.xcodeproj文件和.xcworkspace文件。它也可以作为一个独立的包使用&＃xff0c;当你要编写修改项目文件的脚本时&＃xff0c;可以考虑使用CocoaPods/Xcodeproj。

Cocoapods安装步骤

1、升级Ruby环境

终端输入&＃xff1a;$gem update --system

此时会出现

ERROR:  While executing gem ... (Gem::FilePermissionError)

    You don‘t have write permissions for the /Library/Ruby/Gems/2.0.0 directory.

zijingMacBook-Pro:~ shiyunlei$ sudo gem update —system

这个是因为你没有权限去更新Ruby

这个时候你可以在终端使用&＃xff1a;$sudo gem update —system来进行升级

这个时候表示Ruby升级完成。

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

1、gem sources --remove https://rubygems.org/

2、gem sources -a https://ruby.taobao.org/

可以使用下面的命令(红色部分)查看是否更换镜像成功&＃xff08;如下图所示&＃xff09;&＃xff1a;
$ gem sources -l

3、安装Cocoapods&＃xff0c;在终端输入命令

$sudo gem install cocoapods

这个时候会提示你输入密码&＃xff0c;注&＃xff1a;在终端输入密码不会有提示&＃xff0c;光标也不会移动&＃xff0c;一定要注意

开始安装&＃xff0c;如下图&＃xff1a;PS:这个过程可能花费时间比较长

安装成功如下&＃xff1a;

4、使用search命令搜索类库名&＃xff1a; 

$pod search AFNetworking

如果CocoaPods支持&＃xff0c;将会输出搜索到的所有类库版本和信息&＃xff0c;以及在Podfile中配置的写法&＃xff0c;终端返回信息如下&＃xff1a;

-> AFNetworking (2.3.1)

   A delightful iOS and OS X networking framework.

  pod ‘AFNetworking‘, ‘~> 2.3.1’&＃xff08;这个语句是需要在编辑Podfile的时候输入的命令&＃xff0c;即是如何安装下载相关类库的指令&＃xff09;

   - Homepage: https://github.com/AFNetworking/AFNetworking

   - Source:   https://github.com/AFNetworking/AFNetworking.git

   - Versions: 2.3.1, 2.3.0, 2.2.4, 2.2.3, 2.2.2, 2.2.1, 2.2.0, 2.1.0,

   2.0.3, 2.0.2, 2.0.1, 2.0.0, 2.0.0-RC3, 2.0.0-RC2, 2.0.0-RC1, 1.3.4, 1.3.3,

   1.3.2, 1.3.1, 1.3.0, 1.2.1, 1.2.0, 1.1.0, 1.0.1, 1.0, 1.0RC3, 1.0RC2, 1.0RC1,

   0.10.1, 0.10.0, 0.9.2, 0.9.1, 0.9.0, 0.7.0, 0.5.1 [master repo]

   - Sub specs:   - AFNetworking/Serialization (2.3.1)   -

   AFNetworking/Security (2.3.1)   - AFNetworking/Reachability (2.3.1)   -

   AFNetworking/NSURLConnection (2.3.1)   - AFNetworking/NSURLSession (2.3.1)

   - AFNetworking/UIKit (2.3.1)

-> AFNetworking&＃43;AutoRetry (0.0.5)

   Auto Retries for AFNetworking requests

   pod ‘AFNetworking&＃43;AutoRetry‘, ‘~> 0.0.5‘

   - Homepage: https://github.com/shaioz/AFNetworking-AutoRetry

   - Source:   https://github.com/shaioz/AFNetworking-AutoRetry.git

   - Versions: 0.0.5, 0.0.4, 0.0.3, 0.0.2, 0.0.1 [master repo]

5、需要在工程中创建一个Podfile文件&＃xff0c;

使用命令&＃xff1a;

$cd /Users/shiyunlei/Desktop/CocoapodsSample(进入工程目录&＃xff0c;cd后面的是工程的路径)

$ touch Podfile&＃xff08;创建Podfile文件&＃xff09;

然后使用vim编辑Podfile文件&＃xff0c;使用命令&＃xff1a;

$ vim Podfile
进入如下界面

然后紧接着按键盘上的“i”键&＃xff0c;变成如下状态&＃xff0c;这个时候可以对Podfile文件进行编辑&＃xff1a;

$platform:ios, ‘7.0‘

$ pod ‘AFNetworking‘, ‘~> 2.3.1‘

在编辑完成后按“esc”&＃xff0c;

在按“:”,这个时候输入wq,点击回车&＃xff0c;保存并退出。

这个时候打开Podfile文件就会看到里面添加了刚才在终端输入的一行语句&＃xff0c;如下图

然后在终端输入命令安装相应的第三方类库

$pod install

因为这个过程需要下载相应的类库&＃xff0c;所以时间和网速有关。

安装成功之后截图如下&＃xff1a;

这个时候会看到之后打开工程都需要从类型为工程名.xcworkspace文件打开。

史上最详细的CocoaPods安装教程