1.设置ruby的软件源
由于ruby的原始软件源rubygems.org被我大天朝屏蔽了,首先替换该软件源
gem sources --remove https://rubygems.org/
gem sources -a https://ruby.taobao.org/
验证软件源已经被替换
gem sources -l
如果成功替换,应显示如下内容
*** CURRENT SOURCES ***
https://ruby.taobao.org/
2.升级gem
sudo gem update --system
3.安装CocoaPods
sudo gem install cocoa pods
pod setup
在执行pod setup的时候,出现Setting up CocoaPods master repo,半天没有任何反应,还是因为我大天朝的那堵墙挡住了cocoapods.org。此时应当更换国内的服务器,gitcafe和oschina都是国内的服务器,可以用它们来作为CocoaPods索引库的镜像:
pod repo remove master
pod repo add master https://gitcafe.com/akuandev/Specs.git
pod repo update
如果想用oschina的镜像也可以把第二条命令换成http://git.oschina.net/akuandev/Specs.git 即可。
第二条命令执行的时候会比较耗时,因为这个时候要去把整个specs仓库clone到 ~/.cocoapods这里。可以cd到该目录里,用du -sh *命令查看文件大小来监视下载情况。
4.CocoaPods的使用
首先cd进入到你的工程根目录下,输入以下命令符
touch Podfile
该命令符用于创建一个名为Podfile的文件。(注意,不能写成其他名称)。
通过vim来编辑Podfile的内容(也可以通过文本编辑器)
vim Podfile
输入i进入编辑模式(终端下方会显示-- INSERT --字样),这里以添加AFNetworking为例
platform:ios,'7.0'
target "MyProject" do
pod 'AFNetworking', '~> 3.1.0'
use_frameworks! (swift项目需要加入该行)
end
其中MyProject是你的项目名称,platform的'7.0'要求当前第三方库最低支持IOS7.0版本。
~> 3.1.0的意思是AFNetworking的版本号要求在3.2.0以下(不含3.2.0),3.1.0以上(含3.1.0)。如果不写版本号,则默认为满足要求的最新版本。比如:
'~> 0.1.2' Version 0.1.2 and the versions up to 0.2, not including 0.2 and higher 0.2以下(不含0.2),0.1.2以上(含0.1.2)
'~> 0.1' Version 0.1 and the versions up to 1.0, not including 1.0 and higher 1.0以下(不含1.0),0.1以上(含0.1)
'~> 0' Version 0 and higher, this is basically the same as not having it. 0和以上,等于没有此约束
'3.1.0' 指定版本号为3.1.0
按下esc键,再输入:wq,保存并退出。
如果在输入vim Podfile敲完回车报错:Found a swap file by the name ".Podfile.swp"。Swap file ".Podfile.swp" already exists!
该问题是由于在vim操作期间,被强行关闭的原因,系统生成了.Podfile.swp文件,输入D键删除即可。
这时候,你就可以利用CocoPods下载AFNetworking类库了。还是在终端中的当前项目目录下,运行以下命令:
pod install
运行上述命令之后,终端出现以下信息:
EricmatoMacBook-Pro:CocoaPodsDemo ericwang$ pod install
Analyzing dependencies
Downloading dependencies
Installing AFNetworking (3.1.0)
Generating Pods project
Integrating client project
[!] From now on use `omega.xcworkspace`.
注意最后一句话,意思是:以后打开项目就用 omega.xcworkspace 打开,而不是之前的.xcodeproj文件。
你也许会郁闷,为什么会出现.xcodeproj文件呢。这正是你刚刚运行pod install命令产生的新文件。除了这个文件,你会发现还多了另外一个文件“Podfile.lock”和一个文件夹“Pods”。
到此为止,AFNetworking库已经被成功的加入到你的项目之中。
用Xcode打开项目,会发现framework下的框架全部是红字,不用管它,直接运行。
5.指令扩展
5.1 使用pod search指令查询第三方库
在终端中输入pod search AFNetworking(此处名称可以是模糊搜索),回车,则可搜索相关的类库信息,如下:
5.2 使用pod outdated指令查询第三方库更新信息
cd到项目根目录,输入pod outdated指令,可以查询当前已安装的所有三方库中,有没有最新版本的信息
5.3 pod install 和 pod update
假若你的Podfile中,关于AFNetworking是这么描述的:
pod 'AFNetworking', '~> 3.1.0'
而AFNetworking的最新版本已经升级至3.1.1。那么当你执行pod install的时候,CocoaPods并不会将AFNetworking升级至最新版本,而执行pod update语句操作时(pod update是对所有的第三方库进行检查并更新,你也可以通过pod update AFNetworking语句,单独更新AFNetworking。),CocoaPods将会把AFNetworking升级至3.1.1版本。
假若AFNetworking的描述变为:
pod 'AFNetworking', '3.1.0'
该语句指定了版本号为3.1.0,即使你执行了pod update操作,也并不会将AFNetworking升级至3.1.1,因为Podfile这段关于AFNetworking的描述,已经将版本号写死。
假如要用CocoaPods删除AFNetworking类库,只需删除Podfile中的pod 'AFNetworking', '~> 3.1.0'语句,然后执行pod install即可。
通常来说,除非要执行更新操作,否则类库的添加和删除,建议使用pod install。
有的时候使用CocoaPods来添加第三方类库,无论是执行pod install或是pod update会出现速度很慢的情况,原因在于当执行以上两个命令的时候会升级CocoaPods的spec仓库,加一个参数可以省略这一步,然后速度就会提升不少。加参数的命令如下:
pod install --verbose --no-repo-update
pod update --verbose --no-repo-update
6.关于CocoaPods上传服务器的相关问题
iOS开发中,使用CocosPods 框架管理工具会生成Podfile、Podfile.lock、Pods文件夹和.xcworkspace四个产物。
除了Podfile文件是必须要commit and push以外,其他都是可选的。Podfile.lock用于记录当前第三方库的版本号,可以不提交,不过提交这个的好处是,可以提醒团队里面的人,依赖库版本已经更新!
个人.gitignore的配置如下:
# 忽略Xcode本地用户配置信息
*.xcuserstate
*.xcuserdatad/
xcuserdata/
xcshareddata/
.metadata/
# 忽略`Pods/`和`Podfile.lock`
Pods/
Podfile.lock
如果想忽略*.xcworkspace添加即可。
7.下载别人源码打开报错的处理(项目使用了CocoaPods)
有的时候我们屁颠屁颠的从github上或者其他平台下载了一个源代码,正打算欣赏,打开却发现一堆报错,瞬间傻眼。不用着急,观察项目是否使用了CocoaPods,如果有,执行pod update命令符,再次build,你就会发现所有的报错都没了。