
背景:隨著公司一系列 APP 項目的推進,公用框架的建設與維護變得越來越迫切。因為日常工作中頻繁接觸 CocoaPods,也清楚它能勝任這件事,於是毫不猶豫地選擇了基於 CocoaPods 的封裝方案。
Why
給工作中沉澱下來的組件一個安放之處。
為新項目的啟動提供高效支撐。
框架代碼獨立維護,功能點升級更新更快捷。
某種程度上也在督促自己改進代碼的組織與質量。
知識儲備
搭建過程大致參考了這篇教程:使用 CocoaPods 創建私有 podspec。
教程寫得非常細致,是很不錯的分享。其中有幾處容易讓人困惑:
Podfile 中兩種引入方式的差別
1. :path => 的引入方式
這種方式引入的依賴會被放進 DevelopmentPods,並且完整保留私有庫的文件組織結構(包括文件夾嵌套關係)。它非常適合私有庫的開發階段,因為引入的就是真實的源文件,在 demo 工程裡調試和驗證功能都極為方便。
對有整齊癖的人來說,可能會有一點不完美:當 podspec 中包含 subspecs 時,這種方式會多出一些冗餘的文件層次嵌套……感興趣的同學可以試一試。
2. 常規的引入方式
常規方式走的是另一個極端:它會剝離庫原有的文件組織結構,只簡單劃分源文件與資源文件;如果包含 subspecs,也只保留子模塊這一級層次,模塊內部的結構不復存在。目前我還沒找到保留原有組織結構的合適辦法。

比如上圖的結構,發布之後將變成:

子模塊劃分思路
先說結論,大致是按下面這個思路拆的:
1. 網絡(剔除具體 API 調用部分)
添加示例
包含常用插件(網絡狀態標識等)
緩存
2. 模型映射
統一 API 調用規則
封裝公共響應處理邏輯
錯誤類型的統一處理
3. Hybrid
資源預加載(js、css 等)
native 能力開放
4. UI
HUD
Tab
側邊欄
Nav 常用操作
下拉上拉
Auto Layout 封裝
datasource 封裝
常用動畫轉場
5. 安全
加密解密
6. 統計
通過 swizzling 添加打點入口
日志記錄模塊封裝
bug 收集與分析
7. 動態性
熱部署方案
這套拆解主要依據當前項目群關注的重點,模塊之間難免存在依賴關係,而這部分 CocoaPods 已經貼心地幫我們搞定了,例如:
s.subspec 'APIModule' do |ss|
ss.source_files = 'Classes/APIModule/**/*.{swift,h,m}'
ss.dependency 'Moya', '~> 6.5.0'
ss.dependency 'HanekeSwift', '~> 0.10.1'
ss.dependency 'NetworkActivityIndicator', '~> 0.1.6'
ss.dependency 'MonkeyKit/UtilModule'
ss.dependency 'MonkeyKit/ModelMapperModule'
ss.dependency 'MonkeyKit/SecurityModule'
end框架還會根據後續實際使用情況持續優化調整,逐步完善。
下一步
這一輪主要是對基礎功能模塊做拆分封裝。實際上,對於 APP 群中通用的業務模塊也可以做同樣的事情,比如登錄驗證模塊或相關邏輯的封裝。通過對公用業務場景的梳理,慢慢提煉出可以產品化的部分並沉澱進公用庫,能顯著提升整個 APP 群的開發效率與產品質量。