iOS-CocoaPods发布开元框架补充(升级)

上篇文章[Cocoapods发布框架]:http://www.jianshu.com/p/e7c2047e3de1 的文章中,主要介绍了整个流程第一次配置的大致过程, 当然文章看上去是一番丰顺的. 但是, 事实并不是这样. 上篇文章主要讲的是第一次配置的步骤,所以文章篇幅过长, 现把抓哟步骤整理一下,顺便也把遇到的问题单独列了出来.

其实让自己的框架支持cocoapods,只需要几步
1.注册Trunk
2.创建/编辑.podspec
3.将自己的项目打成tag
4.验证
5.发布

用到的主要命令

1.注册Trunk
pod trunk register allisonwangjj@163.com 'Allisonwangjj' --description='第一次发布框架'
[!] Please verify the session by clicking the link in the verification email that has been sent to allisonwangjj@163.com
wuxianlvzhoudeMacBook-Pro:~ Allison$ pod trunk me

此时会收到一封邮件,点击邮件中的链接后验证一下即可.

2.创建/编辑.podspec
wuxianlvzhoudeMacBook-Pro:~ Allison$ cd /Users/wuxianlvzhou/FFAdditions/Additions 
//2.1 创建FFAdditions框架的Podspec描述文件
wuxianlvzhoudeMacBook-Pro:Additions Allison$ pod spec create https://github.com/AllisonWangJiaoJiao/FFAdditions

2.2 编辑.podspec
创建好后打开,删除注释, 前面有#的为注释,整理好你所需要的文件

3.将自己的项目打成tag

执行命令

//为git打tag
git tag "0.0.1" 
//将tag推送到远程仓库
git push --tags
4.验证
wuxianlvzhoudeMacBook-Pro:Additions Allison$ pod spec lint

验证成功后会出现如下信息:
FFAdditions.podspec passed validation.
注意此时可能并不会一帆风顺,可能会出现如下错误

  • ERROR
 -> FFAdditions (0.0.1)
    - ERROR | attributes: Missing required attribute `summary`.
    - ERROR | [iOS] unknown: Encountered an unknown error (The `FFAdditions` pod failed to validate due to 1 error.
[!] The validator for Swift projects uses Swift 3.0 by default, if you are using a different version of swift you can use a `.swift-version` file to set the version for your Pod. For example to use Swift 2.3, run: 
    `echo "2.3" > .swift-version`:
    - ERROR | attributes: Missing required attribute `summary`.
) during validation.
Analyzed 1 podspec.
[!] The spec did not pass validation, due to 2 errors.
[!] The validator for Swift projects uses Swift 3.0 by default, if you are using a different version of swift you can use a `.swift-version` file to set the version for your Pod. For example to use Swift 2.3, run: 
    `echo "2.3" > .swift-version`.

原因:没有填写summary信息,需要添加描述信息,如: s.summary = "第一次发布框架"

5.发布
wuxianlvzhoudeMacBook-Pro:Additions Allison$ pod trunk push

如果顺利的话,发布成功会出现如下界面:

Validating podspec
 -> FFAdditions (0.0.3)

Updating spec repo `master`

--------------------------------------------------------------------------------
 🎉  Congrats

 🚀  FFAdditions (0.0.3) successfully published
 📅  April 26th, 07:55
 🌎  https://cocoapods.org/pods/FFAdditions
 👍  Tell your friends!
--------------------------------------------------------------------------------

发布的时候常见的错误:

  • ERROR
[!] Found podspec `FFAdditions.podspec`
Updating spec repo `master`
Validating podspec
 -> FFAdditions (0.0.1)
[!] Unable to accept duplicate entry for: FFAdditions (0.0.1)

原因:意思是:不能接受同一版本的提交
解决方案:
5.1、执行如下命令

