写在开头

近期公司项目不是特别的忙,因此最近潜下心来研究了一下如何在cocopods上传项目。
本人在学习的过程中,发现并没有一篇完整详细的介绍文章,因此总结几位同行的文章,并实际操作,学到了一点皮毛,现将自己过程中所学到的知识,以及遇到的坑分享给大家
下面，我就一步一步的操作将自己的pods发布到CocoaPods中。
如果你现在对CocoaPods还不太了解，推荐你看一看这篇文章：用CocoaPods做iOS程序的依赖管理 ,2017年cocoaPods 1.2.1升级这里不再过多赘述.

本文以个人发布的一个简单的项目为例来说明: LCActionAlertView

完整的项目目录

发布个人开源框架到CocoaPods——让你的项目支持CocoaPods_第1张图片

项目目录.png

1.创建远程仓库(github)

CocoaPods是托管在github上的，所有的Pods也都是托管在github上，因此我们首先需要创建一个属于自己的 github 仓库，如下图所示：

发布个人开源框架到CocoaPods——让你的项目支持CocoaPods_第2张图片

创建仓库.png

**说明**
1.开源库的名字,必填项.
2.对该库的说明,可选项.
3.仓库的公开性，开源的话选**Public**。 如果是公司内部使用的话这里推荐大家使用私有的仓库,但是**github**的私有仓库是要收费的**$7/month**（壕请无视 - -！）。大部分公司都是有自己的git服务器，不过一般只能在公司内网使用，或者可以选择[Gitlab](https://gitlab.com/),[Coding](https://coding.net/),[Bitbucket](https://bitbucket.org/)任意一种.
4.readme文件,建议勾选进行创建,这是对该库完整的一个说明文档
5.添加忽略文件使用,根据情况进行选择
6.正规的仓库都有一个**license**文件，**Pods**依赖库对这个文件要求比较严格，需要有这个文件。这里最好让**github**自动创建一个，不过后续手动创建也行。建议使用**MIT**类型的**license**

2. clone项目到本地

这里推荐大家使用一个免费的git客户端 - SourceTree,推荐文章:SourceTree 的使用

3.向本地仓库中添加创建 Pods 依赖库所需的文件#

1.共享代码

将LCActionAlertView文件夹,即需要共享出去的源代码所在文件夹拖入工程内,建议同时拖入该源代码的使用示例工程

2.创建podspec文件

每个Pods依赖库必须有且仅有一个名称和依赖库名保持一致，后缀名为.podspec的描述文件。这里我们依赖库的描述文件名称应该为LCActionAlertView.podspec
创建这个文件有两种途径：

1.复制已有的podspec文件然后修改对应的参数。

2.执行命令行创建。在终端输入:

pod spec create LCActionAlertView

文件内容如下所示:
里面有很多部分,根据需要选择即可,另外使用文本编辑打开此文件的时候,有时候英文标点会自动变为中文标点,因此建议拖入xcode,使用xcode打开,避免不必要的麻烦

发布个人开源框架到CocoaPods——让你的项目支持CocoaPods_第3张图片

LCActionAlertView.podspec 内容截图

@version = "0.0.1"

Pod::Spec.new do |s|
 s.name         = "LCActionAlertView"
 s.version      = @version
 s.summary      = "简单易用的底部弹出控件."
 s.description  = <<-DESC
                     首次pods上传
                     *希望可以成功
                  DESC
 s.homepage     = "https://github.com/loversunny/LCActionAlertView"
 s.license      = "MIT"
 s.author             = { "冀柳冲" => "[email protected]" }
 s.platform     = :ios, "8.0"
 s.source       = { :git => "https://github.com/loversunny/LCActionAlertView.git",:tag => "v#{s.version}" }
 s.source_files  = "LCActionAlertView/*.{h,m}"
 s.framework  = "UIKit"
 s.requires_arc = true

end

3. readme文件,不多赘述

4.开源许可证 LICENSE

CocoaPods强制要求所有的Pods依赖库都必须有license文件，否则验证不会通过。license文件有很多中，详情可以参考tldrlegal。前面我们已经选择创建了一个MIT类型的license。
以上操作完成后,目录是这样的(command + shift + . 显示隐藏目录)

发布个人开源框架到CocoaPods——让你的项目支持CocoaPods_第4张图片

项目目录.png

3.提交修改到github

提交之前,需要对刚才添加的podspec文件进行验证

pod lib lint

运行之后可能会得到下面的警告：

-> LCActionAlertView (0.0.1)
    - WARN  | source: Git sources should specify a tag.

[!] LCActionAlertView did not pass validation, due to 1 warning (but you can use `--allow-warnings` to ignore it) and All results apply only to public specs, but you can use `--private` to ignore them if linting the specification for a private pod..
You can use the `--no-clean` option to inspect any issue.

由于我们现在还没有正式生成 release 版本， github 上并没有任何 tag，所以我们刚才填写 .podspec 文件填写 git 地址的时候没有填写指定 tag （上面文件的注释中有提到），解决方法我们可以先执行忽略警告的命令：

pod lib lint --allow-warnings

如果成功会出现如下输出：

-> O2View (0.0.1)
    - WARN  | source: Git sources should specify a tag.

O2View passed validation.

当调试完成了之后，我们需要在 github 上把我们的代码生成相应稳定的 release 版本，根据版本号,(或者直接git命令指定tag值)再修改podspec文件,指定tag值即可.
使用sourceTree 推送到github上.或者使用以下命令:

git add -A && git commit -m "add pod files"
git push origin master

5. 将生成的podspec文件提交到官方的 CocoaPods Specs 中

经过前面的步骤，我们的 CocoaPods 依赖库就已经准备好了，但是现在你还不能在你的工程中使用它。如果你想成为一个真正可用的依赖库，还需要最后一步操作：将刚才生产的 podspec 文件提交到官方的 CocoaPods Specs 中.
没错，我们平时用的能用pod search搜到的依赖库都会把它上传到这个仓库中，也就是说只有将我们的 podspec 文件上传到这里，才能成为一个真正的依赖库，别人才能用！流程如下:

1.CocoaPods Trunk发布自己的Pods

在cocoapods使用trunk，CocoaPods 需要0.33以上版本，用 pod --version查看版本，如果版本低，需要更新。终端执行 sudo gem install -n /usr/local/bin cocoapods

注册Trunk

pod trunk register [email protected]  'sunny冲哥' --description='描述信息'

大家将上面的邮箱,名字,更改成自己的,然后执行该命令,一切顺利的话就会受到一份邮件，点击邮件中的链接验证通过后,再执行:

pod trunk me

显示以下信息

jiliuchongdeiMac:~ JLC$ pod trunk me
  - Name:     jlc --description=弹窗控件
  - Email:    [email protected]
  - Since:    June 26th, 03:40
  - Pods:
    - LCActionAlertView
  - Sessions:
    - June 26th, 03:40 - November 2nd, 21:16. IP: 218.29.120.82

如果你的pod是由多人维护的，你也可以添加其他维护者:

pod trunk add-owner JLC  [email protected]

上面的工作完成之后，我们就可以开始 trunk push了。

trunk push

pod trunk push命令会首先验证你本地的podspec文件(是否有错误)，之后会上传spec文件到trunk，最后会将你上传的podspec文件转换为需要的json文件。在工程根目录(包含有.podspec)下执行命令：

pod trunk push

如果在trunk push过程中报错了，仔细查看一下错误信息,解决问题后,重新push
成功之后我们也可以在本地的~/.cocoapods/repos/master/Specs目录下看到转换之后的json文件

发布个人开源框架到CocoaPods——让你的项目支持CocoaPods_第5张图片

json文件目录.png

至此我们整个制作自己的开源库的过程就完成了，以后有新版本只需要修改工程根目录下的podspec文件，然后重新执行pod trunk push命令即可。
成功的话,一般会显示如下信息

   Congrats

   LCActionAlertView (0.0.1) successfully published
   June 29th, 00:57
   https://cocoapods.org/pods/LCActionAlertView
   Tell your friends!

然后耐心等待一般时间,就可以执行pod search LCActionAlertView命令去查看了哦

-> LCActionAlertView (0.0.1)
   简单易用的底部弹出控件.
   pod 'LCActionAlertView', '~> 0.0.1'
   - Homepage: https://github.com/loversunny/LCActionAlertView
   - Source:   https://github.com/loversunny/LCActionAlertView.git
   - Versions: 0.0.1 [master repo]

PS:

如果长时间过去还是搜索不到请参考Cocoapods: pod search无法搜索到类库的解决办法

最后

最后对这个过程做个总结：

开源库发布之后，需要打上tag,参考Git 基础 - 打标签

git tag -a v1.4 -m 'my version 1.4'

进入到项目根目录下，创建podspec文件

pod spec create PodName

编辑podspec文件中的相关信息，有两个比较重要的地方s.source和s.source_files,可以验证是否有误：

pod spec lint PodName.podspec

或者cd 到podspec文件所在目录,执行

pod lib lint

注册pod trunk

pod trunk register [email protected]  'sunny冲哥' --description='描述信息'

发布到pod trunk

pod trunk push

该命令在包含有.podspec文件的目录下执行

更新pod库

pod setup

如果pod trunk push成功后无法pod search到自己的库，可执行该命令。还是不行的话,参考此篇文章修改:CocoaPods 【pod search 搜索类库失败的解决办法】

感谢!

本文在写作过程中参考了以下文章,再次致谢!
当前Markdown语法与效果
如何发布自己的开源框架到CocoaPods
特别鸣谢简友:MarkLin
本文章也是参考该文写作而成的,再次致谢
制作 CocoaPods 依赖库

最后的最后

如果在操作过程中,有任何疑问或者不明白的地方,欢迎留言探讨,互相学习,共同进步,谢谢大家!

发布个人开源框架到CocoaPods——让你的项目支持CocoaPods