1. CocoaPods的安装步骤
在安装CocoaPods之前,首先要在本地安装好Ruby环境,默认情况下,Mac自带Ruby环境。因为Ruby的默认源rubygems.org使用的是亚马逊的云服务,在国内使用会被墙,所以需要更换一下Ruby的源。
1.1 首先打开终端,输入以下命令符检查Ruby源
$ gem sources - l
如果你的镜像地址是如下图1-1所示:
图1-1
那么就需要替换Ruby源。
1.2 替换Ruby源,输入以下命令符,删除目前的Ruby源
$ gem sources --remove https://rubygems.org/
1.3 添加新的Ruby源,输入以下命令符:
$ gem sources -a https://gems.ruby-china.org/
之前使用的是以下这个
$ gem sources -a https://ruby.taobao.org/
但是这个已经不维护了,请查看相关信息。
1.4 添加新的Ruby源之后,可以查看是否替换成功
$ gem sources -l
成功就如图1-2所示:
图1-2
到这里就算已经成功配置完环境了,下一步就是安装了。
1.5 安装CocoaPods,继续在终端输入命令: 输入完命令后会要求输入用户密码
macOS 10.12以下使用的是
$ sudo gem install -n /usr/local/bin cocoapods
OS X 10.11以上使用的是
$ sudo gem install cocoapods
1.6 等待以上命令符执行完毕,继续输入以下命令:
$ pod setup
出现如图1-3所示:
图1-3
出现Setting up CocoaPods master repo 后会卡住一段时间,
可以在新开一个终端的窗口,输入以下的命令,查看下载文件的大小。
$ cd ~/.cocoapods
$ du -sh
下载完毕后,所占磁盘的大小在399M左右。下载过程需根据网络情况
1.7 下载成功,输入以下命令:
$ pod --version
可以看到安装成功cocoapods的版本。
1.8 如果遇到无法下载可能是Ruby版本较低,需要升级版本(请自行根据提示查找原因)
ERROR: Error installing cocoapods:
activesupport requires Ruby version >= 2.2.2.
终端输入:$gem update --system
如果此时终端出现如下提示:
ERROR:While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the /Library/Ruby/Gems/2.0.0 directory.
这个是因为你没有权限去更新Ruby
这个时候你需要在终端使用如下命令:
$ sudo gem update --system
运行后如果出现一下提示表明已经更新成功:
cocoapods卸载重新安装
$ sudo gem uninstall cocoapods //卸载
$ sudo gem install -n /usr/local/bin cocoapods //安装
或者 $ sudo gem install cocoapods
cocoapods卸载重装的例子参考。如果升级已有的cocoapods,则输入以下命令:
$ sudo gem update cocoapods //升级cocoapods
查看本地安装过的cocoapods相关东西,命令如下:
$ gem list --local | grep cocoapods
2. CocoaPods的使用
当CocoaPods安装完之后可以在输入一下命令开始添加第三方的框架了;该命令是查看AFNetworking
有哪些版本,pod search 第三方框架名称。
$ pod search AFNetworking
安装成功就会显示出相关的所有第三方开源类库。
2.1 怎么在项目中使用呢,首先需要在终端里面cd到项目文件夹里面,如下所示:
$ cd 项目文件夹路径 (可以直接把拖动项目文件夹到终端光标处,系统自动生成路径)
2.2 创建Podfile 文件
$ touch Podfile
2.3 编辑Podfile文件
$ vim Podfile
platform :ios, '8.0' #用来设置所有第三方库所支持的iOS最低版本
target 'MyApp' do #MyApp 就是你的项目名
pod 'AFNetworking', '~> 3.1.0'
pod 'SDWebImage', '~> 4.0.0'
end
12. 在编辑完后
按 esc, 然后按":"
这个时候输入wq 回车保存退出。
(版本号的规则:
'>1.0' 可以安装任何高于1.0的版本
'>=1.0' 可以安装任何高于或等于1.0的版本
'<1.0' 任何低于1.0的版本
'<=1.0' 任何低于或等于1.0的版本
'~>0.1' 任何高于或等于0.1的版本,但是不包含高于0.1的版本
'~>0' 任何版本,相当于不指定版本,默认采用最新版本号)
编辑Podfile文件之后, 按 i 可编辑 ,esc 退出编辑,:wq 可保存退出,:q 不保存退出。扩展Podfile语法参考
2.4 安装第三方开源类库
编辑Podfile文件之后,保存退出,然后终端输入命令:
$ pod install
2.5 更新第三方开源类库
以后需要添加、更新、删除某个第三方库,只要编写好Podfile文件,在终端输入:
$ pod update
之后运行就OK了。
如果升级某一个指定的第三方库,则输入以下命令:
$ pod update 第三方库名称
参考文章 Xcode 8.0和macOS 10.12以下安装CocoaPods的流程
参考文章 新版Cocoapods1.2.0简易教程
参考文章 Xcode 8.0安装CocoaPods
参考文章 Cocoapods安装步骤