IOS-CocoaPods制做篇

做者： wangzz

原文地址： http://blog.csdn.net/wzzvictory/article/details/20067595

转载请注明出处

若是以为文章对你有所帮助，请经过留言或关注微信公众账号wangzzstrive来支持我，谢谢！

 

学会使用别人的Pods依赖库之后，你必定对建立本身的依赖库跃跃欲试，今天就来揭开Pods依赖库建立过程的神秘面纱。整个建立过程都以我实现的一个名称为WZMarqueeView跑马灯效果的view为例，步骤以下：

1、建立本身的github仓库

CocoaPods都托管在github上(官方连接为： https://github.com/CocoaPods)，全部的Pods依赖库也都依赖github，所以第一步咱们须要建立一个属于本身的github仓库。仓库建立界面以下图：

上图中标了序号的共6处，对应的说明以下：

一、Repository name

仓库名称，这里写成WZMarqueeView，必填的；

二、Description

仓库的描述信息，可选的；

三、仓库的公开性

这里只能选Public，一个是由于Private是要money的，再一个Private别人看不到还共享个毛；

四、是否建立一个默认的README文件

一个完整地仓库，都须要README说明文档，建议选上。固然不嫌麻烦的话你也能够后面再手动建立一个；

五、是否添加.gitignore文件

.gitignore文件里面记录了若干中文件类型，凡是该文件包含的文件类型，git都不会将其归入到版本管理中。是否选择看我的须要；

六、license类型

正规的仓库都应该有一个license文件，Pods依赖库对这个文件的要求更严，是必需要有的。所以最好在这里让github建立一个，也能够本身后续再建立。我使用的license类型是MIT。

 

上面的各项都填写完毕后，点击Create repository按钮便可，建立成功地界面如图：

到这，仓库建立过程就结束了。

 

2、clone仓库到本地

为了便于向仓库中删减内容，须要先将仓库clone到本地，操做方式有多种，推荐使用命令行：

$ git clone https://github.com/wangzz/WZMarqueeView.git

操做完成后，github上对应的文件都会拷贝到本地，目录结构为：

github上仓库中的.gitignore文件是以.开头的隐藏文件，所以这里只能看到两个。

后续咱们的全部文件增、删、改都在这个目录下进行。

 

3、向本地git仓库中添加建立Pods依赖库所需文件

注意：如下描述的文件都要放在步骤二clone到本地的git仓库的根目录下面。

一、后缀为.podspec文件

该文件为Pods依赖库的描述文件，每一个Pods依赖库必须有且仅有那么一个描述文件。文件名称要和咱们想建立的依赖库名称保持一致，个人WZMarqueeView依赖库对应的文件名为WZMarqueeView.podspec。

1.1 podspec文件内容

WZMarqueeView.podspec的保存内容为：

Pod::Spec.new do |s|
  s.name             = "WZMarqueeView"
  s.version          = "1.0.0"
  s.summary          = "A marquee view used on iOS."
  s.description      = <<-DESC
                       It is a marquee view used on iOS, which implement by Objective-C.
                       DESC
  s.homepage         = "https://github.com/wangzz/WZMarqueeView"
  # s.screenshots      = "www.example.com/screenshots_1", "www.example.com/screenshots_2"
  s.license          = 'MIT'
  s.author           = { "王中周" => "wzzvictory_tjsd@163.com" }
  s.source           = { :git => "https://github.com/wangzz/WZMarqueeView.git", :tag => s.version.to_s }
  # s.social_media_url = 'https://twitter.com/NAME'

  s.platform     = :ios, '4.3'
  # s.ios.deployment_target = '5.0'
  # s.osx.deployment_target = '10.7'
  s.requires_arc = true

  s.source_files = 'WZMarqueeView/*'
  # s.resources = 'Assets'

  # s.ios.exclude_files = 'Classes/osx'
  # s.osx.exclude_files = 'Classes/ios'
  # s.public_header_files = 'Classes/**/*.h'
  s.frameworks = 'Foundation', 'CoreGraphics', 'UIKit'

end

该文件是ruby文件，里面的条目都很容易知道含义。

其中须要说明的又几个参数：

①s.license

Pods依赖库使用的license类型，你们填上本身对应的选择便可。

②s.source_files

表示源文件的路径，注意这个路径是相对podspec文件而言的。

③s.frameworks

须要用到的frameworks，不须要加.frameworks后缀。

 

1.2 如何建立podspec文件

你们建立本身的podspec文件能够有两个途径：

①copy个人podspec文件而后修改对应的参数，推荐使用这种方式。

②执行如下建立命令：

$ pod spec create WZMarqueeView

也会建立名为WZMarqueeView.podspec的文件。可是打开建立完的文件你就会发现里面的东西太多了，不少都是咱们不须要的。

 

二、LICENSE文件

CocoaPods强制要求全部的Pods依赖库都必须有license文件，不然验证不会经过。license的类型有不少种，详情能够参考网站 tl;dr Legal。在建立github仓库的时候，我已经选择了MIT类型的license。

 

三、主类文件

建立Pods依赖库就是为了方便别人使用咱们的成果，好比我想共享给你们的WZMarqueeView类，是我想提供给广大用户使用的，这个类天然是必不可少的。我把这个类包含的两个文件放到一个名称为WZMarqueeView的文件夹中，对应的目录结构如图：

里面包含两个文件：WZMarqueeView.h和WZMarqueeView.m

 

四、demo工程

为了快速地教会别人使用咱们的Pods依赖库，一般须要提供一个demo工程。我建立的demo工程放到了一个名为WZMarqueeViewDemo的文件夹中，该目录包含的文件以下图所示：

 

五、README.md

使用github的人应该都熟悉这个文件，它是一个成功github仓库必不可少的一部分，使用的是markdown标记语言，用于对仓库的详细说明。

 

以上所说的5个是建立Pods依赖库所需最基础的文件，其中一、二、3是必需的，四、5是可选但强烈推荐建立的。

添加完这些文件之后，个人github本地仓库目录就变成了下图所示的样子：

 

4、提交修改文件到github

通过步骤三，向本地的git仓库中添加了很多文件，如今须要将它们提交到github仓库中去。提交过程分如下几步：

一、pod验证

执行如下命令：

$ set the new version to 1.0.0
$ set the new tag to 1.0.0

这两条命令是为pod添加版本号并打上tag。而后执行pod验证命令：

$ pod lib lint

若是一切正常，这条命令执行完后会出现下面的输出：

-> WZMarqueeView (1.0.0)

ZMarqueeView passed validation.

到此，pod验证就结束了。

须要说明的是，在执行pod验证命令的时候，打印出了任何warning或者error信息，验证都会失败！若是验证出现异常，打印的信息会很详细，你们能够根据对应提示作出修改。

二、本地git仓库修改内容上传到github仓库

依次执行如下命令：

$ git add -A && git commit -m "Release 1.0.0."
$ git tag '1.0.0'
$ git push --tags
$ git push origin master

上述命令均属git的范畴，这里很少述。若是一切正常，github上就应该能看到本身刚添加的内容了。以下图所示：

 

 

5、上传podspec文件到CocoaPods官方仓库中

通过前边的四步操做，你可能觉得已经结束了，不幸的是还早着呢。

要想一个Pods依赖库真正可用，还须要作最后一步操做，将咱们刚才生成的podspec文件上传到CocoaPods官方的Specs仓库中，连接为： https://github.com/CocoaPods/Specs

打开这个连接你就会发现，原来咱们能使用的，以及咱们使用pod search命令能搜索到的全部Pods依赖库都会把它们的podspec文件上传到这个仓库中，也就是说，只有将咱们的podspec文件上传到这个仓库中之后，才能成为一个真正的Pods依赖库，别人才能正常使用！

按照git的规则，要想向别人的仓库中添加文件，必须先fork一份别人的仓库，作完相应地修改后，在push给仓库的原做者，等到做者审核经过，而后合并到原来的仓库中。

流程明白了之后，天然知道该怎么干了：

一、fork一份CocoaPods官方的Specs仓库

进入到刚才的官方仓库连接中，点击屏幕右上角的fork按钮，以下图：

 

而后你们会发现本身名下会多一份仓库的分支。好比个人分支为：

 

二、将fork的仓库clone到本地

执行如下命令：

$ git clone https://github.com/wangzz/Specs.git

注意，你们须要将对应的仓库地址换成本身的。

这个仓库有点大，须要有耐心啊。

 

三、将本身的podspec文件添加到本地Specs仓库中

Specs仓库clone到本地后，会放到一个名为Specs的文件夹中。podspec文件在Specs仓库中的保存原则是：

Pods依赖库同名文件夹--->版本号同名文件夹--->podspec文件

照此原则，我须要在Specs文件夹下创建一个名为WZMarqueeView的文件夹，而后进入到WZMarqueeView文件夹下，创建一个名称为1.0.0的文件夹，最后进入到1.0.0这个文件夹下，而且将以前建立好的WZMarqueeView.podspec文件拷贝进来。

不难理解，若是之后有对WZMarqueeView类的升级，就在WZMarqueeView文件夹下创建对应版本名称的文件夹，用于保存对应版本的podspec文件便可。

这些操做完成后，目录层次结构以下所示：

 

四、上传本地Specs仓库中的修改到github仓库

执行如下命令：

$ git add -A && git commit -m "Add WZMarqueeView podspec file"
$ git push origin master

成功之后就能在github上本身fork的Specs仓库中看到刚上传的文件了。

 

五、将在本身fork的Specs上作的修改pull给CocoaPods官方的Specs仓库

进入到本身fork的Specs仓库中，会看到屏幕左上角有一个绿色按钮：

该按钮点进去之后会有以下图所示的界面：

点击图中的绿色Create Pull Request按钮，便可将咱们fork的Specs上作的修改pull给CocoaPods官方的Specs仓库。

 

到这一步后，剩下的工做就只有等了，等待CocoaPods的维护人员审核并将咱们pull上去的修改合并到官方的Specs仓库中，这个过程一般会有一天左右的等待时间。若是有任何消息，好比审核不经过，或者审核经过了，CocoaPods官方都会发邮件通知的。

等到审核经过的时候，咱们就能在官方的Specs仓库中看到本身上传的文件夹了。

 

六、查看审核进度

固然咱们也能查看审核进度，打开这个连接： https://github.com/CocoaPods/Specs/pulls，这里能看到全部的Specs仓库pull请求，以下图：

红圈标识的就是我刚才pull上来的请求，点进去之后就能看到对应的审核进度。

 

6、查看咱们本身建立的Pods依赖库

若是收到了CocoaPods官方发过来的审核经过邮件之后，你可能很着急的想在本身的电脑上执行pod search命令，看看能不能搜索到本身建立的Pods依赖库。不过你确定会失望的，由于还须要执行一条命令才能在咱们的本地电脑上使用search命令搜索到咱们的依赖库：

$ pod setup

在个人CocoaPods系列教程中的第一篇： CocoaPods详解之----进阶篇中的最后部分介绍过这条命令，它会将全部的Pods依赖库tree跟新到本地。执行完这条命令，再去执行:

$ pod search WZMarqueeView

就能显示出对应的介绍信息了！

 

说了那么多，到这里整个Pods依赖库建立过程才算真正结束！小伙伴们，你成功了吗？？？遇到问题还请留言。

 

7、参考文档

一、 http://guides.cocoapods.org