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

我就是我 2022-10-01 05:44 184阅读 0赞

# **前沿** #

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

# **为什么要组件化** #

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

# **组件化的细想** #

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

# **组件化的实现** #

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

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

pod lib create xxx
    复制代码

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

为什么要`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` 文件

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

pod repo push 索引库名称 当前组件中podspec文件全称
    pod repo push TcggBase TcggBase.podspec --allow-warnings
    复制代码

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

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

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

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

# 组件化升级 #

*  只需要把最新的版本代码绑定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文件报错 ######

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

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

### 图片资源加载问题 ###

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

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

需要改变图片的加载方式

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

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

+ (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];
    复制代码

##### 下一篇 #####

**[组件化之间的通讯][Link 1]**

转载于:https://juejin.im/post/5cb98b51e51d456e3a5f080d

[PodSpec]: https://link.juejin.im?target=https%3A%2F%2Fwww.jianshu.com%2Fp%2Ff841e248bc4f
[Link 1]: https://link.juejin.im?target=https%3A%2F%2Fwww.jianshu.com%2Fp%2F596d4efbbccb