用CocoaPods创建自己的Podspec供别人使用

创建Podspec

首先在项目中创建一个Podspec


$ pod spec create GQCategory

编辑Podspec

用上述命令创建好的Podspec会被填上默认的参数并有注释说明了每个参数的含义及用法,这里只介绍几个常用的参数

Pod::Spec.new do |s|
  s.name         = "GQCategory"
  s.version      = "0.0.5"
  s.summary      = "常用的分类封装."

  
  s.description  = <<-DESC
            第一个podspec
                   DESC

  s.homepage     = "https://github.com/gqisabug/GQCategory"
  s.license      = { :type => "MIT", :file => "LICENSE" }
  s.author             = { "gqisabug" => "gqlyan419@163.com" }
  
  s.platform     = :ios, "7.0"
  s.source       = { :git => "https://github.com/gqisabug/GQCategory.git", :tag => s.version }

## 这里不支持ssh的地址,只支持HTTP和HTTPS,最好使用HTTPS
  ## 正常情况下我们会使用稳定的tag版本来访问,如果是在开发测试的时候,不需要发布release版本,直接指向git地址使用
  ## 待测试通过完成后我们再发布指定release版本,使用如下方式
  #s.source       = { :git => "http://EXAMPLE/O2View.git", :tag => version }

  s.source_files  = "GQCategory/GQCategory/**/*.{h,m}"
  s.requires_arc = true

end

s.name:名称,pod search 搜索的关键词
s.version:版本
s.summary:简介,pod search 搜索的关键词
s.homepage:主页地址,例如Github地址
s.license:许可证
s.author:作者
s.social_media_url:社交网址
s.platform:平台
s.source:Git仓库地址,例如在Github地址后边加上 .git 就是Git仓库地址,常见写法如下

s.source = { :git => "仓库地址", :commit => "68defea" }
s.source = { :git => "仓库地址", :tag => 1.0.0 }
s.source = { :git => "仓库地址", :tag => s.version }
  • commit => "68defea" 表示将这个Pod版本与Git仓库中某个commit绑定
  • tag => 1.0.0 表示将这个Pod版本与Git仓库中某个版本的comit绑定
  • tag => s.version 表示将这个Pod版本与Git仓库中相同版本的comit绑定
"Directory1/*"
"Directory1/Directory2/*.{h,m}"
"Directory1/**/*.h"
  • “*” 表示匹配所有文件
  • “*.{h,m}” 表示匹配所有以.h和.m结尾的文件
  • “**” 表示匹配所有子目录

s.resources:需要包含的图片等资源文件
s.dependency:依赖库,不能依赖未发布的
s.dependency:依赖库,如有多个可以这样写
s.requires_arc:是否要求ARC

上传到git

将编辑好的Podspec 上传到git并给这次更新打上tag并推送到仓库(需与文件里一致)

  • 创建标签
$ git tag v1.0
//标签默认是打在最新的commit上,如果想要给某个之前的操作打,可以先找到历史记录
$ git log --pretty=oneline --abbrev-commit
执行后输出如下
6224937 add merge
6224937是commit的id
$ git tag v0.9 6224937
就可以给add merge这个操作打上标签了
  • 查看所有标签
$ git tag
  • 删除标签
//删除本地的
$ git tag -d v0.1
//删除远程
$ git push origin :refs/tags/v0.9
  • 推送标签到远程
//推送一个
$ git push origin v1.0
//推送所有尚未被推送的本地标签
$ git push origin --tags

验证Podspec

$ pod spec lint GQCategory.podspec
//如果依赖库(s.dependency)包含了.a静态库,需要在后面加上--use-libraries
//如果有警告,需要加上 --allow-warnings来忽略警告以通过验证
//可以加上--verbose来查看错误

发布Podspec

需要先注册

pod trunk register gqlyan419@163.com "gaoqi"

注册成功后验证邮箱就可以发布自己的pod了

pod trunk push GQCategory.podspec
//这里也可以加上验证时的参数--allow-warnings 等

版本升级

修改 .podspec 中的 s.version 为更高的版本号,并修改 s.source 中对应的 Git 版本。提交到Git,并打上对应tag。然后再讲修改后的pod spec发布到Cocoapods就可以完成更新。
-建议s.source采用

s.source = { :git => "仓库地址", :tag => s.version }

写法,这样就与s.version绑定了,每次更新只需要改版本号即可

创建私有库

//打开隐藏的命令:
defaults write com.apple.finder AppleShowAllFiles -bool true
//关闭隐藏的命令:
defaults write com.apple.finder AppleShowAllFiles -bool false

接着需要重启一下 Finder, 可以按住 option + 右键 Finder 图标选择重启。然后打开隐藏目录 .cocoapods (这个目录在你的个人目录底下, ~/.cocoapods 或 /Users/[username]/.cocoapods)

1.创建一个私有的 Spec Repo

在自己的私有git服务器(GitHub,Gitlab,Coding, Bitbucket等)上创建一个空的仓库。

2.添加私有Spec Repo

然后打开终端,输入命令行:

pod repo add [本地Spec Repo名称][远程Spec Repo地址]

例如:

pod repo add MySpecs https://xxxxxxxxxxx/MySpecs.git

这里的xxxxxxx就是自己的git地址。
此时跳转到文件夹:repos。就是:

~/.cocoapods/repos/

除了原来的master,会出现一个你自己的MySpecs: cd进去 执行:

pod repo lint

时间较长,耐心等待

3.验证Podspec

参考上面的步骤新建Podspec并验证成功后提交到仓库

4.把要共享的库添加到私有Spec Repo中

执行命令:
pod repo push [本地Spec Repo名称][podspec文件路径] --allow-warnings
例如:
pod repo push MySpecs ~/本地路径.podspec --allow-warnings
成功后能在你的MySpecs里面看到新加的库

5.使用

和原来的常规的使用cocoapods一样,不过需要在Podfile里面添加:

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

推荐阅读更多精彩内容