iOS 组件化实战篇(私有库)

前沿

本片文章主要讲解我们项目中为什么要组件化 组件化的好处 怎么使用组件化 怎么实现组件化

为什么要组件化

  • 随着项目的更新迭代 项目代码越来越复杂 每个模块之间相互依赖 更改一处代码 有可能要更改跟这段代码耦合度非常高的多处代码 导致增加了我们的开发时间 增加了不必要的麻烦
  • 使用组件化 可以把业务模块 共同的功能性代码和基础代码 分离出来 单独管理 每个开发人员只负责维护自己的模块就可以了 不仅节省了开发周期 还大大降低了维护成本

组件化的细想

就好比封装控件,复杂的控件一般都会封装,组件化只不过是把每个模块单独抽出来,作为一个小工程,然后在组成一个一个完整的项目

组件化的实现

  • 在项目当中我们使用Cocoapod来管理我们的组件化开发
  1. 打开终端 创建一个XXX项目工程
    cd 到一个文件跟目录下
pod lib create xxx
  1. 配置下工程信息
    Snip20180402_7.png
  2. 工程配置完成 我们把我们需要的项目组件拖入到我们工程的Classes文件中 然后 cd 进入到Example 文件中 pod install 安装下我们的组件

    Snip20180402_9.png

为什么要pod install,因为不重新pod install Example工程根本不知道Pod更新了,pod install的作用:重新让pod库与所依赖的工程文件产生关联
打开 Example 文件中的项目 Command+B 一下 如果没有问题 就说明集成成功

  1. 配置描述文件 podspec
    这里需要重点说一下 podspec 文件
    podspec : 描述自己组件工程的代码目录和资源目录在哪,还有自己组件工程所依赖其他框架,到时候就会根据podspec的指引去引入自己的仓库代码
// 创建pod索引库,固定写法,并且定义索引库的名字为s,后续通过s,就能拿到索引库
    Pod::Spec.new do |s|
    
      // 设置名称
      s.name         = "tcggMain"
    
      // 设置版本号
      s.version      = "0.0.1"
    
      // 设置摘要
      s.summary      = "A short description of tcggMain."
    
      // 设置详情
      s.description  = "Good"
    
      // 设置仓库主页
      s.homepage     = "http://xxxx/xxxx"
    
      // 设置许可证
      s.license      = "MIT"
    
      // 设置作者
      s.author             = { "iThinkerYZ" => "xxxx@qq.com" }
    
      // 设置仓库源,表示在哪可以找到组件工程
      s.source       = { :git => "xxxxx", :tag => "#{s.version}" }
    
      // 设置 源文件路径 => 不是整个工程的文件,而是自己封装的代码,以后别的工程引入,就会引入这里的代码。
      s.source_files  = "tcggMain/Classes/**/*.{h,m}"
    
     // s.dependency = '' 组件工程依赖哪些第三方框架
     // s.frameworks = 'UIKit', 'MapKit' 组件工程依赖哪些原生框架
     // s.resource_bundles = {} 组件工程图片资源
     
    end

PodSpec

  1. 本地组件配置完成之后 就需要把本地的组件上传的远程私有仓库( 上传的代码就不贴出来了 网上有很多 )

注意点push 远程仓库的时候 一定要打tag 并且tag的版本号要跟Spec文件中 s.version 的版本号一致 因为cocoapods是根据代码仓库的tag,去下载对应tag的远程代码库的

6.在本地Cocoapods索引库中创建我们私有组件的索引库文件

pod repo add 私有组件名称 索引库远程地址
pod repo add TcggBase https://git.coding.net/XUser/TccBase.git

如果不想使用命令行输入的话 我们也可以手动创建
-- 找到本地的cocoapods 的地址 在 repos 文件中创建一个 TcggBase 文件

Snip20180402_14.png

  1. 把自己私有库的索引添加到自己私有库中
pod repo push 索引库名称 当前组件中podspec文件全称
pod repo push TcggBase TcggBase.podspec --allow-warnings

本地索引库就会有自己的私有库,并且远程也会有,pod repo push 会帮我们推送到远程索引库

