组件化之路(-)私有库制作

项目更新到一定的阶段,工程越来越大,编译时间越来越长,我们一般会将项目抽取成一个个的组件,组件一般都会使用cocoaPods 来制作成私有库来相互引用,话不多说,第一次的制作,真是一步一个坑,这里做个总结:

制作私有库,一定要创建两个仓库 一个存放私有的PodSpesc ,另一个仓库存放私有的组件代码。


这个很重要 ,,很重要,, 很重要。。


(一开始不知道,被坑了好久。。)默认的podSpesc是放在官方仓库的,我们是私有库,不想被别人使用,所以需要单独创建一个podSpesc仓库

1, 先创建podSpesc仓库,因为是私有的,我们一般选择 coding, 码云gitLab等git仓库。因为私有的免费。。 我们公司选择的是gitLab ,所以这里以GitLab 做示例;

B2120B72-F09E-49BD-83B2-1E5A34060A5E.png

将私有的这个podSpesc 关联到本地,
// 我们先查询当前本地的pod 库,一般会有一个master 这个是cocoaPods官方的repo
$ pod repo

将我们创建的仓库添加到本地热repo里,
$ pod repo add QFPodSpec http://xxxxx.com/xxxt/QFPodSpec.git

3E86F43E-33C9-446F-A3AC-B726DA0BFA54.png

$ pod repo
可以发现我们本地的repo里多了个QFPodSpec

QQ20180804-114719@2x.png

至此,我们第一步,创建私有的spec仓库算是完成,现在开始创建私有的组件工程。

使用 pod 命令创建一个模板工程。
$ pod lib create 项目名称
在创建的过程中会询问你四个问题,
What platform do you want to use?? [ iOS / macOS ]
iOS
What language do you want to use?? [ Swift / ObjC ]
ObjC
Would you like to include a demo application with your library? [ Yes / No ]
Which testing frameworks will you use? [ Specta / Kiwi / None ]
What is your class prefix?
看自己需求回答。
克隆完成之后,会自动打开工程。

工程结构如下:


QQ20180804-115937@2x.png

我们的项目文件需要放在,Classes 文件夹下;
这里我添加了一些项目中常用的小工具

QQ20180804-120226@2x.png

进入到 Example 文件夹路径下, 执行
$ pod update

执行完毕后打开 Example 工程。编译运行,如果存在错误,需要解决掉。
可以发现我们添加的文件被放在了Development Pods 文件下

QQ20180804-120759@2x.png

确认编译通过后,开始修改工程的,.podspec文件
podspec是我们私有库的描述文件,

QQ20180804-121149@2x.png

注意:s.verison 必须要跟我们私有库的tag 保持一致。
s.description 必须要修改
s.source 修改成私有库的地址。


由于podspec需要填写私有库的地址,这里我们创建一个私有库仓库。

QQ20180804-121737@2x.png

将仓库地址替换掉s.source 路径,pod 是根据这个地址来索引我们的私有库的。


所有的修改完毕之后,我们将修改提交到代码仓库。

cd 到当前项目路径
// 查看当前文件状态
git status
// 提交修改文件
git add .
git commit -m '修改说明'
// 查看当前远程仓库
git remote // 当前我们还没有添加,所有是空的,
// 添加远程仓库
git remote add origin 仓库地址,//(我们刚创建的QFCommon的仓库地址)
// 推送到远程仓库
git push origin master
// 给我们的修改打上tag (再说一遍这里的tag 一定要和podspec 里的s.version 保持一致)
git tag -a 0.0.1 -m '0.0.1'
// 推送tag
git push --tags

至此,我们的远程仓库里已经有了工程并且也已经打上了tag。


image.png

下一步 我们就需要将podSpec 上传到我们的私有仓库里。

我们先在本地验证当前的podspec 是否合法
$ pod lib lint QFCommon.podspec --allow-warnings
// --allow-warnings 忽略掉相应的警告,
如果有错误,可以加上,
pod lib lint QFCommon.podspec --allow-warnings --verbose
// --verbose 查看详细分析信息。(这里踩坑无数,待会再说)
// 如果当前的私有库依赖了其他的私有库,需要添加私有库的spec的地址,
pod lib lint QFCommon.podspec --sources=http://xxxx/xxx/myPodSpec.git,https://github.com/CocoaPods/Specs.git --allow-warnings --use-libraries
// 当私有库里引用了第三方的静态库,需要添加 --use-libraries
当看到 QFCommon passed validation. 表示验证通过。

验证通过后,我们开始上传到我们的远程仓库(验证通过,不代表上传就一定能过,这里也有坑。。)
// 上传我们的podspec 到私有的仓库
$ pod repo push QFPodSpec QFCommon.podspec --allow-warnings
// 如果依赖了私有库,在上传时,同样需要添加上--sources= 路径

!!!!! 这里一定要分清 QFPodSpec 是我们创建的私有的podspec 仓库名称, QFCommon.podspec 是我们组件的描述文件的podspec. 一定分清 ,分清,分清,, !!!!!!

如果上传成功的话,在远程仓库里就可以看到我们组件对应的podspec了。


image.png

在本地的repo里也能发现我们的spec


image.png

现在执行
pod search QFCommon //应该就可以搜索到我们的组件了,
如果搜索不到,可以删除索引,试试。
m ~/Library/Caches/CocoaPods/search_index.json


走到这里我们算是把私有库制作完成了,因为是私有库,在使用的时候,需要在对应的podfile 添加上私有库对应的,podspec的路径

image.png

在制作的过程中遇到的坑

1,
如果你的podspec文件里包含中文字符,那么在pod lib lint 验证的时候有可能会报utf8编码错误,所以尽量不要在podspec里包含中文。
2,在设置子组件时,如果依赖于其他库,需要设置;

image.png

其中如果A文件夹下依赖于另一个B文件夹的内容也需要设置相应的 依赖路径,不然在pod repo push的时候,有可能会报

xxxx.h' file not found

3, 如果私有库里包含Xib文件 那么在加载xib是需要根据bundle加载。

  
    NSString *className = NSStringFromClass([self class]);
    NSBundle *bundle = [NSBundle bundleForClass:self];
    NSString *bundleName = bundle.infoDictionary[@"CFBundleName"];
    NSString *nibName = [NSString stringWithFormat:@"%@.bundle/%@", bundleName, className];
    return [bundle loadNibNamed:nibName owner:nil options:nil].lastObject;

并且 需要在podspec 里描述相应的路径。

  s.resource_bundles = {
    'QFCommon' => ['QFCommon/Classes/Tools/**/*.xib']
  }

另外在使用私有库的时候,因为包含了资源文件,那么就需要将podfile 里面的 use_frameworks! 打开,不然会找不到资源。

Could not load NIB in bundle:

如果包含图片,需要将图片放在,私有库对应的Assets里面。

image.png

并且将路径描述在, s.resource_bundles 的数组里 (多个路径,可以相应的依次添加)

 s.resource_bundles = {
    'QFCommon' => ['QFCommon/Classes/Tools/**/*.xib', xxx/xxx/xxx]
  }

5, 如果确定已经打上tag,并且在远程仓库上也能找到tag,但是在推送podspec到远程的时候报:

Remote branch 0.0.1 not found in upstream origin

查看podspecs.source 的地址是否和远程仓库的地址一致。

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

推荐阅读更多精彩内容