手把手教你发布自己的cocoapods开源库

发布自己的cocoapods开源库按照以下步骤,良心制作,包教包会!!

下面我会通过一个名为IFMMenu的项目来讲解一下整个过程。

1.写好代码,上传到github

github上创建项目仓库的时候记得创建LICENSE(许可证/授权)文件,此文件必须要有。

github上创建项目仓库

2.将自己的项目打成tag

因为cocoapods是依赖tag版本的,所以必须打tag,以后再次更新只需要把你的项目打一个tag,然后修改.podspec文件中的版本接着提交到cocoapods官方就可以了,提交命令请看下面

//为git打tag, 第一次需要在前面加一个v

git tag "v1.0.0"  
git push --tags

3.注册CocoaPods

trunk需要CocoaPods 0.33版本以上,用pod --version命令查看版本,如果版本低,需要升级。

pod --version

//版本低于0.33
sudo gen install cocoapods
pod setup

已经注册过的不需要注册,怎么看自己有没有注册

pod trunk me
pod trunk me信息

若未注册,执行以下命令,邮箱以及用户名请对号入座。用户名我使用的是Github上的用户名。

// 加上--verbose可以输出详细错误信息,方便出错时查看。
pod trunk register example@example.com 'liugangios'  --verbose

注册完成之后会给你的邮箱发个邮件,进入邮箱邮件里面有个链接,需要点击确认一下。
注册完成后使用pod trunk me检验注册是否成功。

4.创建.podspec

cd到你项目的目录,执行命令

pod spec create IFMMenu

5.编辑.podspec

创建好后,打开.podspec,删除注释, 前面有#的为注释,也可以用以下代码替换,然后编辑自己的库信息。

Pod::Spec.new do |s|
s.name        = 'IFMMenu'
s.version     = '1.0.2'
s.authors     = { 'liugangios' => 'example@example.com' }
s.homepage    = 'https://github.com/liugangios/IFMMenu'
s.summary     = 'a dropdown menu for ios like wechat homepage.'
s.source      = { :git => 'https://github.com/liugangios/IFMMenu.git',
:tag => s.version.to_s }
s.license     = { :type => "MIT", :file => "LICENSE" }

s.platform = :ios, '7.0'
s.requires_arc = true
s.source_files = 'IFMMenu'
s.public_header_files = 'IFMMenu/*.h'

s.ios.deployment_target = '7.0'
end
  • s.name:名称,pod search搜索的关键词,注意这里一定要和.podspec的名称一样,否则报错
  • s.version:版本号,to_s:返回一个字符串
  • s.author:作者
  • s.homepage:项目主页地址
  • s.summary: 项目简介
  • s.source:项目源码所在地址
  • s.license:许可证
  • s.platform:项目支持平台
  • s.requires_arc: 是否支持ARC
  • s.source_files:需要包含的源文件
  • s.public_header_files:需要包含的头文件
  • s.ios.deployment_target:支持的pod最低版本

其他一些非必要字段

  • s.social_media_url:社交网址
  • s.resources:资源文件
  • s.dependency:依赖库,不能依赖未发布的库

s.license= { :type => "MIT", :file => "LICENSE" }
这里建议这样写,如果写别的会报警告,导致后面一直提交失败。

source_files写法及含义

"IFMMenu/*
"IFMMenu/IFMMenu/*.{h,m}"
"IFMMenu/**/*.h"

*表示匹配所有文件
*.{h,m}表示匹配所有以.h.m结尾的文件
**表示匹配所有子目录

s.source常见写法

s.source = { :git => "https://github.com/liugangios/IFMMenu.git", :commit => "68defea" }
s.source = { :git => "https://github.com/liugangios/IFMMenu.git", :tag => 1.0.0 }
s.source = { :git => "https://github.com/liugangios/IFMMenu.git", :tag => s.version }
  • commit => "68defea" 表示将这个Pod版本与Git仓库中某个commit绑定
  • tag => 1.0.0表示将这个Pod版本与Git仓库中某个版本的comit绑定
  • tag => s.version表示将这个Pod版本与Git仓库中相同版本的comit绑定

6.验证.podspec

到此检查一下你工程中有以下文件:

  • 你的项目,
  • .podspec文件,
  • LICENSE文件
项目内文件

使用以下命令测试本地.podspec文件是否存在语法错误。

pod spec lint IFMMenu.podspec --verbose

7.发布

pod trunk push IFMMenu.podspec

时间较长,耐性等待,大概5-10分钟,发布成功后会有以下提示

发布成功截图

8.测试自己的cocoapods

这个时候使用pod search搜索的话会提示搜索不到,可以执行以下命令更新本地search_index.json文件

rm ~/Library/Caches/CocoaPods/search_index.json

然后

pod search IFMMenu

该命令会重新创建search_index.json文件,5-10分钟,耐性等待

搜索结果

完整命令

git tag "v1.0.0"
git push --tags 

pod trunk register example@example.com 'liugangios'  --verbose
pod trunk me
pod spec create IFMMenu

//编辑 IFMMenu.podspec

pod spec lint IFMMenu.podspec
pod trunk push IFMMenu.podspec 
rm ~/Library/Caches/CocoaPods/search_index.json
pod search IFMMenu

报错处理

[!] Unable to accept duplicate entry for: XXXXX (1.0.0)

意思是:不能接受同一版本的提交

解决方案:
1、执行如下命令

git tag 1.0.1
git push --tags

2、修改XXXX.podspec文件中的内容

  s.version      = "1.0.1"
  s.source       = { :Git => "https://github.com/xxx/xxx.git", :tag => "1.0.1" }

3、执行命令pod spec lintpod trunk push 库名.podspec验证并提交到CocoPods

最后

IFMMenu是一个仿微信首页添加菜单的多功能、多种属性可自定义的下拉菜单,欢迎download下载提意见,star,感谢阅读。

IFMMenu展示图

下一篇预告:

cocoapods私有仓库搭建


参考文章:
如何发布自己的开源框架到CocoaPods
把自己的开源库添加cocoapods
3分钟让你的框架支持cocoapods,podspec文件讲解
iOS:手把手教你发布代码到CocoaPods(Trunk方式)
iOS开发CocoPods支持报错

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 162,408评论 4 371
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 68,690评论 2 307
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 112,036评论 0 255
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,726评论 0 221
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 53,123评论 3 296
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 41,037评论 1 225
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 32,178评论 2 318
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,964评论 0 213
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,703评论 1 250
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,863评论 2 254
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,333评论 1 265
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,658评论 3 263
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,374评论 3 244
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,195评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,988评论 0 201
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 36,167评论 2 285
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,970评论 2 279

推荐阅读更多精彩内容