iOS安装CocoaPods详细过程

作者: my_杨哥 | 来源:发表于2017-01-02 00:48 被阅读98602次

简书《my_杨哥》原创,转载请联系作者获取授权
并标明文章作者及出处:http://www.jianshu.com/p/9e4e36ba8574
谢谢,有良知有道德的人!

一、简介

  • 什么是CocoaPods

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

  • CocoaPods的好处

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

Cocoapods.jpg

二、Cocoapods安装步骤

注意:在终端输入命令时,取$后面部分输入

1、升级Ruby环境

终端输入:$ gem update --system

此时会出现

没权限升级Ruby的提示

这是因为你没有权限去升级Ruby

这时应该输入:$ sudo gem update --system

此时会出现


输入密码

接下来输入密码,注意:输入密码的时候没有任何反应,光标也不会移动,你尽管输入就是了,输完了直接回车。
等一会如果出现


升级Ruby成功

恭喜你,升级Ruby成功了。

2、更换Ruby镜像

首先移除现有的Ruby镜像

终端输入:$ gem sources --remove https://rubygems.org/

然后添加国内最新镜像源(淘宝的Ruby镜像已经不更新了)

终端输入:$ gem sources -a https://gems.ruby-china.org/

执行完毕之后输入gem sources -l来查看当前镜像

终端输入:$ gem sources -l

如果结果是
*** CURRENT SOURCES ***
https://gems.ruby-china.org/
说明添加成功,否则继续执行$ gem source -a https://gems.ruby-china.org/来添加

3、安装CocoaPods

接下来开始安装

终端输入:$ sudo gem install cocoapods

如果出现这个


安装错误提示

说明没有权限,需要输入

终端输入:$ sudo gem install -n /usr/local/bin cocoapods

安装成功如下:


安装成功

到这之后再执行pod setup(PS:这个过程是漫长的,要有耐心)

终端输入:$ pod setup

然后你会看到出现了Setting up CocoaPods master repo,卡住不动了,说明Cocoapods在将它的信息下载到 ~/.cocoapods里。
你可以command+n新建一个终端窗口,执行cd ~/.cocoapods/进入到该文件夹下,然后执行du -sh *来查看文件大小,每隔几分钟查看一次,这个目录最终大小是900多M(我的是930M)
当出现Setup completed的时候说明已经完成了。

哈哈,太不容易了,终于走到这一步了,终于安装完成了,那么到底能不能用呢?咱们接着往下看!
注意:以上所有的步骤都是为这台电脑配置CocoaPods环境,以下才是真正的把CocoaPods安装到你的工程里面。

4、CocoaPods的使用

1、首先我们来搜索一下三方库
终端输入:$ pod search AFNetworking

这时有可能出现

搜索不到的提示
这是因为之前pod search的时候生成了缓存文件search_index.json
执行rm ~/Library/Caches/CocoaPods/search_index.json来删除该文件
然后再次输入pod search AFNetworking进行搜索
这时会提示Creating search index for spec repo 'master'..
等待一会将会出现搜索结果如下: AFNetworking搜索结果

出现这个了就说明搜索成功了,看一下上图中的这一句:
pod 'AFNetworking', '~> 3.1.0'
这句话一会我们要用到,这是CocoaPods添加三方库的关键字段
然后退出这个界面(这一步只是验证一下cocoapods有没有安装成功,能不能搜索到你想要的三方库),直接按"q"就退出去了。

如果搜索到的版本不是最新的,请查看iOS解决CocoaPods搜索不到最新版SDK的问题

2、在工程中创建一个Podfile文件

要想在你的工程中创建Podfile文件,必须先要进到该工程目录下

终端输入:$ cd /Users/liyang/Desktop/CocoaPodsTest
//这是我电脑上的路径,你输入你自己项目的路径或直接拖拽也行

进来之后就创建

终端输入:$ touch Podfile

然后你在你的工程目录下可以看到多了一个Podfile文件

