
本文為投稿文章,作者:踏浪帥
專案比較空的那陣子,我終於把手上累積的一些通用、常用內容整理進了一個統一的工程骨架裡,目標很簡單:新專案開局時不用再從零攤平地重複搭一遍。做過幾個專案之後你會發現,真正花時間的往往不是業務本身,而是那些每次都要重寫的目錄結構、網路層、日誌、第三方接入程式碼。於是把這些沉澱下來,後續開發直接在上面長就好。
整體採用 MVC 分層,本文的重點放在層級怎麼切、各層放什麼,以及已經整合好的第三方能力。原始碼已放在 GitHub:https://github.com/wujunyang/MobileProject,覺得有幫助歡迎點個星;有想補充的模組或發現問題,也歡迎留言或一起完善。
工程基於 Xcode 7 建立。如果你的 Xcode 版本低於 7,把程式碼裡幾處用到新特性的地方刪掉即可正常跑起來。第三方元件用 Pods 管理,Pods 本身不是本文重點,不熟的朋友可以自行搜一下。工程用兩個 Target 區分正式環境與測試環境,網路請求時掛上不同的 base URL;未來若要出多地區版本,同樣靠 Target 來做差異化配置。層級劃分採用目前比較主流的做法,如果你有更好的組織方式,歡迎提出,我會及時合入。這個骨架也會持續迭代,把新的常用能力集成進來。

工程 MobileProject 是主專案,Pods 則是自動管理第三方元件的工程。MobileProject 內部劃分為六個部分:Main、Expand、Resource、Vender、SDKFile、Supporting Files。

這一層承載 MVC 的實際內容,子目錄按大功能模組劃分。目前預設建好了幾個:Logger(日誌)、Preview(預演)、Home(首頁)、Public(公共)、Base(基類)、Login(登錄)。
Preview 用來放練習性質的頁面,凡是整合第三方元件時寫的示例或驗證程式碼,都丟這裡,避免污染業務程式碼。
Public 放那些可能每個模組都會用到的內容。每個大模組底下固定拆成 Model、View、Controller、Other 四塊;其中 View 再往下分 SubView 與 Cell——SubView 收子視圖,Cell 收表格行。這部分可以依專案實際情況增減子級。
Base 放抽取出來、可被繼承的公共內容,比如統一的基類控制器、基類 Model。

放常用 Helper 與分類,下分 Const(常量)、Macros(宏)、Tool(工具類)、Network(網路)、Category(分類)、DataBase(資料庫)六塊。
Macros 拆成兩個檔案:Macros.h 放專案常用宏,例如螢幕尺寸、字型;ThirdMacros.h 放第三方 SDK 需要的 Key,例如友盟、百度地圖。
Tool 放抽出的管理類,如 UmengHelper(友盟)、LocationManager(定位)、Logger(日誌)、Reachability(網路狀態)等。
Network 採用猿題庫封裝的 YTKNetwork(底層是 AFNetworking),並做了小幅改造,讓它支援多 Target 對應不同請求地址。API 位址集中在 NetWorkBaseUrlConfig 類裡配置,並細分為邏輯請求前綴、圖片載入地址、App 升級檢查地址、登錄請求地址;MVC 層發請求時再依 SERVERCENTER_TYPE 決定用哪一種前綴。登錄模組已附一份可運行的示例。
Category 取自 GitHub 上的 iOS-Categories,另外多開一個 Other 放日常新增的分類。常用擴展基本都已涵蓋。
DataBase 用來放專案需要的初始化資料,各類檔案都可以擺這裡。

分 Global(全局)、Image(圖片)、Plist(配置)三塊。Global 放全域內容,包含啟動頁 LaunchScreen.storyboard、頭部引用 PrefixHeader.pch、語言包 Localizable.strings;Image 依功能模組再拆成不同的 xcassets;Plist 因為專案會有多組 Tag、每組 Tag 各有一份 plist,統一收在一處方便維護。
放可能被改動過的第三方元件,以及自己封裝的元件。挑了幾個常用的簡單說一下:GVUserDefaults 是 UserDefaults 的封裝,取存資料幾行搞定;JDStatusBarNotification 做狀態列提示;ActionSheetPicker 從底部彈出時間或選項選擇器;QBImagePickerController 是相簿選擇器,支援多選並可限制最大張數。其餘元件直接拿名字去搜,用法示例都很好找。

放第三方 SDK 的檔案。現在比較知名的 SDK 大多已有 Pods 版本,能省下自己維護更新的力氣;沒有 Pods 的,就把 SDK 直接放這裡。
放比較穩定、長期在用的第三方元件與 SDK。好處不再贅述,專案還沒用 Pods 的話建議盡快上。目前引用的內容如下:
platform :ios, '7.0' pod 'AFNetworking', '~>2.6.0' pod 'SDWebImage', '~>3.7' pod 'JSONModel', '~> 1.0.1' pod 'Masonry','~>0.6.1' pod 'FMDB/common' , '~>2.5' pod 'FMDB/SQLCipher', '~>2.5' pod 'CocoaLumberjack', '~> 2.0.0-rc' pod 'BaiduMapKit' # 百度地圖 SDK pod 'UMengAnalytics-NO-IDFA' # 友盟統計無 IDFA 版 pod 'GTSDK' # 個推 SDK pod 'UMengSocial', '~> 4.3' # 友盟分享與第三方登錄
MobileProject 目前整合了百度地圖定位、友盟統計、CocoaLumberjack 日誌、個推消息推送、友盟分享與第三方登錄。替換成自己的 Key 即可使用,個推還需要準備推送證書。初始化程式碼集中在 AppDelegate,各項功能的示例程式碼都在 Preview 底下,且都經過實測驗證。
登錄部分包含 QQ、微信、新浪微博三種第三方登錄;分享部分包含 QQ 空間、微信朋友圈、新浪微博、QQ 微博、微信好友五種管道。另外還加了一個 CocoaLumberjack 日誌的展示與檢視頁面,方便開發期排查問題。