網路上關於 iOS 模組化的介紹不少,但真正落到具體實例的卻不多。本文系統性地說明我對模組化解決方案的理解,內容涵蓋解耦、路由、封裝與私有 Pod 管理等面向,並附上一個開源實例專案(jiaModuleDemo),裡面已放了一些封裝好的功能模組,會持續更新優化。若你有更好的方案或建議,歡迎提 issue。
一、專案中實際存在的問題
問題一:多專案之間的代碼重複與失控
公司同時推進多個專案、且由不同成員分別負責時,就會出現下圖那種狀況。其實每個 App 裡都有大量功能相同的模組,常見做法是直接把代碼複製一份到新專案,但這並不是好方案。在後續反覆迭代的過程中,不同的人都會往裡面塞進帶有個人風格的代碼,最後同一個模組在多個專案中的實作漸行漸遠,統一管理形同災難,甚至完全失控。專案交接給別人接手時,也會無形中浪費大量時間,維護成本節節攀升。
因此實例中更強調「求同存異」——把相同模組提取出來,再用模組化搭配私有 Pod 做統一管理。對於日誌記錄、網路請求、網路狀態變化提示這類高頻功能,只要對外開放出簡單的開關配置,就能一行接入。

問題二:頁面之間高度耦合,傳參方式混亂
頁面互相直接引用,而各頁面的傳參形式又五花八門——有人傳實體物件,有人傳基本型別,取決於開發者當下的方便程度。舊專案也不支援路由,導致「收到推播後跳轉到不同頁面」這種需求只能靠硬編碼實作,功能擴展性極差。
右圖則是模組化之後的交互方式:頁面之間不再有耦合關係,全部只依賴 JiaMediator 這個中介者;傳參也統一為字典形式。雖然犧牲了一些隨意性,卻換來了真正的解耦。同時加入路由處理,並以約定好的協議完成交互。之所以自實作路由而非採用第三方插件,是因為靈活性更高,更重要的是省去了第三方方案在啟動時批量註冊路由的負擔。

二、模組化方案的實作
1. JiaCore:基礎功能封裝
JiaCore 是整個 App 最底層的模組,所有其他模組都依賴它,主要容納全域性的基礎能力,例如 JiaBaseViewController、JiaAppDelegate 等。目前已把一些預設功能整合進來,包括網路狀態變化判斷與提示、日誌記錄等;相關配置則統一交由 JiaCoreConfigManager 這個管理類處理,開放給具體 App 設定全域參數。
以日誌記錄功能為例:
// JiaCore 基礎模組相關配置 JiaCoreConfigManager *jiaCoreConfig = [JiaCoreConfigManager sharedInstance]; jiaCoreConfig.recordlogger = YES; // 具體 App 的 PrefixHeader.pch 中引入命名空間並設定記錄等級 #import "JiaCocoaLumberjack.h" static const int ddLogLevel = DDLogLevelVerbose;
這樣就完成了日誌模組的接入。JiaCore 已經把相關配置都處理好了,錯誤內容會以可讀性較佳的格式寫入檔案,檔案的產生規則也都預先定義;若想在 Xcode 控制台看到不同等級的顏色區分,只要安裝 XcodeColors 插件並稍作設定即可,各等級的顏色映射在 JiaCore 中已配置完成。
2. JSPatch 熱更新能力
JiaCore 也預設整合了熱更新。只要傳入一個模型陣列就會啟動流程,其中 JiaPathchModel 是預先定義好的模型:patchId 是唯一標識、md5 是 JS 檔的 MD5 值、url 是下載路徑、ver 則表示該補丁作用於哪個版本。
由於線上通常存在多個版本同時運行,熱更新必須做版本區隔,只下載與當前版本對應的 JS 檔。MD5 校驗則是為了安全性——避免 JS 檔被竄改而影響 App 運行,JiaCore 會在下載後計算 MD5 並比對。此外,不在 jSPatchMutableArray 清單中的舊 JS 檔會被刪除。
JiaPathchModel *sample = [[JiaPathchModel alloc] init]; sample.patchId = @"patchId_sample1"; sample.md5 = @"2cf1c6f6c5632dc21224bf42c698706b"; sample.url = @"https://test.qshmall.net:9090/demo1.js"; sample.ver = @"1"; JiaPathchModel *sample1 = [[JiaPathchModel alloc] init]; sample1.patchId = @"patchId_sample2"; sample1.md5 = @"e8a4eaeadce5a4598fb9a868e09c75fd"; sample1.url = @"https://test.qshmall.net:9090/demo2.js"; sample1.ver = @"1"; // JiaCore 基礎模組相關配置 JiaCoreConfigManager *jiaCoreConfig = [JiaCoreConfigManager sharedInstance]; jiaCoreConfig.jSPatchMutableArray = [@[sample, sample1] mutableCopy];
3. JiaGT:個推封裝
推播對 App 的重要性不言而喻,實務上多採用第三方 SDK。這類 SDK 的接入代碼大同小異,所以這個模組的做法是把差異化內容提取出來,以個推為例進行封裝。
推播相關代碼通常集中在 AppDelegate 中,造成大量雜亂代碼。常見解法是把 AppDelegate 拆成多個分類,但這裡採用另一種思路:把 SDK 相關邏輯完全抽到模組內部,讓具體 App 中不再出現任何個推相關代碼,只需簡單配置與回調處理。以下列出部分代碼,其餘封裝細節請見源碼。
// 設定個推模組的配置
jiaGTConfigManager *gtConfig = [jiaGTConfigManager sharedInstance];
gtConfig.jiaGTAppId = @"0uuwznWonIANoK07JeRWgAs";
gtConfig.jiaGTAppKey = @"26LeO4stbrA7TeyMUJdXlx3";
gtConfig.jiaGTAppSecret = @"2282vl0IwZd9KL3ZpDyoUL7";
#pragma mark 消息推送相關處理
/**
* @brief 處理個推消息
*/
- (void)gtNotification:(NSDictionary *)NotificationMessage {
NSLog(@"%@", NotificationMessage[@"payload"]);
NSLog(@"-----接收到個推通知------");
}
/**
* @brief 處理遠程蘋果通知
*/
- (void)receiveRemoteNotification:(NSDictionary *)RemoteNotificationMessage {
NSLog(@"%@", RemoteNotificationMessage[@"message"]);
NSLog(@"-----接收到蘋果通知------");
}
/**
* @brief 獲得註冊成功時的 deviceToken,可在裡面做一些綁定操作
*/
- (void)receiveDeviceToken:(NSString *)deviceToken {
NSLog(@"-----當前 deviceToken:%@------", deviceToken);
}