3、编辑你想导入的第三方库的名称及版本

使用vim编辑Podfile文件

终端输入:$ vim Podfile

进入如下界面:


编辑Podfile文件

进来之后紧接着按键盘上的英文'i'
下面的"Podsfile" 0L, 0C将变成-- INSERT --
然后就可以编辑文字了,输入以下文字

platform :ios, '7.0'
target 'MyApp' do
pod 'AFNetworking', '~> 3.1.0'
end

解释一下
platform :ios, '7.0'代表当前AFNetworking支持的iOS最低版本是iOS 7.0,
'MyApp'就是你自己的工程名字,
pod 'AFNetworking', '~> 3.1.0'代表要下载的AFNetworking版本是3.1.0及以上版本,还可以去掉后面的'~> 3.1.0',直接写pod 'AFNetworking',这样代表下载的AFNetworking是最新版。

编辑完之后成如下样子:


编辑完成

此时该退出去了,怎么退出去呢?跟着我做,先按左上角的esc键,再按:键,再输入wq,点击回车,就保存并退出去了。

这时候,你会发现你的项目目录中名字为Podfile的文件的内容就是你刚刚输入的内容。

4、把该库下载到Xcode中
终端输入:$ pod install

这就开始下载了,需要一段时间,出现如下界面就说明安装好了


安装成功

这个时候关闭所有的Xcode窗口,再次打开工程目录会看到多了一个后缀名为.xcworkspace文件。


工程目录

以后打开工程就双击这个文件打开了,而不再是打开.xcodeproj文件。
进入工程后引入头文件不再是#import "AFNetworking.h",而是#import <AFNetworking.h>

终于完事了,快1点了,不求点赞,不求打赏,只求能帮助到更多的人!
如果哪里有什么不对或者不足的地方,还望读者多多提意见或建议😝

相关文章

  • 安装cocoapods

    咻咻。。。链接:最新cocoapods详细安装 - 简书 链接2:iOS安装CocoaPods详细过程 - 昨日微...

  • cocopod 安装使用

    iOS安装CocoaPods详细过程 一、简介 什么是CocoaPods CocoaPods是OS X和iOS下的...

  • cocoaPods详细安装教程

    iOS安装CocoaPods详细过程 一、简介 什么是CocoaPods CocoaPods是OS X和iOS下的...

  • 项目初始化相关

    CocoaPods使用 iOS安装CocoaPods详细过程参考地址:https://www.jianshu.co...

  • iOS安装CocoaPods详细过程

    原文iOS安装CocoaPods详细过程 公告!最新镜像源https://gems.ruby-china.com/...

  • iOS安装CocoaPods详细过程

    一、简介 什么是CocoaPods CocoaPods是OS X和iOS下的一个第三类库管理工具,通过CocoaP...

  • iOS安装CocoaPods详细过程

    一、Cocoapods安装步骤注意:在终端输入命令时,取$后面部分输入https://www.jianshu.co...

  • iOS安装CocoaPods详细过程

    现在iOS开发中很难离开CocoaPods了,换了新的电脑需要重新安装,记录一下过程以备今后查询。 1、升级Rub...

  • iOS安装CocoaPods详细过程

    一、简介 什么是CocoaPods CocoaPods是OS X和iOS下的一个第三类库管理工具,通过CocoaP...

  • iOS安装CocoaPods详细过程

    一、简介 什么是CocoaPods CocoaPods是OS X和iOS下的一个第三类库管理工具,通过CocoaP...

