CocoaPods是什么?
CocoaPods是使用非常广泛的iOS类库管理开发工具,用于iOS开发时第三方库的安装与管理。相较于手动导入的类库具有更方便,高效,简单,轻松等特点,不需要手动添加相关依赖库。尤其当第三方库进行更新时便于操作,一步更新,省去了一系列麻烦的操作。传送门:CocoaPods
CocoaPods is built with Ruby and is installable with the default Ruby available on OS X. We recommend you use the default ruby.
从这里可以看出,CocoaPods是通过Ruby
环境安装的。Mac OSX都有一个默认的Ruby
环境,一般来说可能需要首先升级Ruby
环境。
升级Ruby环境
安装RVM
curl -L get.rvm.io | -s stable
等待一段时间安装RVM
source ~/.bashrc
source ~/.bash_profile
测试是否安装成功
rvm -v
终端输出结果为rvm 1.29.3
,即表示成功。
用RVM升级Ruby环境,并查看当前的Ruby版本
ruby -v
ruby 1.8.7
#列出已知的ruby版本
rvm list known
#安装ruby 2.0.0
rvm install 2.0.0
安装完成后ruby -v
查看是否更新成功
Tips:在安装ruby
时,如果是10以下的系统,可能会遇到错误:Libraries missing for ruby-2.2.4: /usr/local/opt/gmp/lib/libgmp.10.dylib. Refer to your system manual for installing libraries
此时,需要更新以下环境,在终端输入:brew update && brew install gmp
更新环境,再次安装即可。
可能出现的错误
1、M1芯片:ERROR: While executing gem ... (Gem::FilePermissionError)
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
curl -L https://get.rvm.io | bash -s stable
rvm install ruby
sudo gem install -n /usr/local/bin cocoapods
2、ping不通github.com等
1、查询网站的真实ip
2、vim /etc/hosts
如果出现报错E45: 'readonly' option is set (add ! to override)
,则先:q!
强制退出, 然后使用sudo vim /etc/hosts
,需要输入密码。
安装CocoaPods
sudo gem install cocoapods
这样安装未必能成功,因为默认的CocoaPods网址是国外的,需要VPN才能访问。
但是我们可以用淘宝的Ruby镜像来访问CocoaPods。
按照下面的步骤敲入终端:
注意:source或者sources均可
gem sources –remove https://rubygems.org/
//等待有反应后加国内最新镜像源:
gem sources -a https://gems.ruby-china.com/
淘宝的Ruby镜像已经不更新了
(gem sources -a http://ruby.taobao.org/)
验证是否替换成功
gem source -l
终端返回下面信息表示成功
*** CURRENT SOURCES ***
https://gems.ruby-china.com/
更新Gem(OS X10.11之前与之后有个分割点,调用指令不对会报错)
Mac OS X 10.11之前:$ sudo gem update --system
Mac OS X 10.11之后:$ sudo gem update -n /usr/local/bin —system
最后,在终端运行安装:
OS X 10.11之前:sudo gem install cocoapods
OS X 10.11之后:sudo gem install -n /usr/local/bin cocoapods
pod setup
CocoaPods的使用
要使用CocoaPods,项目就需要一个Podfile文件。
首先,cd到项目文件夹
/Users/jason/Desktop/Test
为我创建的文件路径
cd /Users/jason/Desktop/Test
有两种方式创建Podfile文件
- 第一种创建方式
touch Podfile
vi Podfile
- 第二种创建方式
vim Podfile
在Podfile文件中进行添加第三方库
platform :ios, '10.0'
target 'Test' do
pod 'Masonry'
end
Tips:当是在终端直接进入Podfile文件,编辑时首先按
i
,当编辑完后,先输入:
,然后输入wq
,点击Enter
运行
最后一步进行安装第三方库
pod install
更新Pod库
pod repo update master
查找第三方库(以Masonry
为例),退出的话按wq
pod search Masonry
更新工程中的第三方库
pod update
如果遇到pod install
或者pod update
慢的问题,原因在于当执行以上两个命令的时候会升级CocoaPods
的spec
仓库,加一个参数可以省略这一步,然后速度就会提升不少
pod install --verbose --no-repo-update
pod update --verbose --no-repo-update
升级CocoaPods(升级CocoaPods版本的命令和安装CocoaPods的命令一样)
sudo gem install cocoapods
卸载CocoaPods
sudo gem uninstall cocoapods