wuxianlvzhoudeMacBook-Pro:Additions Allison$ git tag 0.0.2
wuxianlvzhoudeMacBook-Pro:Additions Allison$ git push --tags
wuxianlvzhoudeMacBook-Pro:Additions Allison$ git push origin master

5.22、修改FFAdditions.podspec文件中的内容

Pod::Spec.new do |s|
  s.name         = "FFAdditions"
  s.version      = "0.0.2"
  s.summary      = "第一次发布框架"
  s.homepage     = "https://github.com/AllisonWangJiaoJiao/FFAdditions"
  s.license      = "MIT"
  s.author       = { "AllisonWangJiaoJiao" => "email@address.com" }
  s.platform     = :ios, "8.0"
  s.source       = { :git => "https://github.com/AllisonWangJiaoJiao/FFAdditions.git", :tag => s.version }
  s.source_files  = "FFAdditions", "Additions/**/*.{h,m}"
  s.requires_arc = true
end

5.3 3、执行命令 pod spec lint 验证并提交到CocoPods

wuxianlvzhoudeMacBook-Pro:Additions Allison$ pod spec lint
wuxianlvzhoudeMacBook-Pro:Additions Allison$ pod trunk push FFAdditions.podspec

到此大功告成,我们要尝试一下在终端执行 pod search FFAdditions,如果能搜到,代表你上传git的这个库,支持cocoapods了.但是我自己在操作的时候,悲催的发现执行这个 pod search FFAdditions命令的时候,出现这个错误
[!] Unable to find a pod with name, author, summary, or description matching 'FFAdditions'
这个时候只需要command+shift+G调出来前往文件夹的窗口,输入~/Library/Caches/CocoaPods/search_index.json文件将search_index.json删除,或者在终端执行rm ~/Library/Caches/CocoaPods/search_index.json
删除成功后再执行pod search,如果此时还是搜不到,
终端输入:pod setup
会出现Setting up CocoaPods master repo,稍等几十秒,最底下会输出Setup completed。说明执行pod setup成功。
如果pod search操作还是搜索失败,建议在终端多执行几次rm ~/Library/Caches/CocoaPods/search_index.json,然后再执行再执行pod search,稍等片刻就会出现你所要搜的类库了。

1.png

是不是和我们平时在GitHub上看到的一样了呢,小伙伴们,赶快动手试一下吧.😄

框架的优化
上面我们已经将框架发布到cocoapods上了,但是我们在控制台搜索AFNetworking的时候发现,AFN有很多Subspecs,也就是我们可以单独导入某一个子类

-> AFNetworking (3.1.0)
   A delightful iOS and OS X networking framework.
   pod 'AFNetworking', '~> 3.1.0'
   - Homepage: https://github.com/AFNetworking/AFNetworking
   - Source:   https://github.com/AFNetworking/AFNetworking.git
   - Versions: 3.1.0, 3.0.4, 3.0.3, 3.0.2, 3.0.1, 3.0.0, 3.0.0-beta.3,
   3.0.0-beta.2, 3.0.0-beta.1, 2.6.3, 2.6.2, 2.6.1, 2.6.0, 2.5.4, 2.5.3, 2.5.2,
   2.5.1, 2.5.0, 2.4.1, 2.4.0, 2.3.1, 2.3.0, 2.2.4, 2.2.3, 2.2.2, 2.2.1, 2.2.0,
   2.1.0, 2.0.3, 2.0.2, 2.0.1, 2.0.0, 2.0.0-RC3, 2.0.0-RC2, 2.0.0-RC1, 1.3.4,
   1.3.3, 1.3.2, 1.3.1, 1.3.0, 1.2.1, 1.2.0, 1.1.0, 1.0.1, 1.0, 1.0RC3, 1.0RC2,
   1.0RC1, 0.10.1, 0.10.0, 0.9.2, 0.9.1, 0.9.0, 0.7.0, 0.5.1 [master repo]
   - Subspecs:
     - AFNetworking/Serialization (3.1.0)
     - AFNetworking/Security (3.1.0)
     - AFNetworking/Reachability (3.1.0)
     - AFNetworking/NSURLSession (3.1.0)
     - AFNetworking/UIKit (3.1.0)

