最新CocoaPods安装与使用步骤详解

一、 CocoaPods简介

1、CocoaPods 是 iOS 最常用的第三方类库管理工具,可以解决库与库之间的依赖关系,有名的开源类库都支持 CocoaPods。
2、使用CocoaPods可以很方便地查找使用新的第三方库,这些类库是比较“标准的”,可以让我们方便快捷找到真正好用的类库。
3、CocoaPods 是用 ruby 实现的,要想使用它首先需要有 ruby 的环境。幸运的是macOS系统默认已经可以运行 ruby 了。
但是有时候 ruby 版本过低是无法正常支持 CocoaPods 的使用,所以需要先安装更新升级 rvm 和 ruby。

二、 CocoaPods安装过程

写在前面

1.安装需要用到Ruby,虽然Mac自带了Ruby,不过版本有点老了,最好选择更新一下。
2.查看当前Ruby版本,检查本地Mac是否 已经安装了。rvm (ruby version manager)命令。

引入概念:

RVM:
全称是 Ruby Version Manager ,是一款由 Wayne E. Seguin 开发的一款命令行工具。rvm 能够让你轻松的安装、管理 ruby 生产力环境,诸如不同版本的解释器和 gem。

1 .安装并载入rvm环境

(1). 检查本地是否已安装rvm

打开终端,输入指令
$ rvm -v
1) 如果不存在,则会出现下面的情况:

2)如果存在,则会打印rvm的版本信息:

如果不存在,先要进行安装一下;

( 2 ). 安装rvm

1)安装指令是
$ curl -L https://get.rvm.io | bash -s stable
按下回车即进入下载安装的状态,期间会自动通过homebrew安装依赖包.(Homebrew 是一个软件包管理器,用于在mac上安装一些macos 上没有的UNiX工具;类似于360软件管理器。)
等待一段时间就可以安装好Rvm。
2)载入RVM环境:
$ source ~/.rvm/scripts/rvm
3)检查是否安装成功:
$ rvm -v
下图即为安装成功后,显示的版本号

(3)RVM命令安装Ruby环境

1)查看当前ruby版本
$ ruby -v(检查当前版本,当ruby版本低于2.2.2时,安装cocoapods会报错)

2)查看所有ruby版本
$ rvm list known 查询当前所有已知的ruby环境。

如果版本低于2.2.2,请更新一下。vrm list known命令会查询所有的ruby版本,找到最高版本号进行安装;
若版本库里没有最新版本,输入:
$ rvm get head 升级到最新的存储库源版本
3)安装指定版本
输入指令:
$ rvm install 2.5.1 (选择较高版本),
然后根据提示按“enter”键,第二次按之后会提示你输入密码。
等待漫长的下载,编译过程,完成以后,Ruby, Ruby Gems 就自动安装好了。

4)查看已经安装的ruby版本
 $ rvm list

卸载一个已安装版本
$ rvm remove 2.5.1

2. 设置默认Ruby版本

安装好RVM之后可以指定特定Ruby版本为系统默认版本
输入命令:
$ rvm 2.5.01 - - default
也可以指定其他版本号,前提是有用rvm install 安装过那个版本

3. 检查更新ruby版本环境

cocoapods是用gem ruby实现的,想要使用它首先需要有gem ruby的环境。且Mac的macos系统默认已经可以运行ruby。
 (建议gem bury包环境升级到2.6.x以上。)

(1).检查gem ruby版本号:

$ ruby -v
$ gem -v
得到如下结果:

Gem是管理Ruby库和程序的标准包,如果它的版本过低也可能导致安装失败,解决的办法是更新gem版本

(2).更新gem ruby版本

$ gem update - -system 更新gem ruby版本号:

4.检查ruby源并移除。

(1)、检查ruby源

$ gem sources -l
检查ruby源,结果如下:


因为Ruby环境默认的的软件源rubygems.org被屏蔽了,国内那面永远需要翻 越的墙,你懂的~,我们需要来修改更换源,把源切换至ruby-china;

(2)、移除掉原有的源

$ gem sources - - remove https://rubygems.org/

(3)、添加国内最新的源。ruby-china

$ gem sources -a https://gems.ruby-china.com

这里注意一下https://gems.ruby-china.org 已经不能使用。后缀要改成com

(4)、检查是否添加成功

$ gem sources -l


到这里就已经把Ruby环境安装成功!接下来需要对cocoapods进行安装。

5. 安装CocoaPods

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

6. 查看是否安装成功并更新

(1)查看是否成功

$ pod - - version 查看pod版本

(2) 更新Podspec索引文件,创建本地索引库,如果没有报错,就说明一切安装成功了;这个过程需要一些时间。

$ pod setup

三、CocoaPods的使用

1、用Xcode创建(打开)一个工程,并创建podfile配置文件

(1)、进入项目目录

$ cd ~

在没有导入库时,项目中import库 会报错


(2)、创建Podfile文件

$ touch Podfile
创建一个podfile文件,然后打开编辑;
或是使用$ vi podfile 输入i进入编辑,编辑完成后按 esc 然后输入:wq 按回车键 ,保存并退出。

(3)、编辑Podfile文件。

我们可以在Podfile文件中写入需要用到的第三方库按如下格式:

platform :ios, '9.0'
use_frameworks!
target 'TestDemo' do
pod 'Alamofire', '~> 4.0.1'
pod 'Kingfisher', '~> 3.1.1'
end

Swift的pod文件在于use_frameworks! 这一句是必须的,作用是把三方库打包成静态库,而oc是不需要的。

另外,也可在github中找到所需要的库,里面有podfile格式内容

2、安装依赖库

$ pod install (后续添加框架可直接pod update)

标准是使用pod install或者pod update,但是这样会反应很慢
建议使用:

$ pod install --verbose --no-repo-update
$ pod update --verbose --no-repo-update

当执行标准命令的时候会升级CocoaPods的spec仓库,加一个参数可以省略这一步,然后速度就会提升不少。

若出现以下错误时,在Podfile 文件中添加如下一行内容:

xcodeproj ‘你的工程名.xcodeproj’

这是由于你多次移动你项目的路径,以至于再次update你的Podfile项目时,出现找不到工程路径的问题

3、进入项目时,再次打开,编译报错就消失了。安装完成!



CocoaPods工作原理

CocoaPods的工作主要是通过ProjectName.xcworkspace来组织的,在打开ProjectName.xcworkspace文件后,发现Xcode会多出一个Pods工程。它是将所有的依赖库都放到名为Pods项目中,然后让主项目依赖Pods项目,就这样,源码管理工作都从主项目移到了Pods项目中。

完结!!!

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

推荐阅读更多精彩内容