为什么需要组件化
单体架构的痛点
┌─────────────────────────────────────────────────────────┐ │ 单体应用架构 │ ├─────────────────────────────────────────────────────────┤ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ 首页 │←→│ 购物车 │←→│ 订单 │←→│ 我的 │ │ │ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ │ │ │ │ │ │ │ │ └────────────┴─────┬──────┴────────────┘ │ │ ↓ │ │ ┌─────────────────────────────────────────────────┐ │ │ │ 公共代码 & 工具类 │ │ │ │ (网络层、数据库、工具类、基础UI 全部耦合在一起) │ │ │ └─────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────┘ 问题： ❌ 编译时间长（修改一行代码需全量编译） ❌ 代码冲突频繁（多人协作噩梦） ❌ 业务边界模糊（功能交叉，职责不清） ❌ 无法独立测试（牵一发动全身） ❌ 技术债务累积（代码腐化严重）
组件化目标
┌─────────────────────────────────────────────────────────┐ │ 组件化架构 │ ├─────────────────────────────────────────────────────────┤ │ 独立开发 │ 独立测试 │ 独立发布 │ 快速编译 │ ├─────────────────────────────────────────────────────────┤ │ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ 首页组件 │ │ 购物车组件│ │ 订单组件 │ 业务层 │ │ └────┬────┘ └────┬────┘ └────┬────┘ │ │ │ │ │ │ │ ─────┴─────────────┴─────────────┴───── │ │ ↓ │ │ ┌─────────────────────────────────────┐ │ │ │ 组件通信中间件 │ 中间层 │ │ └─────────────────────────────────────┘ │ │ ↓ │ │ ┌────────┐ ┌────────┐ ┌────────┐ │ │ │ 网络库 │ │ 数据库 │ │ 工具库 │ 基础层 │ │ └────────┘ └────────┘ └────────┘ │ └─────────────────────────────────────────────────────────┘
组件化基础概念
组件分类
/* 组件分层金字塔 ┌──────────────┐ │ 壳工程 │ ← 主App，负责组装 │ (Host) │ └──────┬───────┘ │ ┌─────────────┼─────────────┐ │ │ │ ┌───▼───┐ ┌────▼────┐ ┌────▼────┐ │首页业务│ │购物车业务 │ │ 我的业务 │ ← 业务组件 └───┬───┘ └────┬────┘ └────┬────┘ │ │ │ └────────────┼─────────────┘ │ ┌────────────┼────────────┐ │ │ │ ┌───▼───┐ ┌───▼───┐ ┌────▼────┐ │ 分享 │ │ 支付 │ │ 登录 │ ← 功能组件 └───┬───┘ └───┬───┘ └────┬────┘ │ │ │ └───────────┼────────────┘ │ ┌───────────┼───────────┐ │ │ │ ┌───▼───┐ ┌───▼───┐ ┌────▼────┐ │ 网络库 │ │ UI库 │ │ 工具库 │ ← 基础组件 └───────┘ └───────┘ └─────────┘ */// MARK: - 基础组件示例/// 基础组件：无业务属性，纯技术能力封装publicclassNetworkKit{publicstaticletshared=NetworkKit()publicfuncrequest<T:Decodable>(_endpoint:Endpoint,responseType:T.Type)asyncthrows->T{// 网络请求实现}}// MARK: - 功能组件示例/// 功能组件：可复用的业务功能publicclassShareKit{publicstaticfuncshare(content:ShareContent,from viewController:UIViewController,completion:@escaping(Result<Void,Error>)->Void){// 分享实现}}// MARK: - 业务组件示例/// 业务组件：具体业务模块publicclassHomeModule:ModuleProtocol{publicstaticfuncinitialize(){// 模块初始化}publicstaticfunccreateViewController()->UIViewController{returnHomeViewController()}}
组件依赖原则
依赖规则图示： ┌─────────────┐ │ 业务层 │ 最上层 └──────┬──────┘ │ 依赖 ▼ ┌─────────────┐ │ 功能层 │ 中间层 └──────┬──────┘ │ 依赖 ▼ ┌─────────────┐ │ 基础层 │ 最底层 └─────────────┘ 规则： ✅ 上层可以依赖下层 ✅ 同层之间通过协议/中间件通信 ❌ 下层不可依赖上层 ❌ 禁止循环依赖
模块拆分策略
拆分维度分析
/* 模块拆分考虑因素： 1. 业务边界 ┌────────────────────────────────────────────┐ │ 电商App业务域划分 │ ├────────────┬────────────┬─────────────────┤ │ 商品域 │ 交易域 │ 用户域 │ │ ├─商品详情 │ ├─购物车 │ ├─登录注册 │ │ ├─商品搜索 │ ├─订单 │ ├─个人中心 │ │ └─商品分类 │ └─支付 │ └─消息通知 │ └────────────┴────────────┴─────────────────┘ 2. 团队结构 ┌────────────────────────────────────────────┐ │ 按团队划分模块 │ ├────────────┬────────────┬─────────────────┤ │ A团队 │ B团队 │ C团队 │ │ 负责首页 │ 负责交易 │ 负责用户 │ └────────────┴────────────┴─────────────────┘ 3. 变更频率 ┌────────────────────────────────────────────┐ │ 高频变更 → 独立组件，快速迭代 │ │ 低频变更 → 可合并，减少维护成本 │ └────────────────────────────────────────────┘ */// MARK: - 模块拆分示例/// 业务模块定义enumBusinessModule:String,CaseIterable{casehome="Home"// 首页模块caseproduct="Product"// 商品模块casecart="Cart"// 购物车模块caseorder="Order"// 订单模块caseuser="User"// 用户模块casemessage="Message"// 消息模块/// 模块优先级（用于启动顺序）varpriority:Int{switchself{case.user:return100// 用户模块最先初始化case.message:return90case.home:return80case.product:return70case.cart:return60case.order:return50}}}/// 功能模块定义enumFeatureModule:String{caseshare="Share"// 分享casepayment="Payment"// 支付casepush="Push"// 推送caseanalytics="Analytics"// 数据统计caseimageLoader="Image"// 图片加载}/// 基础模块定义enumCoreModule:String{casenetwork="Network"// 网络casedatabase="Database"// 数据库casecache="Cache"// 缓存caselog="Log"// 日志caserouter="Router"// 路由}
Podfile 组织结构
# Podfile 组件化配置示例platform:ios,'13.0'use_frameworks!inhibit_all_warnings!# ========================# 组件源配置# ========================source'https://github.com/CocoaPods/Specs.git'# 公共源source'https://your-company.com/ios-specs.git'# 私有源# ========================# 抽象目标 - 公共依赖# ========================abstract_target'CommonPods'do# 基础层组件pod'CoreNetwork','~> 1.0'pod'CoreDatabase','~> 1.0'pod'CoreCache','~> 1.0'pod'CoreLogger','~> 1.0'pod'CoreRouter','~> 1.0'pod'CoreUIKit','~> 1.0'# 功能层组件pod'FeatureShare','~> 1.0'pod'FeaturePayment','~> 1.0'pod'FeaturePush','~> 1.0'# 主工程target'MainApp'do# 业务层组件pod'BizHome','~> 1.0'pod'BizProduct','~> 1.0'pod'BizCart','~> 1.0'pod'BizOrder','~> 1.0'pod'BizUser','~> 1.0'pod'BizMessage','~> 1.0'target'MainAppTests'doinherit!:search_pathspod'Quick'pod'Nimble'endend# 组件独立调试工程target'BizHomeDemo'dopod'BizHome',:path=>'../BizHome'endtarget'BizProductDemo'dopod'BizProduct',:path=>'../BizProduct'endend# ========================# Post Install Hook# ========================post_installdo|installer|installer.pods_project.targets.eachdo|target|target.build_configurations.eachdo|config|config.build_settings['IPHONEOS_DEPLOYMENT_TARGET']='13.0'# 开启模块稳定性config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION']='YES'endendend
组件 Podspec 规范
# BizHome.podspec - 业务组件规范Pod::Spec.newdo|s|s.name='BizHome's.version='1.0.0's.summary='首页业务组件's.description=<<-DESC首页业务组件，包含：-首页推荐流-Banner轮播-分类入口-活动专区DESCs.homepage='https://your-company.com/BizHome's.license={:type=>'MIT',:file=>'LICENSE'}s.author={'iOS Team'=>'ios@company.com'}s.source={:git=>'https://github.com/company/BizHome.git',:tag=>s.version.to_s}s.ios.deployment_target='13.0's.swift_version='5.0'# 源码s.source_files='BizHome/Classes/**/*'# 资源文件s.resources='BizHome/Assets/**/*'s.resource_bundles={'BizHomeBundle'=>['BizHome/Assets/*.xcassets','BizHome/Assets/*.xib']}# 公开头文件（给其他组件使用的接口）s.public_header_files='BizHome/Classes/Public/**/*.h'# ========================# 依赖声明（关键！）# ========================# 只依赖协议层，不依赖具体实现s.dependency'ServiceProtocols','~> 1.0'# 依赖基础组件s.dependency'CoreUIKit','~> 1.0's.dependency'CoreNetwork','~> 1.0's.dependency'CoreRouter','~> 1.0'# 依赖功能组件（通过协议）# 注意：不直接依赖 BizProduct、BizCart 等业务组件！# ========================# 子模块划分# ========================s.subspec'Core'do|core|core.source_files='BizHome/Classes/Core/**/*'ends.subspec'UI'do|ui|ui.source_files='BizHome/Classes/UI/**/*'ui.dependency'BizHome/Core'ends.default_subspecs='Core','UI'end
依赖反转原则
依赖反转核心思想
传统依赖 vs 依赖反转 【传统依赖】 ┌─────────────┐ ┌─────────────┐ │ 首页模块 │ ──────→ │ 商品模块 │ │ (高层模块) │ 依赖 │ (低层模块) │ └─────────────┘ └─────────────┘ 问题：首页直接依赖商品模块，耦合严重 【依赖反转】 ┌─────────────┐ ┌─────────────────┐ │ 首页模块 │ ──────→ │ 商品服务协议 │ │ (高层模块) │ 依赖 │ (抽象) │ └─────────────┘ └────────┬────────┘ │ │ 实现 │ ┌────────▼────────┐ │ 商品模块 │ │ (具体实现) │ └─────────────────┘ 优势： ✅ 高层模块不依赖低层模块 ✅ 两者都依赖抽象 ✅ 抽象不依赖细节 ✅ 细节依赖抽象
协议层设计
// MARK: - 服务协议层（独立Pod: ServiceProtocols）// ═══════════════════════════════════════════════════════// 商品服务协议// ═══════════════════════════════════════════════════════/// 商品信息模型（协议层定义，与具体模块无关）publicstructProductInfo:Codable,Hashable{publicletid:Stringpublicletname:Stringpublicletprice:DecimalpublicletimageURL:URL?publicletdescription:Stringpublicletstock:Intpublicinit(id:String,name:String,price:Decimal,imageURL:URL?,description:String,stock:Int){self.id=idself.name=nameself.price=priceself.imageURL=imageURLself.description=descriptionself.stock=stock}}/// 商品服务协议publicprotocolProductServiceProtocol{/// 获取商品详情funcfetchProduct(by id:String)asyncthrows->ProductInfo/// 获取商品列表funcfetchProducts(category:String,page:Int,pageSize:Int)asyncthrows->[ProductInfo]/// 搜索商品funcsearchProducts(keyword:String)asyncthrows->[ProductInfo]/// 获取商品详情页funcproductDetailViewController(productId:String)->UIViewController}// ═══════════════════════════════════════════════════════// 购物车服务协议// ═══════════════════════════════════════════════════════/// 购物车项模型publicstructCartItem:Codable,Identifiable{publicletid:StringpublicletproductId:StringpublicletproductName:Stringpublicletprice:Decimalpublicvarquantity:IntpublicletimageURL:URL?publicinit(id:String,productId:String,productName:String,price:Decimal,quantity:Int,imageURL:URL?){self.id=idself.productId=productIdself.productName=productNameself.price=priceself.quantity=quantityself.imageURL=imageURL}}/// 购物车服务协议publicprotocolCartServiceProtocol{/// 添加商品到购物车funcaddToCart(productId:String,quantity:Int)asyncthrows/// 从购物车移除商品funcremoveFromCart(itemId:String)asyncthrows/// 更新购物车商品数量funcupdateQuantity(itemId:String,quantity:Int)asyncthrows/// 获取购物车列表funcfetchCartItems()asyncthrows->[CartItem]/// 获取购物车商品数量（用于Tab角标）funccartItemCount()->Int/// 购物车数量变化通知varcartCountPublisher:AnyPublisher<Int,Never>{get}}// ═══════════════════════════════════════════════════════// 用户服务协议// ═══════════════════════════════════════════════════════/// 用户信息模型publicstructUserInfo:Codable{publicletuserId:Stringpublicletnickname:Stringpublicletavatar:URL?publicletphone:String?publicletisVip:Boolpublicinit(userId:String,nickname:String,avatar:URL?,phone:String?,isVip:Bool){self.userId=userIdself.nickname=nicknameself.avatar=avatarself.phone=phoneself.isVip=isVip}}/// 登录状态publicenumLoginState{casenotLogincaseloggingcaselogged(UserInfo)caseexpired}/// 用户服务协议publicprotocolUserServiceProtocol{/// 当前登录状态varcurrentState:LoginState{get}/// 登录状态变化发布者varstatePublisher:AnyPublisher<LoginState,Never>{get}/// 获取当前用户信息funccurrentUser()->UserInfo?/// 是否已登录funcisLoggedIn()->Bool/// 登录funclogin(phone:String,code:String)asyncthrows->UserInfo/// 登出funclogout()asyncthrows/// 展示登录页面funcpresentLoginIfNeeded(from viewController:UIViewController,completion:@escaping(Bool)->Void)}// ═══════════════════════════════════════════════════════// 订单服务协议// ═══════════════════════════════════════════════════════/// 订单状态publicenumOrderStatus:String,Codable{casepending="pending"// 待支付casepaid="paid"// 已支付caseshipping="shipping"// 配送中casedelivered="delivered"// 已送达casecompleted="completed"// 已完成casecancelled="cancelled"// 已取消}/// 订单信息publicstructOrderInfo:Codable,Identifiable{publicletid:StringpublicletorderNo:Stringpublicletstatus:OrderStatuspubliclettotalAmount:Decimalpublicletitems:[OrderItem]publicletcreateTime:DatepublicstructOrderItem:Codable{publicletproductId:StringpublicletproductName:Stringpublicletprice:Decimalpublicletquantity:Int}}/// 订单服务协议publicprotocolOrderServiceProtocol{/// 创建订单funccreateOrder(from cartItems:[CartItem],addressId:String)asyncthrows->OrderInfo/// 获取订单列表funcfetchOrders(status:OrderStatus?,page:Int)asyncthrows->[OrderInfo]/// 获取订单详情funcfetchOrderDetail(orderId:String)asyncthrows->OrderInfo/// 取消订单funccancelOrder(orderId:String)asyncthrows/// 订单详情页funcorderDetailViewController(orderId:String)->UIViewController}// ═══════════════════════════════════════════════════════// 路由服务协议// ═══════════════════════════════════════════════════════/// 路由路径定义publicenumRoutePath{casehomecaseproductDetail(productId:String)caseproductList(category:String)casecartcaseorder(orderId:String)caseorderList(status:OrderStatus?)caseuserCentercaselogincasewebView(url:URL,title:String?)casecustom(path:String,params:[String:Any])publicvarpathString:String{switchself{case.home:return"/home"case.productDetail(letid):return"/product/\(id)"case.productList(letcategory):return"/products?category=\(category)"case.cart:return"/cart"case.order(letid):return"/order/\(id)"case.orderList:return"/orders"case.userCenter:return"/user"case.login:return"/login"case.webView(leturl,_):return"/web?url=\(url.absoluteString)"case.custom(letpath,_):returnpath}}}/// 路由服务协议publicprotocolRouterServiceProtocol{/// 注册路由处理器funcregister(path:String,handler:@escaping(URL,[String:Any])->UIViewController?)/// 导航到指定路径funcnavigate(to path:RoutePath,from viewController:UIViewController?,animated:Bool)/// 通过URL导航funcopen(url:URL,from viewController:UIViewController?)/// 返回funcgoBack(from viewController:UIViewController,animated:Bool)/// 返回到根视图funcpopToRoot(from viewController:UIViewController,animated:Bool)}
服务注册与发现
// MARK: - 服务容器（依赖注入容器）/// 服务容器 - 单例模式publicfinalclassServiceContainer{publicstaticletshared=ServiceContainer()privatevarservices:[String:Any]=[:]privatevarfactories:[String:()->Any]=[:]privateletlock=NSRecursiveLock()privateinit(){}// ═══════════════════════════════════════════════════════// 注册服务// ═══════════════════════════════════════════════════════/// 注册服务实例（单例模式）publicfuncregister<T>(_type:T.Type,instance:T){lock.lock()defer{lock.unlock()}letkey=String(describing:type)services[key]=instanceprint("📦 [ServiceContainer] Registered:\(key)")}/// 注册服务工厂（每次获取创建新实例）publicfuncregisterFactory<T>(_type:T.Type,factory:@escaping()->T){lock.lock()defer{lock.unlock()}letkey=String(describing:type)factories[key]=factoryprint("🏭 [ServiceContainer] Registered Factory:\(key)")}/// 注册服务工厂（懒加载单例）publicfuncregisterLazy<T>(_type:T.Type,factory:@escaping()->T){lock.lock()defer{lock.unlock()}letkey=String(describing:type)factories[key]={[weakself]inifletexisting=self?.services[key]as?T{returnexisting}letinstance=factory()self?.services[key]=instancereturninstance}print("💤 [ServiceContainer] Registered Lazy:\(key)")}// ═══════════════════════════════════════════════════════// 获取服务// ═══════════════════════════════════════════════════════/// 获取服务（可选）publicfuncresolve<T>(_type:T.Type)->T?{lock.lock(
)