原文出處:Limboy
網路上相關的資源不多,開源且品質不錯的 iOS 專案也是少之又少。最近正好和同事合作了一個 iOS 專案,來聊聊自己的一些想法。
AppDelegate Models Macro General Helpers Vendors Sections Resources
一個合理的目錄結構,首先應該是清晰的,讓人一眼就能大致了解各目錄的職責,同時容易應對新的變化。
這個目錄放 AppDelegate.h(.m),它是整個應用的入口檔,所以單獨拉出來。
放一些與資料相關的 Model 檔,大致如下:
Models |- BaseModel.h |- BaseModel.m |- CollectionModel.h |- CollectionModel.m ...
放整個應用會用到的巨集定義:
Macro |- AppMacro.h |- NotificationMacro.h |- VendorMacro.h |- UtilsMacro.h ...
AppMacro.h 放 app 相關的巨集定義,例如:
// 表情相關 #define EMOTION_CACHE_PATH @"cachedemotions" #define EMOTION_RECENT_USED @"recentusedemotions" #define EMOTION_CATEGORIES @"categoryemotions" #define EMOTION_TOPICS @"emotiontopics" // 收藏相關 #define COLLECT_CACHE_PATH @"collected" // 配圖相關 #define WATERFALL_ITEM_HEIGHT_MAX 300 #define WATERFALL_ITEM_WIDTH 146
NotificationMacro.h 放通知相關的巨集定義。UtilsMacro.h 放一些方便使用的巨集定義,例如:
#define UIColorFromRGB(r,g,b) [UIColor \
colorWithRed:r/255.0 \
green:g/255.0 \
blue:b/255.0 alpha:1]
#define NSStringFromInt(intValue) [NSString stringWithFormat:@"%d",intValue]
VendorMacro.h 放一些第三方常量,例如:
#define UMENG_KEY @"xxxxx" #define UMENG_CHANNEL_ID @"xxx"
若有新類型的巨集定義,可以再新建一個相關的 Macro.h。
放會被重複使用的 Views/Classes 和 Categories:
General |- Views | |- TPKScollView | |- TPKPullToRefresh | ... |- Classes | |- TPKBaseViewController | |- TPKHorizontalView | ... |- Categories | |- UIViewController+Sizzle | |- UIImageView+Downloader | ...
這裡的 TPK 是專案名稱的首字母縮寫。
放一些助手類,檔名與功能掛鉤:
Helpers |- TPKShareHelper |- TPDBHelper |- TPKEmotionHelper ...
助手類的主要作用是幫 Controller 瘦身,同時提供一定程度的複用。
放第三方的類庫/SDK,如 UMeng、WeiboSDK、WeixinSDK 等。
對應 app 的具體單元,如導航、瀑布流等:
Sections |- Menu |- Setting |- Collection ...
放 app 會用到的一些資源,主要是圖片。
與業務無關的類庫可以透過 Cocoapods 方便地管理,如 SDWebImage、Reachability 等。還有一些多個應用都會用到的基礎模組,比如 HBAPI、HBSNS、HBFoundation(HB 為公司名首字母)等,可以建一個私有的 git repo,然後加入 Podfile,這樣若 HBAPI 有更新,只要 pod update 一下就行了。
順帶一提 HBFoundation,這個 git 倉庫可以放一些自己寫的、幾乎所有應用都會用到的小模組。例如很多 app 都會每隔一段時間跳出一個求好評的 alertView,就可以寫一個 HBRating 類,需要該功能的 app 只要加上一句 [HBRating checkIfShouldPopupWithAppID:(NSInteger)appID] 就行了。又比如 app 都有接收 push notification 的需求,可以寫一個 HBAPNS 類等等。
拿到設計圖後,就可以針對設計圖抽離出可複用的 Classes/Views/Helpers,思考某個效果的具體實現,並用合適的設計模式來避免大量的 if/else 嵌套等等。不要一開始就埋頭鑽進 Sections 去實作頁面效果和功能,乍看之下可能快一點,但只要專案有點複雜度,這種做法到後來只會吃盡苦頭,程式碼會越來越難維護。所以前期一定要做好充足的準備工作。
經驗有限,如果你有更好的想法,歡迎交流。