CocoaPods 是什么?
CocoaPods是Swift和Objective-C可可项目的依赖管理员。它有超过37000个图书馆,并在超过260万的应用程序中使用。CocoaPods可以帮助您优化您的项目。
CocoaPods 的使用(不是安装)
1、检测你的MAC上是否安装 Pods。
打开你电脑上的终端,在终端里输入 :
pod --version
操作如图下图所示:
如果你的MAC上已安装 Pods,结果就会输出Pods的版本号。
2、CocoaPods 的更新版本。
如果经过第一步后,您发现您电脑上的Pods的版本过低。您可以使用下面命令进行更新,命令如下:
sudo gem update cocoaposd
操作如下图:
如图所示,在执行命令的过程中,终端会让你输入一个密码(这是命令 'sudo' 是以管理员的命令运行的,所以要开机密码)。如果你的是最新版本的Pods,就会提示 Nothing To Update。否则,它会更新Pods。
3、我们创建一个我们要使用Pods添加第三方库的Swift项目(Project)。
我们创建的项目叫 MyAlamofire。创建完工程后就退出Xocde。创建的项目如下图所示:
4、进入我们创建的工程的一级目录。
我们通过终端指令进入我们创建的MyAlamofire的一级目录。操作指令流程是:
5、创建 pods 的 Podfile文件
我们在我们项目(MyAlamofire)的一级目录创建 Podfile文件,操作流程如下:
命令执行后的文件 Podfile文件如下图:
6、我们查看我们的要导入的第三方库是否支持Pods和第三方库的版本。
我们在导入前,首先要检查Pods是否支持我们的要导入的第三方库。如果支持就获取目前的最新版本的导入指令。我们本以Alamofire第三方库的导入为操作如下:
如上图指令执行到最后,我用蓝色标记的一行指令,就是我们后面导入Alamofire的指令。该指令如下:
pod 'Alamofire', '~> 4.0.1'
然后我们使用指令:'q' 退出当前的收索。
7、我们打开我们创建的 Podfile文件,并介绍文件里面的内容。
我们打开我们创建的Podfile文件,使用的指令是:
vim Podfile
打开操作如下:
通过上面的指令,我们可以看到 Podfile 文件的内容:
我们对上面的图片上的内容进行说明:
- 1、 注释符号 "#"
# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'
# 号是注释符,就向我们的ios里面的 //。
# 号后面的内容是注释说明。
2、platform :ios, '9.0' 该行代码的作用是
这个代码的作用是告诉CocoaPods你的项目是使用 ios 9.0 .3、use_frameworks! 该行代码作用是:
因为在Swfit中不能使用静态库,我们要使用框架(FormWork)来替代静态库(.a)。所以:想要在Swift中使用CocoaPods,你必须明确的写出use_frameworks! 来选择使用框架。如果你忘了写这个,CocoaPods能检测到你使用使用Swift CocoaPods,你安装pods的时候就会报错。-
- target 'MyAlamofire' do 和 end之间就是填写我们要导入的第三方库的代码位置。其中:target 'MyAlamofireTests' do&end 和 target 'MyAlamofireUITests' do&end 就可以删除掉。
8、我们编辑我们创建的Podfile 文件。
我们开始编辑我们的Podfile文件,操作如下:
我们编辑后的最后结果是:
9、我们开始向工程里面导入Pods和第三方库
我们使用命令:
pod install
操作流程如下图所示:
分析上面的结果
- 一个温馨的提示,如下图;
意思是:请关闭你当前的工程,和以后在打开项目时使用MyAlamofire.xcworkspace工作空间打开管理工程。
MyAlamofire.xcworkspace 文件所在的位置入下图:
10 、我们打开我们创建的MyAlamofire的工程。
打开工程后的项目结构如下图所示:
通过上图,我们也能有看到我们编辑的 Podfile文件的内容。
11 、我们在工程中使用我们导入的Alamofire.
我们在项目的 ViewController.swift 里面导入Alamofire的头文件。代码如下:
import Alamofire
导入头文件后就会报错如下图:
报错的内容是:Cannot load underlying module for 'Alamofire' 。还有另一种报错方式是:File 'ViewController.swift' is part of module 'Alamofire'; ignoring import 的错误。他们的解决方法是:
在 项目的 【Build phases】下的 【Link Binary With Librarises】 的左下方有一个加号【+】。点击加号,选择 【Workspace】 下的一个【Alamofire.framework】的一个库。修复的流程如下:
在编辑项目就不会出错了。
11、我们在项目中简短对Alamofire的使用
我们在项目的ViewController.swift中对我们导入的Alamofire进行使用:
使用后我们发现还有错误出现,但是不影响我们的编译。但是就是请求不成功。改错是No such module 'Alamofire' 的红色标志。这个错误的出现是因为Alamofire的版本还没有完善。解决的方法是将Alamofire的版本降低为 4.0.0。解决的流程如下:
我们再次打开我们的工程查看我们是否更新成功:
从上图看我们更新成功。然后我们再次运行项目,发现错误没有了,请求也成功了,如下图所示: