一.什么是CocoaPods?
CocoaPods是一个用来帮助我们管理第三方依赖库的工具。
它可以解决库与库之间的依赖关系,下载库的源代码,同时通过创建一个Xcode的workspace来将这些第三方库和我们的工程连接起来,供我们开发使用。
使用CocoaPods的目的是让我们能自动化的、集中的、直观的管理第三方开源库。
二.为什么需要CocoaPods?
在进行iOS开发的时候,总免不了使用第三方的开源库,比如AFNetworking、SDWebImage、SVProgressHUD等等。使用这些库的时候通常需要:
1.下载开源库的源代码并引入工程
2.向工程中添加开源库使用到的framework
3.解决开源库和开源库以及开源库和工程之间的依赖关系、检查重复添 加的framework等问题
4.如果开源库有更新的时候,还需要将工程中使用的开源库删除,重新执行前面的三个步骤,顿时头都大了。。。
自从有了CocoaPods以后,这些繁杂的工作就不再需要我们亲力亲为了,只需要我们做好少量的配置工作,CocoaPods会为我们做好一切!
三.安装CocoaPods
CocoaPods是用Ruby实现的,要想使用它首先需要有Ruby的环境。幸运的是OS X系统默认的已经可以运行Ruby了,因此我们只需要执行以下命令:
更换源:
Gem是一个管理Ruby库和程序的标准包,它通过Ruby Gem(如http://rubygems.org/)源来查找、安装、升级和卸载软件包
1.移除掉原有的源(服务器在国外,速度较慢)gem sources --remove https://rubygems.org
2.等有反应之后再敲入以下命令(添加国内的源)(前段时间,taobao.org源统一换成https协议了,请注意)
gem sources -a https://ruby.taobao.org
3.验证是否替换成功gem sources -l
2.更新升级gem:
gem是管理Ruby库和程序的标准包,如果它的版本过低也可能导致安装失败,解决方案自然是升级gem,执行下述命令即可:
更新升级sudo gem update --system
3.安装CocoaPods:
安装CocoaPods : sudo gem install cocoapods
4.更换repo镜像为国内服务器:
1.移除原有服务器 pod repo remove master
2.添加境内服务器(建议使用第一个)
pod repo add master https://gitcafe.com/akuandev/Specs.git
pod repo add master http://git.oschina.net/akuandev/Specs.git(开源中国较慢)
四.使用CocoaPods
如果之前做的一切顺利,接下来就可以体验体验CocoaPods的神奇之处了,需要经过以下几步:
1.初始化第三方库信息:
// 初始化 pod setup
以后更新第三方库信息:
// 更新 pod repo update
2.搜索:
// 搜索 pod search mjrefresh
copy 所需库的版本号等信息
3.新建Podfile:
cd /Users/shiyunlei/Desktop/CocoapodsSample(进入工程目录,cd后面的是工程的路径)
进入到工程的根目录下,使用
pod init
创建空白的Podfile文件,创建完毕的目录结构如下图
使用xcode打开这个文件
platform :ios, '8.0'
use_frameworks!
pod 'Alamofire', '~> 3.0'
然后在终端输入命令安装相应的第三方类库
$pod install
因为这个过程需要下载相应的类库,所以时间和网速有关。
安装成功之后截图如下:
这个时候会看到之后打开工程都需要从类型为工程名.xcworkspace文件打开。
5.编辑Podfile:
# Uncomment this line to define a global platform for your project
# platform :ios, '8.0'
# Uncomment this line if you're using Swift
use_frameworks!
target 'YourProjectName' do
pod 'SwiftyJSON', '~> 2.1'
pod 'SwiftSpinner', '~> 0.6'
pod 'Alamofire', '~> 1.1'
pod 'SuperRecord', '~> 1.2'
pod 'Toucan
// all other pods goes here
end
target 'YourProjectName' do
end
target 'YourProjectName' do
end
6.解析Podfile:
// 1.安装第三方框架pod install --verbose --no-repo-update// 2.升级第三方框架pod update
完成后,我们需要使用CocoaPodsTest.xcworkspace文件来开发。
对于工程发生的变化,有几点需要说明:
第三方库会被编译成静态库供我们正真的工程使用
CocoaPods会将所有的第三方库以target的方式组成一个名为Pods的工程,该工程就放在刚才新生成的Pods目录下。整个第三方库工程会生成一个名称为libPods.a的静态库提供给我们自己的CocoaPodsTest工程使用。
我们的工程和第三方库所在的工程会由一个新生成的workspace管理
为了方便我们直观的管理工程和第三方库,CocoaPodsTest工程和Pods工程会被以workspace的形式组织和管理,也就是我们刚才看到的CocoaPodsTest.xcworkspace文件。
原来的工程设置已经被更改了,这时候我们直接打开原来的工程文件去编译就会报错,只能使用新生成的workspace来进行项目管理。
5.常见问题解决
以后使用CocoaPods过程中出现了莫名其妙的问题,执行下面命令
-sudo gem update --system
-sudo gem install cocoa pods
-pod setup
网友评论