最新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。
- rvm 的项目官网:http://rvm.io/gemsets/basics
- CocoaPods项目的地址:https://github.com/CocoaPods/CocoaPods
- CocoaPods官方指南地址 https://guides.cocoapods.org
Ruby:
Ruby,一种简单快捷的 面向对象 ( 面向对象程序设计 ) 脚本语言 ,在20世纪90年代由日本人松本行弘( Yukihiro Matsumoto )开发,遵守 GPL 协议和Ruby License。
1 .安装并载入rvm环境
(1). 检查本地是否已安装rvm
打开终端,输入指令
$ rvm -v
1) 如果不存在,则会出现下面的情况:
如果不存在,先要进行安装一下;
( 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)
若出现以下错误时,在Podfile 文件中添加如下一行内容:
这是由于你多次移动你项目的路径,以至于再次update你的Podfile项目时,出现找不到工程路径的问题xcodeproj ‘你的工程名.xcodeproj’
3、进入项目时,再次打开,编译报错就消失了。安装完成!
CocoaPods工作原理
CocoaPods的工作主要是通过ProjectName.xcworkspace来组织的,在打开ProjectName.xcworkspace文件后,发现Xcode会多出一个Pods工程。它是将所有的依赖库都放到名为Pods项目中,然后让主项目依赖Pods项目,就这样,源码管理工作都从主项目移到了Pods项目中。