一、安装CocoaPods
Mac系统已经默认安装好Ruby环境,如果你不确定自己系统中是否有Ruby的,可以在终端中输入命令行:ruby -v
查看当前ruby版本。如图:
确定以后,接下来就可以下载和安装CocoaPods,只需要一行命令。在Terminator(也就是终端)中输入以下命令:
sudo gem install cocoapods
但是,在终端中敲入这个命令之后,会发现半天没有任何反应。原因是那堵墙阻挡了cocoapods.org。
解决办法是,我们可以用淘宝或者阿里云的Ruby镜像来访问cocoapods。按照下面的顺序在终端中敲入依次敲入命令:
首先,检查ruby源:
$gem sources -l
默认情况下,终端应该返回如下信息:
*** CURRENT SOURCES ***
https://rubygems.org/
当然这个源在墙内是访问不到的。因此我们需要寻找一个可以在国内访问到的镜像。目前笔者找到的是http://rubygems-china.oss.aliyuncs.com这个阿里云的镜像,当然随着时间的推移,未来这个镜像也有可能无法访问了,到时候就只能重新寻找了。
确认镜像可用后,现在就要开始修改ruby源了。首先执行以下命令删除原来的ruby源:
$gem sources --remove https://rubygems.org/
执行命令后可在终端看见以下信息:
https://rubygems.org/ removed from sources
然后下一步添加你找到的可用的镜像源:
$gem sources -a https://ruby.taobao.org/ #(淘宝)
或者:
$gem sources -a http://rubygems-china.oss.aliyuncs.com #(阿里云)
gem sources -l #(再次查看当前ruby的源)
如果Terminal输出:
*** CURRENT SOURCES ***
https://ruby.taobao.org/
此时你就可以重新执行这一段开头的那句命令了:
$sudo gem install cocoapods
- 如果gem太老,可以尝试用如下命令升级gem:
在Terminal输入以下命令:
$sudo gem update --system
升级成功后会提示: Latest version currently installed. Aborting.
- 如果报以下错误:
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/xcodeproj
解决方案1:
执行下面的命令并重启
$sudo nvram boot-args="rootless=0"
$sudo reboot
重启之后, 执行这个命令检查
$sudo gem install cocoapods -V
如果依旧有错误,使用第二个方案
解决方案2:
$sudo gem install -n /usr/local/bin cocoapods
如果一切正常,你应该能看到一段安装进度,以及最后有一条信息:
xx gems installed
开始配置
$pod setup
还有一点需要注意,pod setup
在执行时,会输出Setting up CocoaPods master repo
,但是会等待比较久的时间。这步其实是 Cocoapods
在将它的信息下载到 ~/.cocoapods
目录下,如果你等太久,可以试着 cd 到那个目录,用du -sh *
来查看下载进度。
安装成功后,你会看到:Setup completed
二、使用CocoaPods
打开终端,使用cd命令定位到需要使用CocoaPods的项目根路径。如:
cd /Users/username/ Projects/Demo
先考虑项目中需要引用哪些库,然后在通过search命令来查找库的信息,如需要加入JSONKit,那可以如下写法:
pod search JSONKit
命令执行后会得到如下结果:
-> JSONKit (1.5pre)
A Very High Performance Objective-C JSON Library.
pod 'JSONKit', '~> 1.5pre'
- Homepage: https://github.com/johnezang/JSONKit
- Source: https://github.com/johnezang/JSONKit.git
- Versions: 1.5pre, 1.4 [master repo]
其中的pod 'JSONKit', '~> 1.5pre'
是待会要写入到Podfile
中的信息。如果已经知道这些信息,那可以直接省略此步。直接进行下面的步骤。
得到必要的库信息后,现在需要在项目中建立Podfile文件。通过下面的命令:
touch Podfile
然后编辑Podfile文件,命令如下:
open -e Podfile
在弹出的编辑界面中输入下面内容:
platform :ios
pod 'JSONKit', '~> 1.5pre'
然后调用下面命令来进行初始化:
pod install
运行完毕后,原本的项目目录会多出一些文件。如图:
image.png文件目录中多了*.xcworkspace , pod
等文件。这是pod生成的项目管理文件,打开LibDemo.xcworkspace
项目文件,在Xcode里看到是这样的目录结构:
这里要注意的一点是,如果不调用创建Podfile命令就直接调用pod install
命令。将会提示“[!] No 'Podfile' found in the current working directory.”
如果Podfile中添加了新库,可以使用下面命令进行更新:
pod update
现在,你的所有第三方库都已经下载完成并且设置好了编译参数和依赖,你只需要记住如下2点即可:
-
使用CocoaPods生成的
.xcworkspace
文件来打开工程,而不是以前的.xcodeproj
文件。 -
每次更改了Podfile文件,你需要重新执行一次
pod install
或者pod update
命令 。
网友评论