iOS 组件化实战篇（私有库）

2018-04-02 本文已影响157人 kvoxxx

前沿

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

为什么要组件化

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

组件化的细想

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

组件化的实现

在项目当中我们使用Cocoapod来管理我们的组件化开发

打开终端创建一个XXX项目工程
cd 到一个文件跟目录下

pod lib create xxx

配置下工程信息 Snip20180402_7.png
工程配置完成我们把我们需要的项目组件拖入到我们工程的Classes文件中然后 cd 进入到Example 文件中 pod install 安装下我们的组件
Snip20180402_9.png

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

配置描述文件 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

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

注意点：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

把自己私有库的索引添加到自己私有库中

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];

组件化之间的通讯