Cocoapods 的使用
在项目开发过程中，我们常常会导入其他第三方库来方便我们更好更快的进行项目开发。Cocoapods是我们常用的第三方库管理工具，但是长久以来，我们大多数开发者只是使用它的导入、管理功能，对它并没有深入的了解。本文将详细介绍，如何安装、使用Cocoapods，并利用Cocoapods导入管理第三方库，以及如何使用Cocoapods创建一个自己的pod，并应用到我们以后的项目中。
一：Cocoapods工具的安装
1. 在你的终端输入命令： $ sudo gem install cocoapods 进行安装；
2. 如果出现安装失败，可能是因为镜像源的问题，替换镜像源方法如下：
// 删除原有的镜像源
$ gem sources --remove https://rubygems.org/
// 添加国内最新的镜像源(因为之前淘宝的那个好像不更新了)
$ gem source -a https://gems.ruby-china.org/
// 接着执行
$ gem sources -l
// 如果出现
> *** CURRENT SOURCES ***
>
> https://gems.ruby-china.org/
// 说明成功了，现在再来执行安装即可
$ sudo gem install cocoapods
注:如果安装时出现错误:Operation not permitted - /usr/bin/xcodeproj,使用如下命令安装:
$ sudo gem install -n /usr/local/bin cocoapods --pre
//检查你的cocoapods版本是否最新
$ pod --version
//更新版本，第一次安装不需要，如果你的mac已经安装过，检查版本不是最新，需要更新的方法
$ pod update
二：Cocoapods工具使用
1.导入第三方库到你的项目中之前，你需要对你的项目做些配置。第一就是创建Podfile文件：
找到你项目文件夹，打开可以看到没有导入pod的时候，如图：
在终端下，cd到你的项目文件路径下。在终端输入：cd 然后拖入你的项目文件夹如图：
创建Podfile文件，终端输入命令：vim Podfile 回车
输入 i 进入编辑模式，写入如下内容：
platform :ios, '8.0'
source 'https://github.com/CocoaPods/Specs.git'
target ‘此处为你项目名（如我的项目名为：CocoapodsDemo）’ do
#这里为你要导入的第三方部分等下介绍
end
如图：
然后，按esc,然后shift + ：，输入wq回车；（w 写入，q退出，wq写入并退出，就是将你刚编辑的内容保存，然后退出。此处命令不难，熟悉linux的，应该好接受）;
当然，创建Podfile文件也可以用另一种方法：
将你之前项目中的Podfile文件直接拖入你的项目中，然后使用编辑器打开，在里边直接编辑，然后command+s保存，再打开终端，cd到你的项目目录下，输入pod insatll ，安装即可。本人就是这么做的。为什么？为了防止......。好了，其实是为了方便，也是将命令方式变为可视化的方式，你安装过linux系统的话就应该知道，安装之前可以选择是图像安装还是命令安装，也是为了方便。
2.好，还是把正规的来一遍，刚才说到你创建了Podfile文件，然后写好了主干部分，现在就是填入内容的时候，将你项目中需要的第三方导入。比如你需要导入AFN（AFNetwork），终端输入： pod search afn 回车，如图：
找到你要的第三方库，如图AFNetwork（0.1.0），然后复制 pod 'AFNetwork', '~> 0.1.0’，写入到你的Podfile中，保存退出；
所有命令如图：
导入成功，如图：
文件夹目录如图：
至此，第三方afn已经导入成功，其他第三方类同；
以后打开项目，如图点击：
三：创建pod
1.首先注册一个Cocoapods Trunk。
$ pod trunk register [Your-Email] '[Your-Name]' --description='[Your-Desc]'
> [Your-Email]: 任意邮件,推荐使用github Email
> [Your-Name]: 推荐使用github上使用的Name
> [Your-Desc]: 一个简单的描述，往往这个时候我们使用的是自己电脑的一个描述
如图：
根据提示去你邮箱激活。
// 注册完成后，你可以通过[pod trunk me]查看信息
$ pod trunk me
2.接下来可以创建一个pod了：（pod项目工程文件相当于你自己的库，用来发布到cocoapods上）
此处不介绍本地pod（也有人叫私有pod、私有库）了
远程pod的创建：
首先，使用github创建一个远程项目，并克隆到你本地。具体方法后期有时间，会专门写一个 （github、coding.net、码云的代码管理 ）文章。此处略过。后期这里会改成链接的。
给个注释吧：git是一个代码管理工具，github、coding.net 、码云都是代码托管平台。不懂的可以去查下，解释的很详细。
pod项目工程文件的创建：（创建pod项目工程文件）
如果你在2.这一步都已完成，并且验证通过，可以直接跳到第7.步进行之后的操作；
3.创建.podspec（如果你在第二步已经对.podspec进行了配置，这步跳过）(⚠️3-6步内容，主要是为了讲当你自己有了一个可以用的pod（即库）的时候，如何为你的库添加描述文件.podspec，并发布到cocoapods中的)
将你github的远程项目克隆到本地，我直接使用自己github中的了。
cd到你刚clone的项目下,然后输入命令：
$ pod spec create [NAME]
> [NAME]: podspec 名称，一般与你在git上创建的repository相同
// 如图：
创建完成后，配置.podspec内容：
这里讲下如何配置吧：
上边创建完.podspec后，会在你的本地项目文件下有一个.podspec文件，将原来内容替换掉：直接进去修改，或者使用命令修改都可以，如图：
下边是我的配置内容，可以参考：
// 创建pod索引库，固定写法,并且定义索引库的名字为s,后续通过s，就能拿到索引库
————————————————————————————————————————
Pod::Spec.new do |s|
#===== 名称、版本号、摘要=====
s.name = 'HaiLayoutPod'
s.version = '0.1.0'
s.summary ='summary HaiLayoutPod.'
#===== 详情 =====
s.description = <<-DESC
TODO: Add long description of the pod here.
DESC
#===== 仓库主页（你github或者其它git管理平台中，你这个项目对应的地址） =====
s.homepage = 'https://github.com/diankuanghuolong/HaiLayout'
#===== 许可 =====
s.license = { :type => 'MIT', :file => 'LICENSE' }
#===== 作者 =====
s.author = { 'diankuanghuolong' => '3243388139@qq.com' }
#===== 仓库源 =====
s.source = { :git => 'https://github.com/diankuanghuolong/HaiLayout.git', :tag => "#{s.version}" }
s.ios.deployment_target = '8.0'
#===== 源文件目录 =====
s.source_files = 'HaiLayoutPod/Classes/**/*'
# s.resource_bundles = {
# 'HaiLayoutPod' => ['HaiLayoutPod/Assets/*.png']
# }
# s.public_header_files = 'Pod/Classes/**/*.h'
# s.frameworks = 'UIKit', 'MapKit'
# s.dependency 'AFNetworking', '~> 2.3'
end
———————————————————————————————————————————
然后在你的pod（HaiLayoutPod项目中commit，保证远程和本地同步）。
！！！一定要这么做，否则，你远程的spec文件中版本号可能未更新到最新，或者你新添加的source_file未更新进去。
4.远程项目的设置
如果你clone下来的项目已经满足需要，则不需要修改；如果，你要在你刚clone的项目中添加或者修改内容的话，则在本地修改后commit。具体方法，会在（github、coding.net、码云的代码管理）中介绍。
5.给自己仓库绑定Tag,因为cocoapods是根据代码仓库的Tag,去下载对应Tag的远程代码库的。（如果你在第二步已经做了操作，这步跳过）
这里再对tag做个介绍吧：我们平时提交的代码在origin/master下是动态的，而tag相当于你某次提交的那个版本的代码，是静态的。你的pod当然要是静态的了。这个可以自己去查，就不赘述了。
先将你的pod文件提交到git代码管理平台中（github），作为远程：
这里一定要先添加远程，下边有一个验证spec的方法，pod spec lint这个方法是验证本地和远程spec是否正确的方法，所以需要你先将本地的添加到远程去。
cd到你的.podspec目录下，终端输入：
git remote add origin https://github.com/diankaunghuolong/HaiLayout.git
这步可以先打开你的github，看到你的项目（比如我的远程项目HaiLayout下的 Branch：master／tags中，tags下没有内容），当你输入这条命令并按下边几步打了tag、推送tag到远程后，再去看你的github，发现你的pod已经上传到远程了，这样代表你上传成功。
如图：如果你直接添加tag，并推送到远程（git push --tags）也会有如下提示。添加到远程：
推送tags到远程：
给自己当前仓库版本添加Tag标签,终端输入：git tag -a '0.0.1' -m '0.0.1'
把本地标签推送到远程服务器，终端输入：git push --tags
(git tag 查看tag git tag -d 0.01删除tag 然后推一个空tag到远程 git push origin :refs/tags/0.0.1)
如图：
6.检查：
// 进入到.podspec所在目录
$ pod spec lint
// 如果出现错误，进入.podspec修改，直到没有错误；如果你始终修改不好，又找不到问题所在，建议直接删除重新创建一次吧。(创建.podspec后，.podspec文件中，默认会有内容。你也可以在创建了.podspec文件后，进入查看，按照默认格式对比下你写的内容，方便查着错误。注意，在vim中注释不要用//，用#)，为了防止您输入错误，可以直接复制我的内容，进行修改。------万般皆辛苦，唯有复制高。
验证成功如图：
7.推送自己的podspec到cocoapods的索引库
cd到.podspec目录下：
pod trunk push HaiLayoutPod.podspec --allow-warnings
注意：必须cd 进入到podspec目录下，才能执行这个代码
注意：podspec文件中的s.version版本号要跟最新Tag一致
注意：podspec文件中的s.source仓库地址也不能写错
如图：
8.试试搜索你的pod
// 查找一下你提交的pod
$ pod search ‘HaiLayoutPod’
9.如果pod search找不到，可进行如下操作：
pod repo update （更新仓库）
pod search
或者：
pod setup （初始化）
rm ~/Library/Caches/CocoaPods/search_index.json
pod search
10.导入到你的项目中如图：
这个pod是个适配文件，只为演示。