其实我们也可以将我们自己的框架分成许多的子类.找到我们自己的框架,新建分类文件夹,步骤如下:

1.png
  1. 使用Xcode打开YFAdditions.podspec文件

将这段话替换成下面的三句 s.source_files = "YFAdditions", "Additions//.{h,m}"*

s.subspec 'NSArray' do |n|
n.source_files = "YFAdditions", "Additions/NSArray/*/.{h,m}"
end

s.subspec 'NSAttributedString' do |att|
att.source_files = "YFAdditions", "Additions/NSAttributedString/*/.{h,m}"
end

s.subspec 'Runtime' do |r|
r.source_files = "YFAdditions", "Additions/Runtime/*/.{h,m}"
end

  1. 验证spec文件
wuxianlvzhoudeMacBook-Pro:Additions Allison$ pod spec lint

 -> YFAdditions (1.0.1)

Analyzed 1 podspec.

YFAdditions.podspec passed validation.

3.打tag

wuxianlvzhoudeMacBook-Pro:TEST Allison$ git tag 'v1.0.2'

4.把框架推送到git上

wuxianlvzhoudeMacBook-Pro:Additions Allison$ pod trunk push
//出现一下界面代表成功
Validating podspec
 -> YFAdditions (1.0.1)

Updating spec repo `master`
....
----------------------------------------------------------------------------
 🎉  Congrats

 🚀  YFAdditions (1.0.1) successfully published
 📅  August 7th, 01:44
 🌎  https://cocoapods.org/pods/YFAdditions
 👍  Tell your friends!
--------------------------------------------------------------------------------

4.在控制台搜索YFAdditions,出现以下信息代表成功


-> YFAdditions (1.0.1)
   YFAdditions框架
   pod 'YFAdditions', '~> 1.0.1'
   - Homepage: https://github.com/AllisonWangJiaoJiao/YFAdditions
   - Source:   https://github.com/AllisonWangJiaoJiao/YFAdditions.git
   - Versions: 1.0.1, 1.0.0 [master repo]
   - Subspecs:
     - YFAdditions/NSArray (1.0.1)
     - YFAdditions/NSAttributedString (1.0.1)
     - YFAdditions/Runtime (1.0.1)

5.安装你自己的库里面的某个分类,例如我需要 pod 'YFAdditions/NSArray', '~> 1.0.1'库,然后在终端执行pod install命令
注:这是可能会出现如下的error信息

[!] Error installing YFAdditions
[!] /usr/local/bin/git clone https://github.com/AllisonWangJiaoJiao/YFAdditions.git /var/folders/25/frh3dbts1mx9121vthcxqfrm0000gn/T/d20170807-14910-1fgegha --template= --single-branch --depth 1 --branch 1.0.1

Cloning into '/var/folders/25/frh3dbts1mx9121vthcxqfrm0000gn/T/d20170807-14910-1fgegha'...
warning: Could not find remote branch 1.0.1 to clone.
fatal: Remote branch 1.0.1 not found in upstream origin

这里是个隐藏很深的bug,因为你打tag的时候没有加"v"所报了这个错,当然如果你使用sourcetree操作的,可能并不会出现(不晓得什么原因),这里只需要重新打下tag,然后在推送到git,再次pod install即可

2.png

如果框架中有多个Subspecs,但是你仅仅需要其中的某几个,可以分别写也可以用统一的写法(两种写法效果相同):
方法一:
pod 'YFAdditions/NSArray'
pod 'YFAdditions/NSAttributedString'
方法二:
pod 'YFAdditions/NSArray', :subspecs => ['NSArray','NSAttributedString']

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

推荐阅读更多精彩内容