CocoaPods的安装和使用教程

CocoaPods简介

每种语言发展到一个阶段,就会出现相应的依赖管理工具,例如Java语言的Maven,node.js的npm。随着iOS开发者的增多,业界也出现了为iOS程序提供依赖管理的工具,它的名字叫做:CocoaPods。
CocoaPods项目的源码在Github上管理。该项目开始于2011年8月12日,经过多年发展,现在已经成为iOS开发事实上的依赖管理标准工具。开发iOS项目不可避免地要使用第三方开源库,CocoaPods的出现使得我们可以节省设置和更新第三方开源库的时间。

在没有使用CocoaPods以前,我需要:
把这些第三方开源库的源代码文件复制到项目中,或者设置成git的submodule。
对于这些开源库通常需要依赖系统的一些framework,我需要手工地将这些framework一一增加到项目依赖中,比如通常情况下,一个网络库就需要增加以下framework: CFNetwork, SystemConfiguration, MobileCoreServices, CoreGraphics, zlib。
对于某些开源库,我还需要设置-licucore或者 -fno-objc-arc等编译参数管理这些依赖包的更新。

这些体力活虽然简单,但毫无技术含量并且浪费时间。

在使用CocoaPods之后,我只需要将用到的第三方开源库放到一个名为Podfile的文件中,然后执行pod install,CocoaPods就会自动将这些第三方开源库的源码下载下来,并且为我的工程设置好相应的系统依赖和编译参数。

一、CocoaPods 的安装

CocoaPods是用Ruby实现的,要想使用它首先需要有Ruby的环境。幸运的是macOS系统默认的已经可以运行Ruby了,因此我们只需要执行以下命令。

  • 更换 Gem 的源

Gem是一个管理Ruby库和程序的标准包,它通过Ruby Gem(如 http://rubygems.org/ )源来查找、安装、升级和卸载软件包

// 移除掉原有的源(服务器在国外,速度较慢)
gem sources --remove https://rubygems.org
// 等有反应之后再敲入以下命令(添加国内的源https://gems.ruby-china.com/)
gem sources -a https://gems.ruby-china.com
// 验证是否替换成功
gem sources -l
  • 更新升级 Gem 版本

Gem是管理Ruby库和程序的标准包,如果它的版本过低也可能导致安装失败,解决方案自然是升级Gem,执行下述命令即可:

// 更新升级gem
sudo gem update --system
//查看gem版本
gem -v
  • 安装CocoaPods

// 安装CocoaPods(OS X 10.11以前)
sudo gem install cocoapods
// 安装CocoaPods(10.11后苹果升级了安全策略)
sudo gem install -n /usr/local/bin cocoapods
  • 配置CocoaPods

所有的项目的podspec文件都托管在https://github.com/CocoaPods/Specs。 第一次执行pod setup时,CocoaPods 会将这些podspec索引文件更新到本地的 ~/.cocoapods/目录下,这个索引文件比较大,有 250M 左右。所以第一次更新时非常慢,一定要耐心的等。这步其实是 Cocoapods 在将它的信息下载到 ~/.cocoapods目录下,如果你等太久,可以试着新建一个终端 cd 到 ~/.cocoapods目录下,用du -sh *来查看下载进度。

//将CocoaPods 的信息下载到 ~/.cocoapods目录下(Setting up CocoaPods master repo 会卡在这里很久)
pod setup
//cd 到 ~/.cocoapods目录下
cd ~/.cocoapods 
//查看下载进度
du -sh *

二、CocoaPods 的使用

使用时需要在你的项目根目录下新建一个名为Podfile的文件,将依赖的库名字依次列在文件中即可

  • 进入工程文件夹

以TestCocoaPod项目为例子

//进入TestCocoaPods工程文件夹 
cd /Users/iCoder/Desktop/TestCocoaPods
AAEC76BC-A3FA-4A18-BB63-E2D083BA8E5E.png
  • 创建编辑一个Podfile文件

输入命令vim Podfile,要导入的第三方都要在这里面写上。进去后需要先按I键进入编辑状态,写完后按esc,然后按:wq就可以保存退出了

//输入命令vim Podfile 接着按一下I进入编辑模式
vim Podfile
F8F5E2ED-CAC5-47F8-9EEC-17520461CDB6.png

例如我们要导入AFNetworking,Podfile的格式如下

//ios小写 TestCocoaPods是你的工程名字 
platform :ios,'8.0'
target 'TestCocoaPods' do
pod 'AFNetworking'
end
1BC72785-8334-42F1-A454-8C6B126D8863.png
//按下esc,再输入:wq保存退出
:wq
2D4CBD30-2493-48FC-B534-1D97E2B5ED26.png
  • 执行安装命令

//执行pod install
pod install
20E1E3EF-C68D-47DB-8040-C184E703FC33.png
  • 打开项目

之前我们一直是双击TestCocoaPods.xcodeproj打开项目,以后我们双击TestCocoaPods.xcworkspace打开即可


23E63860-8822-4E54-8021-3D171D860063.png
  • 使用第三方

引入AFNetworking的头文件时,使用#import <AFNetworking.h>引入,使用#import "AFNetworking.h"不再有提示


BD14176A-DC7A-4FD6-BF5F-591927A5AC80.png
  • 添加或删除第三方

如果使用过程中我还想添加/删除其他的第三方怎么办,只要在Podfile里面添加/删除,然后终端再执行pod install就可以了
例如我要将AFNetworking删除,添加pop库
打开工程,找到Podfile文件,删除pod 'AFNetworking',添加pod 'pop'


09353315-B7D6-46FC-A67C-66A11E364F3F.png

打开终端,cd到工程目录,执行pod install

//进入工程目录
cd /Users/iCoder/Desktop/TestCocoaPods
//导入
pod install
E21170E4-820B-4093-92E0-4C4490681468.png

三、常见问题

  • pod install,pod update速度慢

出现原因:你本地的repo库太长时间没有更新了
解决办法:

pod repo update

原因在于当执行以上两个命令的时候会升级CocoaPods的specs仓库,如果不想在install、update的时候升级specs库,可以使用参数忽略掉

pod install --no-repo-update
pod update --no-repo-update
  • 导入Swift类库

导入Swift语言编写的类库时需要加use_frameworks!,下面以导入Alamofire为例:

platform :ios, '8.0'
use_frameworks!
pod 'Alamofire'

四、参考资料

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容