cocoapods官网：https://guides.cocoapods.org
一、什么是CocoaPods
每种语言发展到一个阶段，就会出现相应的依赖管理工具，例如 Java 语言的 Maven，nodejs 的 npm。随着 iOS 开发者的增多，业界也出现了为 iOS 程序提供依赖管理的工具，它的名字叫做：CocoaPods。CocoaPods项目的源码在 Github 上管理。该项目开始于 2011 年 8 月 12 日，经过多年发展，现在已经成为 iOS 开发的依赖管理标准工具。开发 iOS 项目不可避免地要使用第三方开源库，CocoaPods 的出现使得我们可以节省设置和更新第三方开源库的时间。
二、为什么要使用CocoaPods
在使用CocoaPods之前，开发项目需要用到第三方开源库的时候，我们需要把开源库的源代码复制到项目中，添加一些依赖框架和动态库，设置-ObjC，-fno-objc-arc等参数，管理他们的更新在使用CocoaPods后，我们只需要把用到的开源库放到一个名为Podfile的文件中，然后执行pod install/update就可以了，Cocoapods就会自动将这些第三方开源库的源码下载或更新下来，并且为我们的工程设置好相应的系统依赖和编译参数。
三、CocoaPods的原理
CocoaPods的原理是将所有的依赖库都放到另一个名为Pods的项目中，然后让主项目依赖Pods项目，这样，源码管理工作都从主项目移到了Pods项目中。Pods项目最终会编译成一个名为libPods.a的文件，主项目只需要依赖这个.a文件即可。
四、CocoaPods的安装
CocoaPods可以方便地通过Mac自带的RubyGems安装。
打开Terminal（Mac电脑自带的终端），
Terminal
然后按照以下提示操作：
1. 查看当前Ruby版本
ruby -v
显示如下:
ruby 2.5.3p105 (2018-10-18 revision 65156) [x86_64-darwin18]
2. 升级Ruby环境，首先需要安装rvm（第一步要下载一些东西，需要等几分钟）
curl -L get.rvm.io | bash -s stable
source ~/.bashrc
source ~/.bash_profile
3. 查看rvm版本
rvm -v
显示如下:
rvm 1.29.7 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]
4. 列出ruby可安装的版本信息
rvm list known
显示如下:
# MRI Rubies
[ruby-]1.8.6[-p420]
[ruby-]1.8.7[-head] # security released on head
[ruby-]1.9.1[-p431]
[ruby-]1.9.2[-p330]
[ruby-]1.9.3[-p551]
[ruby-]2.0.0[-p648]
[ruby-]2.1[.10]
[ruby-]2.2[.10]
[ruby-]2.3[.8]
[ruby-]2.4[.5]
[ruby-]2.5[.3]
[ruby-]2.6[.0] #(最新版本)
[ruby-]2.7[.0-preview3] #(预览版，不稳定，请慎用)
ruby-head
......
5. 安装一个ruby版本
这里我选择的是 2.6.0 版本，当然你也可以选择其他的。
rvm install 2.6.0
# 注意：安装过程中需要两次按下 Enter 键, 第二次按下后需要输入电脑访问密码(不可见，只管输入就行)；
# 如果你电脑没有安装 Xcode 和 Command Line Tools for Xcode 以及 Homebrew 会自动下载安装，建议提前安装这三者。
这里很多小伙伴会遇到错误，大部分是因为没有安装 Homebrew 造成，所以要提前安装好。
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
6. 设置默认版本
rvm use 2.6.0 --default
7. 设置ruby的软件源
这是因为ruby的软件源 rubygems.org 使用亚马逊的云服务，被我天朝屏蔽了，需要更新一下ruby的源，过程如下：
gem sources -l # 查看当前ruby的源
gem sources --remove https://rubygems.org/ # 移除当前ruby的源
gem sources -add https://gems.ruby-china.com/ # 设置当前ruby的源为我天朝的
gem sources -l # 再次查看当前ruby的源
如果 Terminal 输出：
*** CURRENT SOURCES ***
https://gems.ruby-china.com/
就证明ruby的软件源已经设置OK了。
8. 设置gem为最新版本
如果gem版本太旧，可以尝试用如下命令升级gem：
在Terminal输入以下命令：
sudo gem update --system
升级成功后会提示: Latest version currently installed. Aborting.
9. 正式开始安装CocoaPods
sudo gem install -n /usr/local/bin cocoapods
在最新版本macOS系统中不慎使用了sudo gem install cocoapods，如果报以下错误：
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/xcodeproj
就使用 sudo gem install -n /usr/local/bin cocoapods。
10. 如果安装了多个Xcode，就选择使用下面的命令（一般选择最近的Xcode版本）
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
11. 安装本地库
pod setup
12. 执行以上命令后
Setting up CocoaPods master repo
$ /usr/bin/git clone https://github.com/CocoaPods/Specs.git master --progress
Cloning into 'master'...
remote: Counting objects: 1879515, done.
remote: Compressing objects: 100% (321/321), done.
Receiving objects: 21% (404525/1879515), 73.70 MiB | 22.00 KiB/
然后就是漫长的等待，当然，网络好的情况下会更快。
要查看文件下载进度，可以另外再打开一个终端窗口 (快捷键：选中终端按下 Command+N 组合键)，输入以下两行命令回车执行
cd ~/.cocoapods
du -sh *
执行du -sh *之后会显示已下载的文件大小，可以多次执行来监看下载进度，如果之前还有文件大小，后来变成0了，可能是网络问题，下载已经中断了，需要结束命令并重新执行 pod setup。
安装成功后，你会看到: Setup completed
13. 查找第三方库，检查CocoaPods是否可用（第一次使用可能要等一会）
pod search DYFCodeScanner
五、Cocoapods的具体使用
新建一个Xcode工程，使用终端cd到工程目录下，创建Podfile文件：
pod init
之后就可以在项目目录里看到一个Podfile文件，打开Podfile文件：
open -e Podfile
添加和修改：
platform :ios, '8.0' #(注明你的开发平台以及版本，'8.0'忽略不写即为最新版本)
pod 'DYFCodeScanner', '~> 1.0.1' #('~> 1.0.1'为版本号，忽略不写即为最新版本)
一个QPlayer项目的Podfile文件的完整格式，例如：
platform :ios, '8.0'
target 'QPlayer' do
# use_frameworks!
# Pods for QPlayer
pod 'MJRefresh', '~> 3.1.12'
pod 'SVBlurView', '~> 0.0.1'
pod 'FDFullscreenPopGesture', '~> 1.1'
pod 'PYSearch', '~> 0.8.8'
pod 'MBProgressHUD+JDragon', '~> 0.0.3'
pod 'ZFPlayer', '~> 3.1.5'
pod 'ZFPlayer/ControlView'
pod 'ZFPlayer/AVPlayer'
# pod 'ZFPlayer/ijkplayer'
pod 'ZFPlayer/KSYMediaPlayer'
end
保存后退出，开始下载：
pod install
#(or pod install --no-repo-update --verbose)
这样，DYFCodeScanner就已经下载完成并且设置好了编译参数和依赖，以后使用的时候切记如下两点：
-
从此以后需要使用Cocoapods生成的 .xcworkspace文件来打开工程，而不是使用以前的.xcodeproj文件。
-
每次更改了Podfile文件，都需要重新执行一次
pod update或者pod update --no-repo-update --verbose命令。
查看CocoaPods版本
pod --version
关于 Podfile.lock
当你执行pod install之后，除了 Podfile 外，CocoaPods 还会生成一个名为Podfile.lock的文件，Podfile.lock 应该加入到版本控制里面，不应该把这个文件加入到.gitignore中。因为Podfile.lock会锁定当前各依赖库的版本，之后如果多次执行 pod install 不会更改版本，要pod update才会改Podfile.lock了。这样多人协作的时候，可以防止第三方库升级时造成大家各自的第三方库版本不一致。
如何使用CocoaPods的镜像索引:
所有项目的Podspec文件都托管在https://github.com/CocoaPods/Specs，第一次执行pod setup时，CocoaPods会将这些podspec索引文件更新到本地的~/.cocoapods目录下，这个索引文件比较大，所以第一次更新时非常慢，友好人士在国内的服务器建立了Cocoapods索引库的镜像，所以执行索引跟新操作时候会快很多，具体操作方法如下：
pod repo remove master
pod repo add master https://gitcafe.com/akuandev/Specs.git
pod repo update
这是使用gitcafe上的镜像，将以上代码中的 https://gitcafe.com/akuandev/Specs.git 替换成 http://git.oschina.net/akuandev/Specs.git 即可使用oschina上的镜像。
希望读到这的您能转发分享和关注一下我，以后还会更新技术干货，谢谢您的支持！
转发+点赞+关注，第一时间获取最新知识点。
最后祝大家生活愉快~
网友评论