iOS开发之Cocoapods

  • 前言

  • 什么是Cocoapods???

    答:在iOS开发中势必会用到一些第三方依赖库,比如大家都熟悉的ASIHttpRequest、AFNetworking、JSONKit等。使用这些第三方类库能极大的方便项目的开发,但是,集成这些依赖库需要我们手动去配置,例如集成ASIHttpRequest库时除了加入源码以外还需要手动去添加一些系统框架,比如CFNetwork、MobileCoreServices等,如果这些第三方库发生了更新,还需要手动去更新项目。这就显得非常麻烦。有麻烦自然有解决办法,CocoaPods就是为了解决这个问题而生的。通过CocoaPods,我们可以将第三方的依赖库统一管理起来,配置和更新只需要通过简单的几行命令即可完成,大大的提高了实际开发中的工作效率,使我们的主要精力集中到更重要的事情上去。

  • 安装Cocoapods

mac系统自带ruby环境,网上有的教程是让你重新装svm,然后利用rvm再装ruby,注意区分。

在此所有的操作都是在终端中操作。(终端设备电脑lunchpad里面)

1.因为Ruby的软件源rubygems.org被屏蔽了,所以要更换源

gem sources --add [https://gems.ruby-china.com/](https://gems.ruby-china.com/) --remove [https://rubygems.org/](https://rubygems.org/)

2.用淘宝的镜像代替(可以去掉)

这一步是因为国内有墙的限制,会造成安装cocoapods的过程变的十分慢,替换为淘宝的镜像速度会相对较快。
 gem sources -a https://ruby.taobao.org/

3.查看是否设置成功

gem sources -l

如果输出结果是如下这样,那说明这一步就成功了。
*** CURRENT SOURCES ***
http://ruby.taobao.org/

4.升级gem

sudo gemupdate--system

5.安装Cocoapods(试试前面的能不能省掉)

sudo gem install cocoapods

6.更换repo镜像为国内服务器

pod repo remove master
pod repo add master https://gitcafe.com/akuandev/Specs.git
pod repo update

7.初始化第三方库

pod setup

7.查看Cocoapods是否支持某个类库,只要能够查询到框架就表明这个这台电脑Cocoapods已经安装成功。

pod search 类库名
支持模糊查询(如:AFNetworking),如果下面显示出AFNetworking框架的各个版本就代表Cocoapods安装完成。

8.以后更新第三方库

pod repo update 

可能碰到的问题

1、ERROR: While executing gem ... (Errno::EACCES) Permission denied - /Users/xxxxx/.gemrc

 可以用sudo chown -R xxxx /Users/xxxx/.gemrc解决

2、pod search 搜索库的时候报错Unable to find a specification for xxxxx
解决方法:在终端执行这两句代码,然后重新安装pod,在进行搜索。

 pod repo remove master  
 pod setup

3.安装的时候报错说selected xcode error
解决方法:运行这句代码,然后重新安装

sudo xcode-select -switch /Applications/Xcode.app/
Cocoapods相当于一款软件,在电脑上安装成功以后,以后就可以直接使用他来给项目集成框架。不需要重复上面的操作。
  • 具体在项目中如何使用Cocoapods

    • 我们通过集成MJRefresh类库来演示如何使用CocoaPods来做依赖库管理。首先,建立一个xcode工程,命名为CocoaPodsTest,现在的工程结构如下图所示。
正常情况下新建立的功能工程
1.关闭新建立的工程,打开终端
  • 检查SDWebImage是否支持Cocoapods,支持模糊查询
 pod search SDWebImage(在终端输入)
输入搜索的命令

行后通过输出结果可以看到mjrefresh是支持CocoaPods的,注意红框标记的内容,这是待会我们配置xcode时需要的信息,这条配置项就是告诉CocoaPods去下载和管理第三方库的哪一个版本。** 如果搜索过后最下面出现一个:,则直接点击q便可退出。

  • 左下角有一个冒号“ :”,一般把第一个 pod 'SDWebImage', '~>3.7.6'复制保存,再点击q退出(下面编辑会用)
执行后的结果
2.检测完毕后我们在终端里输入下面的代码。
cd +把工程拖进终端(自动生成一个路径)(当然你也可以进行查看输入psw或者ls)
自动生成我们需要的路径
3.管理第三方库的PodFile文件(也就是进行编辑)
vim Podfile(输入代码之后直接进行回车,会跳出来下面的代码框
复制之前保存的版本信息

先把1里面复制的版本代码复制下来放到第三行,再输入下面的代码,按照顺序输入

编辑内容
上面的解析
4.点击Esc退出编辑,再按 shift+; ,最后再按: wq 保存并退出文件。
5.pod install 在工程中安装我想要的框架
pod install

拓展:
--no-repo-update Skip running pod repo update before install: 只更新当前新的第三方,不会更新所有的第三方
Podfile.lock:第一次pod 就会自动生成这个文件,描述当前导入框架版本
pod install:根据Podfile.lock 去加载,第一次会根据podfile文件加载
pod update:去检查之前导入框架有没有新的版本,如果有新的版本就会去加载,并且更新 Podfile.lock
pod repo:管理第三方库的索引,去寻找有没有最新版本,有就记录

6.如果想继续添加框架,只需找到框架的版本号 放到建好的Podfile文件,通过 pod update 进行更新,更新之前要记得让你的终端处于你工程所在的目录下
7.将第三方库集成到项目中

如果之前的全部工作都完成了,工程目录下就会有一个Podfile文件了,注意必须和.xcodeproj在同一个目录下。

最后工程生成的

会多出一个名为Pods的依赖工程,打开/Pods/Pods文件夹后,能找到我们在Podfile写的各种第三方库。

8.至此用Cocoapods管理第三方框架的所有工作做完。

如果需要依赖多个第三方类库,只需要修改Podfile文件的配置,然后运行pod update命令即可,比如新增一个AFNetworking的依赖库,首先执行pod search AFNetworking查看一下AFNetworking的配置信息,修改Podfile文件,在后面增加AFNetworking的对应配置信息,然后运行pod update命令就完成了对AFNetworking的集成。

进入当前文件夹
  • 1、pod search 框架名 找到版本号 pod 'AFNetworking', '~> 3.1.0'
  • 2、cd 你工程所在的目录, 通过pwd查看当前终端所在的路径
  • 3、vim Podfile 1.点击i进入编辑状态 2、写内容 3、esc退出编辑,4、:wq保存退出
    编辑的内容:platform :ios, ‘7.0‘
    
    target "卡顿测试" do
    
    pod 'SDWebImage', '~> 3.7.6'
    
    end
    
  • 4、pod install 在工程中安装我想要的框架
  • 5、如果想继续添加框架,只需找到框架的版本号 放到建好的Podfile文件,通过pod update进行更新,更新之前要记得让你的终端处于你工程所在的目录下
vim Podfile的vim指令

经验之谈

如果在使用cocopods的过程中出现很多的问题,你可以尝试下面的3步骤

1.升级gem

  sudo gem update--system

2.安装Cocoapods

 sudo gem install cocoapods

3.初始化第三方库

pod setup

声明:使用CocoaPods来添加第三方类库,无论是执行pod install还是pod update都卡在了Analyzing dependencies不动

解决办法: 终端执行下面的代码

 pod repo update

为他人的安装cocopods的经验

CocoaPods安装 详细
CocoaPods pod install/pod update更新慢的问题
Cocoapods常用命令及介绍
CocoaPods管理本地库
CocoaPods更新本地仓库的master的下载:下载完直接 command + shift + G 输入 ~/.cocoapods/repos替换掉master就好
升级cocoapods踩坑

9、后续补充

  • 9.1、 升级cocoapods到制定版本

    查看cocoapods有多少个版本

    gem list
    

    卸载 cocoapods

    sudo gem uninstall cocoapods -n /usr/local/bin
    

    安装指定 1.7.2 版本的 Cocoapods

    sudo gem install cocoapods -v 1.7.2
    

    安装指定 最新 版本的 Cocoapods

    sudo gem install cocoapods -n /usr/local/bin
    

    查看 cocoapods 版本

    pod --version
    

10、pod update 报错处理

  • 10.1、[!] Failed to connect to GitHub to update the CocoaPods/Specs specs repo - Please check if you are offline, or that GitHub is down.

    解决方案:sudo gem install -n /usr/local/bin cocoapods

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,214评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,307评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,543评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,221评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,224评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,007评论 1 284
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,313评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,956评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,441评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,925评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,018评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,685评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,234评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,240评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,464评论 1 261
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,467评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,762评论 2 345

推荐阅读更多精彩内容