网友评论

  • 会飞的海豚哦:我在安装成功之后遇到一个问题,就是我打开新的工程文件后现实的是终端命令的界面,这是什么原因呢?
  • 布衣吖:目前看到的有关cocoapods文章中最舒服的一个:+1:
  • 夕儿77:比心
  • 山野武夫:一步到位,非常感谢楼主,特地登录来赞一个
    my_杨哥:@武哥 谢谢
  • 日落夕阳黄昏:电脑升级到最新的系统10.13.5后,pod setup
    -bash: pod: command not found
    这个是咋回事,另外一台电脑在低版本上能正常安装运行
    郑一一一一:蛋疼,一直以为是自己操作的问题。。
    meimeiDa:怎么解决的呢?
    我是派蒙:我的也是 你怎么解决的
  • 来敲代码:没毛病 中间切了次源 就ok了
  • 爱因乐:给力,我按照操作下来没毛病
  • tb_shi:第403个赞,坐等404
  • 好好爱自己llj:很实用,按照步骤一步一步就可以了:+1: :+1:
  • U9995:可以呀 小伙
  • 谢谢生活:sudo gem install cocoa pods 安装报错While executing gem ... (Errno::EPERM)
    Operation not permitted - /usr/bin/pod 后面pod setup的时候就报错Failed to connect to GitHub to update the CocoaPods/Specs specs repo - Please check if you are offline, or that GitHub is down 。。。。。是怎么回事 镜像路径没有变呢
    my_杨哥:看这个 https://www.jianshu.com/p/6577766dfa11
  • Buffoon_boy:卤煮,pod setup之后提示:Failed to connect to GitHub to update the CocoaPods/Specs specs repo - Please check if you are offline, or that GitHub is down?
    Buffoon_boy:@my_杨哥 谢谢,已经解决了:smile:
    谢谢生活:@my_杨 谢谢,之前是公司网络环境的问题。网络太差了。
    my_杨哥:看这个 https://www.jianshu.com/p/6577766dfa11
  • 酷唧唧:感谢楼主
  • Mr_Felix:谢谢分享
  • 狼人王:Permission denied @ rb_sysopen - /Library/Ruby/Gems/2.3.0/cache/thor-0.20.0.gem
    这是啥错误啊楼主
  • 石头老张:谢谢,解决我遇到的所有的坑~
  • Hi_Alice:Setup completed 之后1.4G..... :mask:
    my_杨哥:可能现在更新了,东西多了,就大了:smile:
  • New_卡迪熊:感谢,都是一步到位
  • wlw_花田半亩:好的文章我顶一下,就是有木有好的镜像和能让下载速度更快就更好了,表示我公司这破网下载太慢了。
  • 4b8d8851f2b7:mark 感谢 现在在安装了
    my_杨哥:恭喜
  • 九林:我可以转载吗?
    九林:@my_杨哥 没问题
    my_杨哥:@九林 可以,不过必须在文章开头处标注作者名称以及原文链接
  • l宁采臣l:杨哥,这一步之后$ pod install出现一下内容:Analyzing dependencies
    [!] Unable to find a target named `MyApp`, did find `JiuQian`, `JiuQianTests`, and `JiuQianUITests`.
    打开xcode也没有看到.xcworkspace文件,请问这是什么问题
    my_杨哥:@l宁采臣l 把MyApp替换成JiuQian,MyApp是我电脑上的,应该换成你的项目的名字:joy:
    l宁采臣l:似的,我先$ cd /Users/lilujie/Desktop/JiuQian,然后$ ls -l,然后$ touch Podfile,然后$ vim Podfile,然后$ pod install,就出现了这个Analyzing dependencies
    [!] Unable to find a target named `MyApp`, did find `JiuQian`, `JiuQianTests`, and `JiuQianUITests`.
    my_杨哥:你是在你的项目文件夹下操作的吗?
  • 金银岛:很好,照着教程来一步两步,一步两步,完美运行,没毛病!:smile:
  • 闪现撞墙啦宝宝:玩么解决,赞大神!!!!!
    my_杨哥:@闪现撞墙啦宝宝 谢谢:stuck_out_tongue_closed_eyes:
  • 貓秋:最新安装发现淘宝的的确不行,LZ的这个可以,感谢LZ
  • 当一艘船沉入海底_8512:Analyzing dependencies
    [!] Unable to find a specification for `AFNetworking (~> 3.1.0)`
    我在编辑vim Podfile的时候这样报错怎么解决,求楼主解答
    my_杨哥:AFNetworking (~> 3.1.0)写错了,写成'AFNetworking', '~> 3.1.0'或者'AFNetworking'
  • 99c5d0506fdf:问下,如果xcode工程里有pod 而电脑上没有,我直接init 是不是就可以
    my_杨哥:@小青年_eb9c 应该是的,你试试😆
  • 欢乐的乐:刚开始学习ios,啥都不会,谢谢你的帮助:yum:
  • 啦卡啦啦卡:非常棒,安装的过程中没有遇到这么多的问题,特别顺利。
  • Roy_Gao:狠清晰明了,👍
  • 樊二哈:如果出现这个错误解决方案:
    ERROR: While executing gem … (Errno::EPERM)
    Operation not permitted - /usr/bin/pod

    解决方法:sudo gem install -n /usr/local/bin cocoapods –pre
  • S型身材的猪:讲一个我遇到的一个坑,当我执行pod setup时,停留时间特别长,也按照你的方式查询了进度,一直停留在60K,然后良久以后,出现
    [!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master --progress

    Cloning into 'master'...
    fatal: unable to access 'https://github.com/CocoaPods/Specs.git/': LibreSSL SSL_read: SSL_ERROR_SYSCALL, errno 60
    这样的错误,网上找了下办法,1.查询代理: $ git config --global http.proxy ;2.取消代理:git config --global --unset http.proxy,再pod setup就行了
    my_杨哥:good👍
  • HanOBa:好人一生平安。
  • AutismGG:给力,写的很清晰
  • 西河老伯:感谢!
  • 2d78c416ccc8:MacBook-Pro:~ lc$ gem sources -l
    YAML safe loading is not available. Please upgrade psych to a version that supports safe loading (>= 2.0).
    *** CURRENT SOURCES ***

    https://gems.ruby-china.org/

    YAML safe loading is not available. Please upgrade psych to a version that supports safe loading (>= 2.0).
    ,楼主,求助,这个问题怎么升级
  • 我想我是海_395f:已成功,good!多谢~
  • 萝卜酱紫:应该添加上,工程卸载pod的流程
    my_杨哥:ok,会加上的:smile:
  • 落叶悠悠:终端输入:$ gem source -a https://gems.ruby-china.org/. 原文中的这句话少了一个s,这个sources
    落叶悠悠:@my_杨哥 NO,我只是今天要给自己电脑配置这个环境,刚好看了你的帖子,实际操作中发现的。写的很详细,多谢啦!
    my_杨哥:好细心!!
  • DF_1118:楼主 我想问问添加进去的第三方 在项目中的哪儿
    my_杨哥:就在项目的文件夹里啊
  • DF_1118:很好 很详细 多谢楼主
  • 3f830d0c2314:很棒!
  • 2168846716c3:不错
    my_杨哥:@井底之蛙嘚瑟 谢谢
  • 7a45b5f6be54:移除现有的Ruby镜像后,再添加就总是报错,怎么回事,ERROR: SSL verification error at depth 1: unable to get local issuer certificate (20)
    ERROR: You must add /O=Digital Signature Trust Co./CN=DST Root CA X3 to your local trusted store
    Error fetching https://gems.ruby-china.org:
    server did not return a valid file (https://gems.ruby-china.org/specs.4.8.gz)
    7a45b5f6be54:怎么解决这个问题?
  • CYC666:留下微信,给你打赏
    CYC666:@my_杨哥 并不会

    my_杨哥:直接在这打赏就好了啊,干嘛留微信呢:joy:
  • 逸风lovely:你好,如果要更新cocoapad版本怎么更新??
    my_杨哥:http://www.jianshu.com/p/50900e834895
  • 48d063e3b39b:sudo gem install -n /usr/local/bin cocoapods我输入这个 和sudo gem install cocoapods这个 。报同样的错误是怎么回事啊。先输入sudo gem install cocoapods。报错。后来按照你说的输出sudo gem install -n /usr/local/bin cocoapods 这个,还是报错。怎么搞
  • 48d063e3b39b:192:~ biwen$ gem sources -l
    *** CURRENT SOURCES ***

    https://gems.ruby-china.org/
    192:~ biwen$ sudo gem install cocoapods
    后面的就一直报错了 怎么回事啊



  • 假能干:为老哥点赞~~
    假能干:@my_杨哥 写的很好~值得点赞~~
    my_杨哥:@OldLogan 谢啦
  • 住册新账号:pod setup过程中断网了 怎么办
    住册新账号:@my_杨哥 谢谢~~真的是太慢了😢
    my_杨哥:连上网重新pod setup
  • e57cc080a686:开发了几款智能硬件,寻求app小伙伴,q:2⑦515303⑧⑨,注明:app伙伴
  • b95f0ca6ca78:写的不错很详细。赞一个
  • 55d3a977220f:请问
    esc : wq 之后 出现E45: 'readonly' option is set (add ! to override) 这是怎么回事啊
    55d3a977220f:@my_杨哥 恩恩,可以了 谢谢你了
    my_杨哥:在wq后面加个 ! 试试
  • Coco小明:楼主 执行完 pod setup 下载很久后出现。 下面这个问题。怎么解决啊。
    [!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master --progress

    Cloning into 'master'...
    remote: Counting objects: 1263373, done.
    remote: Compressing objects: 100% (724/724), done.
    error: RPC failed; curl 56 SSLRead() return error -36 71.00 KiB/s
    fatal: The remote end hung up unexpectedly
    fatal: early EOF
    fatal: index-pack failed
    Coco小明:@my_杨哥 方便留个联系方式吗 我截图给你看。我已经卡了三天了 这一步
    Coco小明:@my_杨哥 后面已经出现$这个符号了。但是我进入到cocoapods文件夹下。里面没有master这个文件。 pods还是用不了 pod search AFNetworking 试了下。还是要重新下载master
    my_杨哥:这个应该是正在下载中吧,你按我写的步骤看一下下载了多少了
  • 苏旋律:请问,在pod setup这步。
    [!] /usr/bin/git -C /Users/glf/.cocoapods/repos/master fetch --unshallow

    error: RPC failed; curl 56 SSLRead() return error -36
    fatal: The remote end hung up unexpectedly
    fatal: early EOF
    fatal: index-pack failed
    查看大小才468m,这是什么情况?
    my_杨哥:@苏旋律 确保前面的过程都完成了,然后再执行一下pod setup试试
    苏旋律:@my_杨哥 没有成功啊,出现刚才给你看的错误啊。
    my_杨哥:成功了吗?出现Setup completed了吗?
  • 小锤子_:很好,写的
    my_杨哥:@肖申克的小锤子 谢谢
  • 小胖子2号:楼主好棒。。。。特别详细。
    my_杨哥:@小胖子2号 谢谢
  • Kakarrot:写的很好 赞
    my_杨哥:谢谢
  • 需要药:赞啊,很实用
    my_杨哥:谢谢
  • 47ebcceb8a4b:大神,执行“sudo gem install cocoapods”报错:ERROR: While executing gem ... (Gem::DependencyError)
    Unable to resolve dependencies: cocoapods requires cocoapods-core (= 1.2.1), cocoapods-downloader (< 2.0, >= 1.1.3), cocoapods-trunk (< 2.0, >= 1.2.0), molinillo (~> 0.5.7), xcodeproj (< 2.0, >= 1.4.4), colored2 (~> 3.1), ruby-macho (~> 1.1)
    my_杨哥:@天亮说早安 嗯嗯,好了就行
    47ebcceb8a4b:@my_杨哥 是因为没有更新gem。。现在好啦:relaxed:
    my_杨哥:@天亮说早安 你再仔细看看文章中的那一步,接着往下看
  • Abnerzj:楼主,第二步更换镜像应该放到第一步前面,否则会很慢一直卡在那。:smile:
  • iDog:老铁 set up 之后报了这个错误 帮忙瞅瞅
    Setting up CocoaPods master repo
    $ /usr/bin/git clone https://github.com/CocoaPods/Specs.git master --progress
    Cloning into 'master'...
    fatal: unable to access 'https://github.com/CocoaPods/Specs.git/': Could not resolve host: github.com
    [!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master --progress

    Cloning into 'master'...
    fatal: unable to access 'https://github.com/CocoaPods/Specs.git/': Could not resolve host: github.com
  • iDog:老铁 666 折腾了一上午淘宝源...
  • 252330655dca:楼主 执行完 pod setup 在等下载就出去了 回来之后 就这样了[!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master --progress

    Cloning into 'master'...
    remote: Counting objects: 1263373, done.
    remote: Compressing objects: 100% (724/724), done.
    error: RPC failed; curl 56 SSLRead() return error -36 71.00 KiB/s
    fatal: The remote end hung up unexpectedly
    fatal: early EOF
    fatal: index-pack failed
    252330655dca:@my_杨哥 应该是可以用了 我现在在下载networking了 多谢楼主
    252330655dca:@my_杨哥 有
    my_杨哥:出去了多长时间?可能还没下载完呢,看看你的终端最后一行末尾有“$”符号吗?
  • 夜生物:大神,ruby不能升级 报错 ERROR: While executing gem ... (OpenSSL::SSL::SSLError)
    hostname "upyun.gems.ruby-china.org" does not match the server certificate
    my_杨哥:@ChineseTiger 删掉其中一个试试,不行就换另一个
    夜生物:https://gems.ruby-china.org/
    http://gems.ruby-china.org/ 输出的这两个,刚开始我用的是https的那个,后来有人说把s去掉,就成这样了,现在有两个
    my_杨哥:执行一下 gem sources -l 看看输出什么?
  • GayLeague:这篇博客应该能应对大部分的安装问题了,安装过程没有博主那么坎坷,但是这篇博客也解决了几个关键问题,如果自己琢磨估计得个把小时,实际用时加上下载时间也就是几分钟
    my_杨哥:是的,并不是所有人都能遇到我遇到的问题,我只是把有可能遇到的问题列举出来以便你们解决,如果顺利几分钟就能完事,其实挺简单:smile:
  • Maj_sunshine:点赞 帮了我个大忙 :smiley:
    Maj_sunshine:http 可以 https 不成功 不知道为什么:joy:
    my_杨哥:@学污直径 怎么不行?
    Maj_sunshine:我用的源是http://gems.ruby-china.org https我不行
  • 郎腾: 1000个赞
    my_杨哥:@郎腾 谢谢!
  • 菊上一枝梅:👍太棒
    胡子来了:――― TEMPLATE END ――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――

    [!] Oh no, an error occurred.

    Search for existing GitHub issues similar to yours:
    https://github.com/CocoaPods/CocoaPods/search?q=Malformed+version+number+string+&type=Issues

    If none exists, create a ticket, with the template displayed above, on:
    https://github.com/CocoaPods/CocoaPods/issues/new

    Be sure to first read the contributing guide for details on how to properly submit a ticket:
    https://github.com/CocoaPods/CocoaPods/blob/master/CONTRIBUTING.md

    Don't forget to anonymize any private data!

    报这个错误
    井空烀地瓜:66666备注个 我遇到的问题, 如果安装完xcode 一定要先把xcode打开之后再安装 cocoapods 要不会提示你git版本低
    my_杨哥:@Regret_V 谢谢

本文标题:iOS安装CocoaPods详细过程

本文链接:https://www.haomeiwen.com/subject/lazvvttx.html