欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  移动技术

史上最详细的CocoaPods安装教程(图文)

程序员文章站 2023-12-20 09:19:10
虽然网上关于cocoapods安装教程多不胜数,但是我在安装的过程中还是出现了很多错误,所以大家可以照下来步骤装一下,我相信会很好用. 前言 在ios项目中使用第三方类...

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

前言

在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安装步骤

1、升级ruby环境

终端输入:$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

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

史上最详细的CocoaPods安装教程(图文)

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

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

复制代码 代码如下:

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

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

史上最详细的CocoaPods安装教程(图文)

 

3、安装cocoapods,在终端输入命令

$sudo gem install cocoapods

这个时候会提示你输入密码,注:在终端输入密码不会有提示,光标也不会移动,一定要注意

开始安装,如下图:ps:这个过程可能花费时间比较长

史上最详细的CocoaPods安装教程(图文)

 

安装成功如下:

史上最详细的CocoaPods安装教程(图文)

 

4、使用search命令搜索类库名:

$pod search afnetworking

如果cocoapods支持,将会输出搜索到的所有类库版本和信息,以及在podfile中配置的写法,终端返回信息如下:

-> afnetworking (2.3.1)

a delightful ios and os x networking framework.

pod ‘afnetworking‘, ‘~> 2.3.1'(这个语句是需要在编辑podfile的时候输入的命令,即是如何安装下载相关类库的指令)

- 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+autoretry (0.0.5)

auto retries for afnetworking requests

pod ‘afnetworking+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文件,

使用命令:

$cd /users/shiyunlei/desktop/cocoapodssample(进入工程目录,cd后面的是工程的路径)

$ touch podfile(创建podfile文件)

史上最详细的CocoaPods安装教程(图文)

 

然后使用vim编辑podfile文件,使用命令:

$ vim podfile
进入如下界面

史上最详细的CocoaPods安装教程(图文)

 

然后紧接着按键盘上的“i”键,变成如下状态,这个时候可以对podfile文件进行编辑:

$platform:ios, ‘7.0‘

$ pod ‘afnetworking‘, ‘~> 2.3.1‘

在编辑完成后按“esc”,

史上最详细的CocoaPods安装教程(图文)

 

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

史上最详细的CocoaPods安装教程(图文)

 

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

史上最详细的CocoaPods安装教程(图文)

 

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

$pod install

史上最详细的CocoaPods安装教程(图文)

 

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

安装成功之后截图如下:

史上最详细的CocoaPods安装教程(图文)

 

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

史上最详细的CocoaPods安装教程(图文)

史上最详细的cocoapods安装教程就此结束了,如果还有什么疑问可以查看下面的相关文章。

上一篇:

下一篇: