【转】iOS:最详细的创建CocoaPods私有库教程

转自:http://www.cnblogs.com/XYQ-208910/p/6214066.html
一、感慨
说实话,创建这个CocoaPods私有库,我愣是搞了两个星期,创建的过程中,自己的感情波动是这样的:激情四射---->有点困惑----->极度困惑----->有点失望----->非常失望----->想放弃了----->放弃了----->不甘心,一个星期后又倒腾起来了----->还是失望----->向朋友求助----->问题解决,迟来的兴奋---->成功了,急切的想给大家分享成果。可以说,这个过程真是一波三折,遇到的各种坑让我百感交集。还好,我最终坚持到底,成功了,在此感谢我的好朋友@Kakarotto-卡卡罗特,下面我就给大家分享一下教程。

二、说说遇到的坑:
1、本地的私有仓库验证通过,但是远程仓库上的私有仓库验证不通过,路经不对,报Error[iOS] file patterns: The source_files pattern did not match any错误

解决办法:重新打开xxx.podspec文件编辑一下,确定共享文件路径没有错误,然后再上传到github上验证。

source_files文件格式有几种设置方法:

s.source_files = 'Classes/.{h,m}'
s.source_files = 'Classes/publicClass.{h,m}'
s.source_files = 'Classes'
s.source_files = 'Classes/
/.{h,m}'
2、上传xxx.podspec到github和给xxx.podspec打tag顺序搞反了,验证不通过

解决办法:必须先将本地文件夹所有的文件上传到github上,然后再给xxx.podspec打上tag,打tag方式也有两种方法:

命令行方式:

git tag -m "注释" 1.0.0
git push --tags
直接在github上点击release进入创建tag:

791499-20161223103951526-1141007884.png

3、xxx.podsepc、LICENSE、Demo、pulcicLib它们几个没有放在同一层级上,验证不通过

解决办法:将他们放到同一个文件夹的同一个层级上,例如

791499-20161223104637573-758494044.png

4、最后所有的验证都通过了也上传成功了,结果使用pod search仍然搜索不到,是因为search_index.json文件重复了,需要先删除再搜索

解决办法(此处是在成功安装CocoaPods,但不能pod search搜素类库的情况下探讨问题):

 4.1 执行pod setup

其实在你安装CocoaPods执行pod install时,系统会默认操作pod setup,然而由于中国强大的墙可能会pod setup不成功。这时就需要手动执行pod setup指令,如下:
终端输入:pod setup
会出现Setting up CocoaPods master repo ,稍等几十秒,最底下会输出setup completed。说明执行pod setup成功。
如果pod search操作还是搜索失败,如下:
终端输入:pod search AFNetworking
输出:Unable to find a pod with name,author,summary,or descriptionmastching 'AFNetworking' 这时就需要继续下面的步骤了。
4.2 删除~/Library/Caches/CocoaPods目录下的search_index.json文件

pod setup成功后,依然不能pod search,是因为之前你执行pod search生成了search_index.json,此时需要删掉。
终端输入:rm ~/Library/Caches/CocoaPods/search_index.json
删除成功后,再执行pod search。
4.3 执行pod search

终端输入:pod search sfneteorking (不区分大小写)
输出:Create search index for spec repo 'master'..Deno!,稍等片刻······就会出现所有带有afnetworking字段的类库。
5、验证私有仓库时如果出现gcc编译错误:[-Werror, -Wnon-modular-include-in-framework-module].造成xcode build failed

解决办法是加参数:--use-libraries

$ pod lib lint xxx.podspec --use-libraries
$ pod spec lint xxx.podspec --use-libraries
$ pod trunk push --use-libraries
提示:最后提一个小策略,如果验证时报错了,可以在验证时加上后缀--verbose来查看错误的具体位置

