CocoaPods管理Xcode项目的库依赖项。
项目的依赖项在名为Podfile的单个文本文件中指定。CocoaPods将解析库之间的依赖关系,获取生成的源代码,然后在Xcode工作区中将它们链接在一起以构建项目。
最终目标是通过创建更加集中的生态系统来提高第三方开源库的可发现性和参与度。
CocoaPods是用Ruby构建的,它可以使用macOS上的默认Ruby进行安装。
(一)Cocoapods下载
终端输入"$"后面内容(以下一样)进行下载:
$ sudo gem install cocoapods
输入电脑密码回车下载,出现下载进度如图:
输入以下内容查看当前版本,此步骤可忽略:
$ pod --version
终端显示如图版本:(我这里版本是1.6.1)
输入以下内容设置仓库:
$ pod setup
出现设置仓库进度如图(等待时间很长):
如果不显示进度,你看到出现了Setting up CocoaPods master repo,卡住不动了,说明Cocoapods在将它的信息下载到 ~/.cocoapods里。 你可以command+n新建一个终端窗口,执行cd ~/.cocoapods/进入到该文件夹下,然后执行du -sh *来查看文件大小:(这里我已经下载了42M)
下载成功如下图:
(二)Cocoapods使用(AFNetworking)
终端输入要找的框架:
$ pod search AFNetworking
图片中第二行“-> AFNetworking (3.2.1)”是我们要用到的内容
然后退出当前终端搜索结果界面:直接按"q"就退出去!
在你的xcode项目中创建一个Podfile文件:
!!!要想在你的xcode项目中创建Podfile文件,必须先要进到该xcode项目目录下
终端输入:
$ cd 你的文件目录(添加框架都要进入你的项目目录并进到Podfile进行操作)
例如:(这是我电脑上的路径,你输入你自己项目的路径或直接拖拽也行
)
$ cd /Users/QQQ/Desktop/CocoapodsTest
创建Podfile:
终端输入:
$ touch Podfile
你的xcode工程多了一个Podfile文件如图:
导入的第三方库的名称及版本
终端输入:
$ vim Podfile
终端出现界面:
编辑Podfile文件
进来之后紧接着按键盘上的英文'i'键,界面的最后一行的"Podsfile" 0L, 0C将变成-- INSERT -- 然后就可以编辑文字了,输入以下文字:
platform :ios, '7.0'
target 'CocoapodsTest' do
pod 'AFNetworking', '~> 3.2.1'
end
解释一下 platform :ios, '7.0'代表当前AFNetworking支持的iOS最低版本是iOS 7.0, 'CocoapodsTest'就是你自己的工程名字, pod 'AFNetworking', '~> 3.2.1'代表要下载的AFNetworking版本是3.2.1及以上版本,还可以去掉后面的'~> 3.2.1',直接写pod 'AFNetworking',这样代表下载的AFNetworking是最新版。
编辑完之后成如下样子:
编辑完成退出该界面,先按左上角的esc键,(界面最后一行-- INSERT --消失)再按键盘“:”键(界面最后一行出现“:”),再输入wq(界面最后一行出现“:wq”),点击回车,就保存并退出去了回到操作界面。
把该库下载到Xcode中
终端输入:
$ pod install
出现如下界面
安装成功
这个时候关闭所有的Xcode窗口,再次打开工程目录会看到多了一个后缀名为.xcworkspace文件。
以后打开工程就双击这个文件打开了,而不再是打开.xcodeproj文件。 进入工程后引入头文件不再是#import "AFNetworking.h",而是#import
问题:
项目运行报错 :No such module 'AFNetworking'
解决:编辑Podfile, 增加:“use_frameworks!”
问题
[!] CocoaPods could not find compatible versions for pod "Alamofire":
In Podfile:
Alamofire
There are only pre-release versions available satisfying the following requirements:
'Alamofire', '>= 0'
You should explicitly specify the version in order to install a pre-release version
解决
$ sudo rm -fr ~/.cocoapods/repos/master
$ sudo rm -fr ~/Library/Caches/CocoaPods/
$ pod install
问题
删除库: 终端进入podFile文件 删除对应的库, 保存退出, 终端输入
$ pod install --verbose --no-repo-update
退出xcode, 重新打开项目
问题
执行
$ pod install
终端出现如下警告
[!] The version of CocoaPods used to generate the lockfile (1.7.5) is higher than the version of the current executable (1.6.1). Incompatibility issues may arise.
原因: CocoaPods版本低 , 需要更新CocoaPods
更新CocoaPods, 终端执行
$ pod repo update
---------------------------------------------------------------这是一条分割线---------------------------------------------------------------------------
更新指定第三方库
终端执行:
pod update 库名
只安装新增库,不更新已安装的库
pod install
把Podfile内全部的库更新重新安装
pod install --verbose --no-repo-update
该命令只安装新添加的库,已更新的库忽略
pod update 库名--verbose --no-repo-update
该命令只更新指定的库,其它库忽略
安装:
pod install :不会更新已经安装的库,需要安装或者移除新的pod 的时候使用
pod install --verbose --no-repo-update:作用与pod install一样,但是不会获取更新的pod specs
更新:
pod update:在没有指定pod库的版本的情况下,会去拉取已经存在的库的最新的版本。
pod update --verbose --no-repo-update:作用与pod update一样,但是不会获取更新的pod specs