最近在开发一个新项目,使用上了三方库管理工具CocoaPods,关于CocoaPods不做过多介绍,网上已经有海量资源,在此梳理安装的初步使用的知识,顺便总结下碰到的坑。
一步一步……
1、查询Ruby的源
①为什么?
CocoaPods是使用Ruby语言编写而成,因此呢需要Ruby的环境,那是不是我们IOS开发者还需要搭建Ruby环境?很庆幸 OS X已经集成了Ruby环境,我们所需要做的就是通过gem指令进行CocoaPods的安装即可。
虽然Ruby环境已经搭建,但为了保证Ruby环境的可用性我们还是需要进行检测和确认的。
②执行
打开终端
输入:gem source -l (注意:l 不是数字1, 是'link'中的l)
查询结果如下
*** CURRENT SOURCES ***
查找到的源是在墙外(可能现在已经可以访问了,可自己去尝试),如果是墙外的话我们就需要改为墙内的,我们添加的源是淘宝的。
2、移除Ruby的源
①执行
gem source --removehttps://rubygems.org/
移除结果如下
http://rubygems.org/removed from sources
3、添加新的Ruby源——淘宝的Ruby源链接(链接协议改为了HTTPS)
①执行
gem source -ahttps://ruby.taobao.org/
添加结果如下:
https://ruby.taobao.org/added to sources
止于此,对源的操作就已经完成了,现在开始进行对CocoaPods的安装。
4、CocoaPods安装
①执行
sudo gem install cocoapods
运行之后需要输入电脑的密码,在输入过程中不会有密码输入的位数提醒,进入到安装过程中,在此我碰到了问题,如下:
=======================================
ERROR: While executing gem ... (Gem::DependencyError)
Unable to resolve dependencies: cocoapods requires cocoapods-core (= 0.33.1), claide (~> 0.6.1), cocoapods-downloader (~> 0.6.1), cocoapods-plugins (~> 0.2.0), cocoapods-try (~> 0.3.0), cocoapods-trunk (~> 0.1.1), nap (~> 0.7)
解决办法,你需要升级下你的ruby版本
gem update --system(注意:如果出现权限问题 FilePermissionError就加上sudo ,重新输入sudo gem update --system 然后执行)
=======================================
提示如下错误:
-bash: pod: command not found
然后进行重新安装
sudo gem install cocoapods
出现Error:
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/xcodeproj
需要将gem的默认路径重新修改:
mkdir -p $HOME/Software/ruby
export GEM_HOME=$HOME/Software/ruby
gem install cocoapods
[……]
gem installed
export PATH=$PATH:$HOME/Software/ruby/bin
最后进行一下验证
pod --version
打印出版本号,证明安装成功。
②上述命令安装完成后,输入以下命令,进行CocoaPods的建立
pod setup
如果上述命令运行成功,皆无错误即完成了CocoaPods的安装
4、CocoaPods的使用
启动Xcode创建一个工程,通过终端的doc命令进入到工程的根目录下,然后执行
pod init
完成后,在工程的根目录下会出现一个Podfile文件
对Podfile文件进行编辑(注意:不要用使用普通的文本编辑器进行编辑)
open -a Xcode Podfile
在文件中的@end上面,输入你要导入的框架,就可以了
pod 'AFNetworking'
如果完成之后,对文件保存,在终端环境下执行
pod install
等待其安装即可,也可以调用pod update方法,进行第三方库的安装。关闭工程,打开工程根目录下的workspace
6:其他部分
pod搜索功能
CocoaPods上的大部分第三方框架均来自于GitHub, 因此数量也很庞大,记名字是很不明智的,因此,我们可以选择通过搜索来找到自己想要寻找的第三方框架。
pod search 框架关键字, 如下:
pod search sdweb
通过搜索命令, 搜索到的内容如下图:
搜索结果
然后把你想要的框架的名字, 复制到Podfile文件中即可,Podfile文件中的第三方可以有多个, 需要几个,就填入几个,CocoaPods会全部帮你下载下来。
至此, 就完成了CocoaPods的创建和使用。