为自己的库添加 CocoaPods 支持

Posted 2023-05-01

参考技术A 相信使用过CocoaPods的小伙伴都知道它是多么的方便，在项目开发过程中，我也封装、总结了一些常用的库，为了方便自己与其他开发者，我将这个库公开了，并且添加了CocoaPods支持，方便其他项目使用与更新。

本文，将通过我自己的库TKit，来讲解如何给它添加CocoaPods支持。

TKit地址：
https://github.com/saitjr/TKit.git
环境信息：

Mac OS X 10.10.3

pod 0.35

正文：

一、在Github上创建仓库

创建步骤就不细说了，注意在创建时勾选License。

创建Github仓库，注意勾选License
创建完成后，目录中应该有License文件。

二、在本地库中创建podspec文件

因为我不怎么用的惯vim，所以我采用的是Sublime Text。如果没有Sublime，也可以用系统自带的文本编辑.app。

在TKit目录下，创建TKit.podspec文件

在TKit目录下，创建TKit.podspec文件
用文本编辑打开，写入相应配置，我的配置是：

这些配置都见名知意，最好是复制下来，然后修改内容，不要自己挨着敲，容易敲错。这里的s.license与创建Github仓库时，选的license要对应。
关于配置应该如何写，可以看看官方文档，或者参考别人的podspec文件，如杰哥的MJRefresh或者Mattt大神的AFNetworking。
MJRefresh中podspec配置
AFNetworking中podspec配置

三、上传本地库到Github上
上传到Github的步骤不用我说了吧，上传好以后，远程库的目录为：

创建完成后的Github目录
四、在Github上创建release版本

点击release，创建一个1.0.0版本（注意这里版本要和podspec中配置的版本匹配上）。

点击release

创建版本
五、注册CocoaPods

在终端中输入命令（用户名有单引号）：

验证邮箱
六、上传TKit到CocoaPods

如果这一步没成功，注意终端上的报错。有问题可以留言。

如果成功上传，那么使用pod setup更新本地库以后，就可以使用pod search找到自己的库了。关于如何更新版本，我会在接下来的文章中进行讲解。

最终效果

iOS开发-- 创建podspec文件，为自己的项目添加pod支持

开篇扯淡

作为一个iOS开发者，一定用过CocoaPods吧，没用过?点这儿去面壁吧

Cocoapods作为iOS开发的包管理器，给我们的开发带来了极大的便利，而且越来越多的第三方类库支持Pod，可以通过Pod傻瓜式的集成到自己的工程中，那么问题来了，我自己也有一系列的小工具类，怎么让它也支持pod集成进而让其他朋友方便，的使用呢?

刚好，最近项目不算紧，自己尝试着弄了一下，在这里记录一下尝试的过程， 一来备忘， 二来共享......

其实网上这种文章数不胜数，但是不一定都是适合自己的，比如接下来写的东西我觉得都是适用于我的，但未必能适用于正在阅读此文的你，又或者下文中有一部内容能够帮到你，如果真是这样，我也很高兴

本文有诸多不完善的地方，以后时间充足在慢慢完善吧

写的不好 砖下留情

行动

我这里拿一个小demo做示例，目的是把工程中的一些category提取出来支持 pod

1.上传项目源码

把项目源码上传到gitHub仓库再clone到本地(以iOS_Category为例--源码在这里)， 如果项目本来就在gitHub的仓库中， 直接clone到本地即可

2.创建项目的podspec文件

• 用终端命令cd到本地项目目录并执行如下命令:

$ pod spec create iOS_Category

这时候本地就生成一个iOS_Category.podspec文件

• 用编辑器打开.podspec文件 (我自己用Sublime Text)

删除不必要的注释(这里只简单介绍基本用法，所以只用到一部分必须得字段 更多字段请移步http://guides.cocoapods.org/syntax/podspec.html)

Pod::Spec.new do |s|
  s.name         = "iOS_Category"
  s.version      = "0.0.1"
  s.summary      = "all kinds of categories for iOS develop"
  s.description  = <<-DESC
                      this project provide all kinds of categories for iOS developer 
                   DESC
  s.homepage     = "https://github.com/yongqianvip/iOS_Category"
  s.license      = "MIT"
  s.license      = { :type => "MIT"， :file => "LICENSE" }
  s.author             = { "yongqianvip" => "[email protected]***.com" }
  s.platform     = :ios
  s.source       = { :git => "https://github.com/yongqianvip/iOS_Category.git"， :tag => "0.0.1" }
  s.source_files  = "Classes"， "iOS_Category/Classes/**/*.{h，m}"
  s.exclude_files = "Classes/Exclude"
  s.public_header_files = "iOS_Category/Classes/UIKit/UI_Categories.h"，"iOS_Category/Classes/Foundation/Foundation_Category.h"，"iOS_Category/Classes/**/*.h"
  s.requires_arc = true
end

• 验证podspec文件

编辑完podspec文件后需要验证一下这个文件是否可用podspec文件不允许有任何的Warning或者Error
执行命令

$ pod lib lint

如果出现

-> iOS_Category (0.0.1)

iOS_Category passed validation.

则说明验证通过， 否则， 根据提示修改podspec文件再次验证直到验证通过

附带说一下，Xcode允许警告存在，所以可以通过命令屏蔽警告

$ pod lib lint --allow-warnings

如果出现Error但是提示信息不足，可以添加--verbose 以获取更多错误信息

$ pod lib lint --verbose

3.打tag 上传podspec

podspec文件中需要指定的tag， 完成上述操作后给项目打tag

$ git tag -m"first release iOS_Category with podspec" "0.0.1"
$ git push --tags

最后使用pod trunk命令，把podspec文件推送到CocoaPod官方库

pod trunk 需要注册 具体做法这里不再赘述 请移步CocoaPod官网

pod trunk 设置完毕后执行命令

$ pod trunk push iOS_Category.podspec

这个过程可能会比较耗时，原因你懂的

4.最后

如果一切顺利

pod search iOS_Category

就可以找到刚才的项目了 并且还有安装命令< pod ‘iOS_Category‘，‘~>0.0.1‘ >

文／尹_路人（简书作者）
原文链接：http://www.jianshu.com/p/d7d1942dd3f1
著作权归作者所有，转载请联系作者获得授权，并标注“简书作者”。