一、前言
1.1、CocoaPods是什么？
它是一个专为Xcode工程（项目）所需第三方包的一个包依赖管理工具！类似于Java的Maven、Android的JCenter、Node的npm、yarn，工作职责都是一样。
1.2、一定需要这个工具么？
理论上并不是必需的，但实际上却是必需的！特别是苹果开发者（因为都涉及到Xcode来开发）。
1.3、手动引入第三方开源库的步骤
- 将开源库源码复制到项目中；
- 添加依赖框架和动态库；
- 手动配置（编译阶段、连接器选项），设置ARC环境下的-ObjC，-fno-objc-arc等参数；
- 管理该库的版本更新；
- 若该库还涉及到其它第三方，请重复以上步骤；
1.4、CocoaPods的目的
CocoaPods旨在改善第三方开源Cocoa库的参与度和可发现性，这些项目目标影响并推动了CocoaPods的设计：
- 创建和共享库，并在项目中使用它们，而无需为库作者创建额外的工作；
- 集成非CocoaPods库，并使用简单的透明Podspec标准在任何CocoaPods库的自己的分支上进行破解；
- 允许库作者按自己的喜好构建库；
- 通过自动执行许多与其库功能无关的Xcode工作，为库作者节省时间；
- 支持任何源代码管理工具（目前支持的是git， svn，mercurial，bazaar，和各类可通过HTTP下载）；
- 促进在Pod上进行分布式协作的文化，但也提供只有通过集中式解决方案才能培养社区的功能；
- 在核心Cocoa开发系统之上构建工具，包括通常部署到其他操作系统（例如Web服务）的工具；
- 提供有目的且自动的集成，但使其完全可选，您可以根据需要将CocoaPods依赖项手动集成到Xcode项目中，无论有无工作区；
- 为Cocoa和Xcode开发人员解决日常问题；
1.5、CocoaPods给我们带来的好处
- 该工具是开源的，在GitHub上可查；
- 通过CocoaPods配置文件，可方便引入所需第三方开源库；
- 第三方库版本管理简单，升级容易；
- 方便查找第三方库（官网 or 命令行）；
- 一般的项目都是团队合作，团队成员只需安装该工具就能完成第三方库引入（无需每人都做1.3中的步骤）；
- 制作公共库，并发布至CocoaPods上，其他人可方便使用；
二、CocoaPods安装
CocoaPods是由Ruby开发的，因此，在macOS上安装需要安装Ruby。
在正式安装以下工具时，建议先保证 xcode、xcode-select 都安装OK！
- xcode 可以通过 App Store来更新；
- xcode-select 可以通过命令行来执行： $ xcode-select --install
2.1、HomeBrew
Homebrew是一款Mac OS平台下的软件包管理工具，拥有安装、卸载、更新、查看、搜索等很多实用的功能。简单的一条指令，就可以实现包管理，而不用你关心各种依赖和文件路径的情况，十分方便快捷。所以我们需要下载Homebrew来安装Ruby。
- 安装HomeBrew
$ /bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
- 卸载HomeBrew
$ cd `brew --prefix`
$ rm -rf Cellar
$ brew prune
$ rm `git ls-files`
$ rm -r Library/Homebrew Library/Aliases Library/Formula Library/Contributions
$ rm -rf .git
$ rm -rf ~/Library/Caches/Homebrew
- HomeBrew使用
查看Homebrew命令：brew help
安装任意包：brew install <packageName> // eg：brew install node
卸载任意包：brew uninstall <packageName> // eg：brew uninstall git
查询可用包：brew search <packageName>
查询已安装包列表：brew list
查看任意包信息：brew info <packageName>
更新Homebrew：brew update
Homebrew帮助信息：brew -h
查看brew版本：brew -v
更新brew版本：brew update
整理重复语句：open ~/.zshrc -e、open ~/.bash_profile -e
2.2、安装Ruby
macOS都自带Ruby，不过版本可能比较低。
$ sudo brew install ruby // 强烈建议升级ruby至最新
安装完成后，系统中就有了RubyGems这个东东，它是Ruby的高级包管理器（Sophisticated Package Manager）。Ruby还有另一个工具：RVM（Ruby Version Manager）。
// 查看Ruby源
$ gem source -l
*** CURRENT SOURCES ***
https://rubygems.org/
// 移除现有源
$ gem source --remove https://rubygems.org/
// 添加新源（国内Ruby镜像）
$ gem source -a https://gems.ruby-china.com/
2.3、安装CocoaPods
$ sudo gem install cocoapods
(
如果报错 =====>
ERROR: While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the /usr/bin directory.
改用如下命令：
sudo gem install -n /usr/local/bin cocoapods
)
// 安装成功后，还需执行一条命令才大功告成
$ pod setup
// 有时 cocoapods 安装也会有问题
~/.cocoapods/repos 可能没有生成，所以我们只能手动：
$ mkdir -p ~/.cocoapods/repos
$ cd ~/.cocoapods/repos
$ git clone https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git
$ pod setup
三、创建Pod项目
3.1、查找第三方包“AFNetworking”
$ pod search AFNetworking
-> AFNetworking (4.0.1)
A delightful networking framework for Apple platforms.
pod 'AFNetworking', '~> 4.0.1'
- Homepage: https://github.com/AFNetworking/AFNetworking
- Source: https://github.com/AFNetworking/AFNetworking.git
- Versions: 4.0.1, 4.0.0, 3.2.1, 3.2.0, 3.1.0, 3.0.4, 3.0.3, 3.0.2, 3.0.1, 3.0.0, 3.0.0-beta.3, 3.0.0-beta.2,
3.0.0-beta.1, 2.7.0, 2.6.3,2.6.2, 2.6.1, 2.6.0, 2.5.4, 2.5.3, 2.5.2, 2.5.1, 2.5.0, 2.4.1, 2.4.0, 2.3.1, 2.3.0,
2.2.4, 2.2.3, 2.2.2, 2.2.1, 2.2.0, 2.1.0, 2.0.3,2.0.2, 2.0.1, 2.0.0, 2.0.0-RC3, 2.0.0-RC2, 2.0.0-RC1, 1.3.4,
1.3.3, 1.3.2, 1.3.1, 1.3.0, 1.2.1, 1.2.0, 1.1.0, 1.0.1, 1.0, 1.0RC3, 1.0RC2,1.0RC1, 0.10.1, 0.10.0, 0.9.2, 0.9.1,
0.9.0, 0.7.0, 0.5.1 [trunk repo]
- Subspecs:
- AFNetworking/Serialization (4.0.1)
- AFNetworking/Security (4.0.1)
- AFNetworking/Reachability (4.0.1)
- AFNetworking/NSURLSession (4.0.1)
- AFNetworking/UIKit (4.0.1)
-> 其它版本
:
// control + z 退出即可
3.2、创建工程及Pod文件
// Xcode 创建工程 demo
// 在demo根目录下创建 Pod 文件
$ touch Podfile
3.3、配置第三方库（Podfile）
# Define a global platform for your project
platform :ios, '9.0'
# 官方仓库地址
source 'https://github.com/CocoaPods/Specs.git'
target 'demo' do
# 开头4个空格
# 可以指定版本号 pod 'AFNetworking', '~> 4.0.1'
# 不指定版本号默认使用最新版本
pod 'AFNetworking'
end
3.4、安装第三方库
查看安装前目录结构
$ ls -l
total 8
-rw-r--r-- 1 chris staff 312 12 7 16:04 Podfile
drwxr-xr-x 9 chris staff 288 12 7 16:08 demo
drwxr-xr-x@ 5 chris staff 160 12 7 16:08 demo.xcodeproj
- 安装第三方依赖包
$ pod install
Analyzing dependencies
Downloading dependencies
Installing AFNetworking (4.0.0)
Generating Pods project
Integrating client project
[!] Please close any current Xcode sessions and use `demo.xcworkspace` for this
project from now on. Pod installation complete! There is 1 dependency from the
Podfile and 1 total pod installed.
- 查看安装后目录结构
$ ls -l
total 16
-rw-r--r-- 1 chris staff 312 12 7 16:04 Podfile
-rw-r--r-- 1 chris staff 798 12 7 16:11 Podfile.lock
drwxr-xr-x 8 chris staff 256 12 7 16:11 Pods
drwxr-xr-x 9 chris staff 288 12 7 16:08 demo
drwxr-xr-x@ 5 chris staff 160 12 7 16:11 demo.xcodeproj
drwxr-xr-x 3 chris staff 96 12 7 16:11 demo.xcworkspace
podproj.png
- 双击“demo.xcworkspace”，就能看到Pod管理的工程
proj-struct.png