三、简述大致流程
在github上创建项目,复制项目的链接路径,例如:https://github.com/xiayuanquan/XYQCocoaPods.git;
使用命令行或者sourceTree将项目克隆到本地新建的一个文件夹中;
cd进入本地该文件夹,将自己之前的工程文件(demo)以及共享文件(共享库Lib)拖入其中,并创建私有仓库,例如:pod spec create cocoaPodsName;
编辑私有仓库信息(使用文本编辑器或者sublime等)
编辑结束保存,并验证本地的私有仓库是否有效(—allow-warnings可以消除警告)例如:pod lib lint cocoaPodsName.podspec —allow-warnings;
验证有效后,然后再将本地该文件夹中所有的文件push到github上
使用git tag(此方法操作后再push上传一次)或者直接在github上点击release进入后创建release并给私有仓库打上tag
注册trunk,例如:pod trunk register 邮箱 ‘用户名’ —descripttion=‘描述’,注意:邮箱为github上的登录邮箱、用户名为github上的用户名
接收发送到邮箱的链接,点击进入后注册成功
查看注册的个人信息,例如:pod trunk me
验证上传到github上的私有仓库是否有效(—allow-warnings可以消除警告,例如:pod spec lint cocoaPodsName.podspec —allow-warnings
将私有仓库推送到CocoaPods上,例如:pod trunk push cocoaPodsName.podspec
使用pod search cocoaPodsName搜索即可

四、详细步骤流程如下:
(1)在github上创建项目,复制项目的链接路径,例如:https://github.com/xiayuanquan/XYQCocoaPods.git;
![Uploading 791499-20161223105325245-1157266931_517404.png . . .]
(2)使用命令行或者sourceTree将项目克隆到本地新建的一个文件夹中;

791499-20161223105453167-507650403.png
791499-20161223105533636-576132103.png

(3)cd进入本地该文件夹,将自己之前的工程文件(demo)以及共享文件(共享库Lib)拖入其中,并创建私有仓库,例如:pod spec create cocoaPodsName;

791499-20161223105611589-1942059256.png

注意:下面说的是尽量都保持一样,其实,此处私有库名称必须和共享文件夹名称一样,而和github项目名一不一样,要求不那么严格

791499-20161223105716964-1211886217.png

(4)编辑私有仓库信息(使用文本编辑器或者sublime等,注意:引号不能搞错了,是英文格式的"",不是中文格式“”)

791499-20161223105821557-1687036411.png

(5)编辑结束保存,并验证本地的私有仓库是否有效(—allow-warnings可以消除警告)例如:pod lib lint cocoaPodsName.podspec —allow-warnings;

791499-20161223105915807-283899940.png

(6)验证有效后,然后再将本地该文件夹中所有的文件push到github上

791499-20161223110305823-1118604672.png

(7)使用git tag(此方法操作后再push上传一次)或者直接在github上点击release进入后创建release并给私有仓库打上tag

791499-20161223110420432-2110612782.png
791499-20161223110543995-1009159833.png
791499-20161223110608589-316911985.png

(8)注册trunk,例如:pod trunk register 邮箱 ‘用户名’ —descripttion=‘描述’,注意:邮箱为github上的登录邮箱、用户名为github上的用户名

![Uploading 791499-20161223110513151-1037094054-3_258257.png . . .]
(9)接收发送到邮箱的链接,点击进入后注册成功

791499-20161223110724542-1934033210.png

(10)查看注册的个人信息,例如:pod trunk me

791499-20161223110746604-1224144306.png

(11)验证上传到github上的私有仓库是否有效(—allow-warnings可以消除警告,例如:pod spec lint cocoaPodsName.podspec —allow-warnings

791499-20161223110813901-1709063508.png

(12)将私有仓库推送到CocoaPods上,此处时间会久一点,请耐心等待,例如:pod trunk push cocoaPodsName.podspec

791499-20161223110838979-2049955987.png

(13)使用pod search cocoaPodsName搜索即可

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

推荐阅读更多精彩内容