iOS 创作自己的私有库

前言:

项目组件化的好处我就不不多说了,今天我就跟大家分享一下项目组件化第一步:创作自己的私有库,以及自己遇到的令人酸爽的bug.

之前当在项目中看到这样的目录后,是不是默默有一种高高在上,可远观而不可亵玩焉的感觉。当时我多想在这个目录下有自己的代码呀。只要不断努力,梦想并不遥远!

首先说一下cocoapoads怎么把我们想要的三方库下载到我们的工程里面的呢?理解了这个,下面对我们自己建立的私库就好理解了.

在GitHub 上https://github.com/CocoaPods/Specs链接下放着pod管理三方库的podspec文件,随便点开其中一个。索引库,如下图

这里面放着三方库URLComponentsBuilder的一下信息,name, version ,summary, authors,homepage等信息。

在我们在终端输入pod setup,会将远程索引库下载到我们本地方便pod search,cocapods本地spec索引库的位置:/Users/mac/.cocoapods/repos/master/Specs

pod search时会根据本地specs仓库去创建search_index.json的索引文件,索引文件中包含了一个个三方库的podspec文件中的信息,search_index.json文件的位置:/Users/mac/Library/Caches/cocoapods/search_index.json

pod install时候,会根据要安装的三方库的podspec索引文件,找到三方库的下载地址和版本信息,然后下载到我们工程里面。

开始步入正题

首先建立自己的私库

1、本地私有索引库

2、远程私有索引库

3、本地组件代码库

4、远程组件代码库

大致流程是,创建自己的远程索引库,创建本地索引库,本地远程索引库关联,创建自己的远程组件代码仓库,创建自己的本地的组件代码仓库,把自己的组件代码放进去提交到远程组件代码仓库,本地校验,远程校验,将自己创建的索引文件 push到远程索引库进行管理。

------------------------------------------------------------------------------------------------------

光说不练假把式,现在我们创建一个网络请求的组件,上传到自己的私有库。

1、在github上创建自己的远程索引库仓库,名字自己起,copy地址,我这已经创建过了,就不重复创建了,创建完一次,自己之后的远程代码索引都可以放在这里了。

注意事项:

这里面写个说明文件啥的,不要为空,或者接下来会出现不可描述的错误,这是我踩过的坑总结出来的教训。如果为空会出现下面的错误。

Your configuration specifies to merge with the ref 'refs/heads/master'

from the remote, but no such ref was fetched.

2、本地索引库和远程索引库关联

pod repo add JSpecs https://github.com/canlanrensheng/JSpecs.git

然后pod repo查看

会多出本地索引库JSpecs

3、创建自己的远程组件代码库,并copy地址

4、创建自己的本地组件代码仓库

cd ~/Desktop/

执行pod lib create JSHttpToolKit

根据需要填写下面的信息

成功之后把我们自己写的组件代码放在下面的目录下

cd 进入 Example 文件目录下

执行 pod install  把你封装的代码集成到Example中.

编辑JSHttpToolKit.podspec信息,如下图,因为我写的需要依赖AFNetworking库,所以s.dependency要加上相应的依赖库,不依赖的不用加。

记住s.version版本号,下边要用

cd 到本地组件目录下

开始提交代码到远程组件代码仓库

git add .

git commit -m '1.0.0代码提交'

git remote add origin https://github.com/canlanrensheng/JSHttpToolKit.git

git push origin master

git tag '1.0.0' (这里的tag要跟上面的JSHttpToolKit.podspec的version一致,要不然会出现不可描述的错误)

git push --tags

5、本地验证

pod lib lint JSHttpToolKit.podspec --allow-warnings

三方库包含静态库(如:xxxx.a),在验证的时候,不能验证通过,可使用如下命令:pod lib lint --use-libraries --allow-warnings

如果没有依赖三方库的话去掉 --use-libraries如下:

pod lib lint JSHttpToolKit.podspec --allow-warnings

6、远程验证

pod spec lint --allow-warnings

三方库包含静态库(如:xxxx.a),在验证的时候,不能验证通过,可使用如下命令:pod lib lint--use-libraries  --allow-warnings

如果没有依赖三方库的话去掉 --use-libraries如下:

pod spec lint --allow-warnings

//编辑报错的问题 trunk URL couldn't be downloaded:xxx 应该是源的问题

pod lib lint JSVideoBrowserKit.podspec  --use-libraries  --allow-warnings --sources='https://github.com/CocoaPods/Specs.git'

7、将你的.podspec索引文件 push到索引库进行管理

pod repo push JSpecs JSHttpToolKit.podspec --use-libraries --allow-warnings

如果出现报错 runk URL couldn't be downloaded:xxx 应该是源的问题

pod repo push JSSpecs JSVideoBrowserKit.podspec --use-libraries  --allow-warnings --sources='https://github.com/CocoaPods/Specs.git'


查看pod repo


cd到本地索引库的这个目录下cd /Users/zhangjinshan/.cocoapods/repos/JSpecs

ls查看

说明已经添加到本地的索引库里面了。Perfect!

到这里我们就完成了自己的网络请求组件的制作,接下来看怎么用呢?

新建一个测试工程,并在工程目录下创建podfile

引入Specs和自己的远程索引库的地址

cd到测试目录下,执行pod install

在需要的地方引入我们的头文件就可以了。

到此,创建自己的私有库就完成了。欢迎批评指正!

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

推荐阅读更多精彩内容