Snip20180402_15.png

打开本地cocoapods中自己的私有库索引地址 发现里面已经有了 我们自己的私有库索引 0.1.0 是我们的版本号 cocoapod 会根据Spec文件中的tag 创建相对应的文件名称

如果 Push 中出现的错误 我们也可以手动去上传
在cocoapods 本地索引库中 找到我们自己创建的索引库 在我们自己创建的索引库中 我们手动创建我们跟当前Spec文件中 描述的版本号相符的文件 文件名字就是我们当前组件的版本号 在把我们自己组件中的Spec文件复制 拷贝到当前的文件中去 就行了

使用自己的私有索引仓库

Podfile 文件中 添加两个 source 一个是cocoapods 公有的索引库源 一个是我们自己的索引库源 然后我们在pod 'xxx' pod install 就可以了

Snip20180402_17.png

组件化升级

  • 只需要把最新的版本代码绑定tag,更新Podspec文件,重新上传到版本索引库就好了
pod repo push xxxx xxxx.podspec --allow-warnings 
  • 工程文件在使用的时候,使用pod update 就能加载最新版本组件代码.
pod update --no-repo-update

Cocopods原理

1.根据Podfile描述,找到对应代码库的描述文件podspec
2.podspec中描述,去哪(s.source)才能找到代码库,并且找到之后,需要拷贝哪些文件(s.source_files)到自己的工程中。

组件化中遇到的一些问题

加载XIB文件报错
02576880-5A64-4125-AD02-2D6639931103.png

回到代码查看一下,原来加载XIB的方式如下


BC46FF90-7496-4DB7-86D0-BD080AF2AB9C.png

显然通过加载上面的bundle的方式加载不到XIB,需要重新设置budle的路径,修改如下:


55D1EFCD-B138-4AF9-B5BB-DD8F7878BFB1.png
图片资源加载问题

把组件中需要的图片存放到Assets

4A887AAA-B538-464B-A71E-5E6E8DBAD536.png

需要修改.podspec文件,打开资源的加载路径,然后执行pod install。然后会发现多了一个Resource的资源文件夹

FD4D7ECF-48C2-47BE-BBF6-9C708C6B0B70.png

需要改变图片的加载方式


94BC756A-0218-4662-BB14-5FEC4FC9E532.png

说明:必须指明图片的全名和图片所在bundle的包名
因为涉及到@2x,@3x图片这里不能写成固定的,应该按照scale来设置

02A9C836-51EF-4CC4-A26D-F346904B8717.png

因为之前设置图片的方式都需要修改,上面修改图片加载方式的代码在很多地方都会用到,所以最好的做法就是抽取一个工具方法

+ (instancetype)ff_imagePathWithName:(NSString *)imageName bundle:(NSString *)bundle targetClass:(Class)targetClass
{
        NSInteger scale = [[UIScreen mainScreen] scale];
        NSBundle *currentBundle = [NSBundle bundleForClass:targetClass];
        NSString *name = [NSString stringWithFormat:@"%@@%zdx",imageName,scale];
        NSString *dir = [NSString stringWithFormat:@"%@.bundle",bundle];
        NSString *path = [currentBundle pathForResource:name ofType:@"png" inDirectory:dir];
        return path ? [UIImage imageWithContentsOfFile:path] : nil;
}
修改字体

将字体相关文件也拖入到Assets文件夹下,然后修改一下podspec文件。最后执行pod install把字体资源pod进来。
接着在原来设置字体的地方做相应的修改,和修改图片资源路径的方式相似

   _categoryLabel = [[UILabel alloc]init];
    NSBundle *currentBundle = [NSBundle bundleForClass:[self class]];
    NSString *path = [currentBundle pathForResource:@"CODE BOLD.OTF" ofType:nil inDirectory:@"FFSpecialKit”];
    [_categoryLabel text:nil textColor:kHexColor_c7a762 fontSize:FONT_SIZE_14 fontName:path];
下一篇

组件化之间的通讯

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

推荐阅读更多精彩内容