iOS 如何发布自己的开源框架到CocoaPods

.
.

.

添加自己的pod库的方式:在Podfile中添加pod 'LuaViewSDK', :git => 'git@gitlab.alibaba-inc.com:luaview/LuaViewSDK.git'

自己在开发iOS的时候,经常使用别人的库,通过cocoapodspod install命令就可以很方便的将第三方的框架添加到自己的项目中。

为此,我们如何添加自己的库或者开源框架给别人用呢?下面我将带大家一步步将自己的库发布到cocoapods上,如果你对cocoapods还不太了解,那你就太out了。

必备:

  • cocoapods命令
  • Github帐户
  • Mac

一、在Github上创建一个工程。

二、将项目克隆下来,然后再创建一个iOS的项目并放到该目录下。

git clone https://github.com/GeorgeGod/TestPod.git

三、将新建的iOS工程提交到GitHub上。

这里最好能用git打上点,因为我们后面要用上这个打点。

git add -A && git commit -m "Release 1.0.0"
git tag '1.0.0' #这里是增加一个tag打点
git push --tags #push的情况下,默认不上传打点的,所以这里需要将tags上传一下
git push origin master  #将代码上传到github上

至此发布pod的准备工作已经做完了,下面开始真正的发布工作了。

四、创建Podspec文件

在工程的根目录中初始化一个Podspec文件。

pod spec create TestPod

该命令将在本地产生一个名为TestPod.podspec的文件。我这里用sublime Text 3打开该文件,里面已经有非常丰富的说明文档了。下面介绍如何声明第三方库的代码目录和资源目录,还有第三方库所依赖的iOS核心框架和第三方。这里是我的podspec精简版文件:

Pod::Spec.new do |s|
  s.name         = "MyChart"
  s.version      = "1.0.0"
  s.summary      = "这是我为MyChart创建的一个描述"
  s.description  = <<-DESC
                  这是一个object-c的文件...这是一个object-c的文件...这是一个object-c的文件
                   DESC

  s.homepage     = "https://github.com/GeorgeGod/PodTest"
  s.license      = "MIT"
  s.author             = { "yujiawei" => "1341069918@qq.com" }
  s.platform     = :ios, "8.0"
  s.source       = { :git => "https://github.com/GeorgeGod/PodTest.git", :tag => "1.0.0" }

  s.source_files  = "MyChart/MyChart/*.{h,m}"
  # s.exclude_files = "Classes/Exclude"
  s.framework  = "UIKit"
  s.requires_arc = true
  # s.dependency "JSONKit", "~> 1.4"
end

解释:

  • s.name是我们库的名称
  • s.version是库原代码版本号
  • s.summary是对我们库的一个简单的介绍
  • s.description是需要我们对这个库添加一段描述
  • s.homepage声明库的主页
  • s.license是所采用的授权版本
  • s.author是库的作者
  • s.platform是我们库所支持的软件平台,这在我们最后提交进行编译时有用
  • s.source声明原代码的地址。我这里是托管在github上,所以这里将地址copy过来就行了。
  • s.source_files 声明了我们库的源代码的位置,所以这个地方不能填错了。

关于这个目录的路径是如何找的:

对于这里的s.source可以有两种方式,一种是tag,一种是commit。如果用commit的方式的时候,检查TestPod.podspec文件的时候会出现警告,而且也不能发不成功。

tag方式:

:git => "https://github.com/GeorgeGod/PodTest.git", :tag => "1.0.0"

commit方式:

:git => "https://github.com/GeorgeGod/PodTest.git", :commit  => "7623791cfc879065202ad84d398f9f5367c7df99"
  • s.framework声明了所依赖的核心库,我这里只用到了UIKit,所以是这样的:
s.framework  = "UIKit"

如果项目中依赖多个库,可以使用

s.frameworks = "SomeFramework", "AnotherFramework"

当然,我们开发的库中也可能还依赖其他的第三方库,例如JSONKit,那么我们就可以用下面的方式声明:

s.dependency "JSONKit", "~> 1.4"

五、检查Podspec文件

编辑完podspec文件后,需要验证一下这个文件是否可用,如果有任何WARNING或者ERROR都是不可以的,它就不能被添加到Spec Repo中,不过xcode的WARNING是可以存在的,验证需要执行命令:

pod spec lint PodName.podspec

当看到TestPod passed validation时,说明验证通过了。

六、 Cocoapods Trunk发布自己的Pods

1. 注册Trunk

pod trunk register 1341069918@qq.com 'yujiawei' --description='Macbook Pro'

这里需要替换成自己的邮箱和用户名,一切顺利的话,会收到一封邮件,点击邮件验证一下即可。

2. 查看自己的Trunk信息

pod trunk me

3. Trunk push
当我们用pod spec lint PodName.podspec命令检查podspec文件是否有警告和错误后,如果一起正常,我们就可以上传了。

pod trunk push [TestPod.podspec]

到这里我们已经制作完自己的开源库的过程了。以后有新版本只需要修改工程目录下的podspec文件就行了,然后重新执行pod trunk push命令。







总结

    1. 开源库发布后需要打上tag。
    1. 进入根目录下,创建podspec文件
pod spec create PodName
    1. 编辑podspec文件中的相关信息,有两个比较重要的地方s.source和s.source_files,可以验证是否有误
pod spec lint PodName.podspec
    1. 注册pod trunk
pod trunk register 1341069918@qq.com 'yujiawei' --description='Macbook Pro'
    1. 发布到pod trunk
pod trunk push [NAME.podspec]
    1. 更新pod库
pod setup

如果pod trunk push成功后,无法pod search到自己的库。可以执行该命令。如果还搜不到,那就在Podfile中添加我们创建的库,然后pod install即可看见我们创建的库了。

参考文献:
如何发布自己的开源框架到CocoaPods
CocoaPods详解之----制作篇

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

推荐阅读更多精彩内容