Cocoapods 的使用

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是个适配文件，只为演示。