4. JiaAnalytics:友盟統計封裝
這個模組建立在友盟統計 SDK 與 Aspect(AOP 切面)的結合之上。頁面進出統計改用切面方式實作,把原本散落在各個頁面生命週期中的統計代碼全部移除;App 側只要簡單配置友盟資訊即可,也可以設定要統計頁面的過濾條件。
過濾目前提供三種形式:需要統計的頁面前綴字串陣列、需要統計的頁面名稱陣列、不需統計的頁面名稱陣列,可組合使用以達到精準統計的目的。另外,統計動作放在非同步佇列執行,不會阻塞主執行緒的響應。
__weak typeof(self) ws = self;
dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
[UIViewController aspect_hookSelector:@selector(viewWillAppear:)
withOptions:AspectPositionAfter
usingBlock:^(id<AspectInfo> info, BOOL animated) {
UIViewController *controller = [info instance];
BOOL filterResult = [ws fileterWithControllerName:NSStringFromClass([controller class])];
if (filterResult) {
[ws beginLogPageView:[controller class]];
}
} error:NULL];
[UIViewController aspect_hookSelector:@selector(viewWillDisappear:)
withOptions:AspectPositionAfter
usingBlock:^(id<AspectInfo> info, BOOL animated) {
UIViewController *controller = [info instance];
BOOL filterResult = [ws fileterWithControllerName:NSStringFromClass([controller class])];
if (filterResult) {
[ws endLogPageView:[controller class]];
}
} error:NULL];
});

三、頁面解耦:JiaMediator 中介者
JiaMediator 扮演中介角色,所有模組之間的交互都透過它完成。每個模組都會為它擴充一個分類(例如 JiaMediator+模塊A),分類主要用於「本地直接調用但不想走路由」的場景。若選擇走路由,就要注意路由字串的準確撰寫,它直接決定能否正確響應到目標頁面。實例中也示範了用通知方式回傳參數的做法。

實例代碼:
NSDictionary *curParams = @{
kDesignerModuleActionsDictionaryKeyName: @"wujunyang",
kDesignerModuleActionsDictionaryKeyID: @"1001",
kDesignerModuleActionsDictionaryKeyImage: @"designerImage"
};
switch (indexPath.row) {
case 0: {
// 本地分類調用 + present
UIViewController *viewController =
[[JiaMediator sharedInstance] JiaMediator_Designer_viewControllerForDetail:curParams];
[self presentViewController:viewController animated:YES completion:nil];
break;
}
case 1: {
// 本地分類調用 + push
UIViewController *viewController =
[[JiaMediator sharedInstance] JiaMediator_Designer_viewControllerForDetail:curParams];
[self.navigationController pushViewController:viewController animated:YES];
break;
}
case 2: {
// 走路由
NSString *curRoue = @"jiaScheme://Designer/nativeFetchDetailViewController?name=wujunyang&ID=1001&image=designerImage";
UIViewController *viewController =
[[JiaMediator sharedInstance] performActionWithUrl:[NSURL URLWithString:curRoue]
completion:^(NSDictionary *info) { }];
[self.navigationController pushViewController:viewController animated:YES];
break;
}
case 3: {
// 跨模組調用
NSDictionary *userParaDictionary = @{kUserModuleActionsDictionaryKeyID: @"1"};
UIViewController *viewController =
[[JiaMediator sharedInstance] JiaMediator_User_viewControllerForDetail:userParaDictionary];
[self.navigationController pushViewController:viewController animated:YES];
break;
}
default:
break;
}
四、模組化結合私有 Pods
實例中為了便於閱讀,把所有模組都放在同一個工程裡呈現,但最終還是要落到用 Pods 管理——每個模組獨立成一個私有 Pod,不同 App 只要幾行 Podfile 指令就能引入。相同模組得以跨專案重複使用,重複開發的成本自然下降。

整體而言,這套方案解決的是兩個層面的問題:模組層面靠私有 Pod 消除代碼重複、統一升級路徑;頁面層面靠中介者與路由切斷直接依賴。兩者結合之後,無論是多人協作還是專案交接,成本都能顯著降低。