近期在看一些 App 架構相關的文章,也讀了 Facebook 在 2013 與 2014 兩個時期分享的架構,於是乾脆去翻一翻 Facebook App 的標頭檔,看看還能挖出什麼。結果確實有,而且不少。由於選擇 ipa 時手滑,我下載的是 7.0 版(當時最新為 18.1),後來補下了 18.1 對照,發現變動其實不大。以下是我從二十多萬行標頭檔中擷取的一些觀察。
這一點 Facebook 在演講中也提過:自訂 UI 組件在初始化時接收一些數值來決定呈現效果,概念等同 HTML 與 CSS 的分工——DOM 結構決定「這是什麼」,CSS 決定「長什麼樣」。Facebook 用 Struct 承擔後者:
struct FBActionSheetButtonMetrics {
CDUnknownFunctionPointerType *_vptr$FBMetrics;
_Bool _initialized;
float leftMargin;
float textLeftMargin;
float bottomSeperatorSideMargin;
float bottomSeperatorHeight;
int detailMaxNumLines;
UIColor *titleColor;
// ...
};
好處很直接:程式碼量下降,語意直觀,複用起來也方便。
過度使用繼承,特別是繼承層次過深,往往讓維護成本急遽上升。每次有新需求,團隊都要糾結「該在基類還是子類加方法」、「要不要再開一個子類」。組合則沒有這個困擾,不合適就換個組件。
不過 Objective-C 對組合沒有語言層面的特別支援,寫起來略繁瑣:
@interface People {}
@property id veachle;
- (void)move;
@end
@implementation People
- (id)initWithVeachle:(id)veachle {
if (self = [super init]) {
self.veachle = veachle;
}
return self;
}
- (void)move {
[self.veachle move];
}
@end
若有很多像 move 這樣需要轉交外部物件處理的方法,確實顯得冗餘。但即便如此,相較繼承,它仍然更好維護。
組合通常搭配「依賴注入」。上面的 Veachle 並不需要指明是 Bike 還是 Car,只要有 move 方法即可,替換起來毫不費力,People 完全不用改動。在 Objective-C 中,這靠 protocol 實現。
於是 Facebook 定義了大量介面:Delegate、DataSource、Protocol 三類並存。ViewController 有 Protocol 也有 Delegate(如 FBMediaGalleryViewControllerDelegate),View/Cell 同樣有 Delegate(如 FBMediaGalleryViewDelegate),此外還有各種零散的 Protocol,例如 FBDiscoveryCardProtocol、FBEventProtocol。
定義介面的過程,本身就是梳理架構的過程。對架構理解不夠深,很難把介面抽象得恰到好處——很多人放棄組合,部分原因正在於架構本身不合理。組件粒度也是難題:過細導致組件數量爆炸,組合成本轉嫁到開發者身上;過粗則組件臃腫,難以複用。
介面定義完成後,使用起來大致如下:
@interface FBResponseHandler : NSObject @interface FBPhotoViewController : UIViewController
一眼就能判斷這個類大致具備哪些能力。某個組件要調整時,只改一處即可全局生效。
適度繼承則能在易維護與便利之間取得平衡,例如 FBTableViewController、FBDialog 這類基礎組件,自訂組件可以在它們之上開發。繼承層次一般不超過兩層,例如 UITableViewController ← FBTableViewController ← FBFriendsNearbyTableViewController。
組合往往與依賴注入成對出現。Facebook 主要透過 FBProvider、FBProviderMapData、FBProviderMap 來實現。
Provider 負責產生物件:呼叫 CameraControllerProvider 的 get 方法後,會得到一個 MNCameraController 實例。它還有兩個子類——SingletonProvider 用來產生單例,BlockProvider 則用在需要初始化參數的場景。
ProviderMap 與 ProviderMapData 有些重複,兩者關係我沒完全理清,感覺 ProviderMap 更像一個 Manager:註冊了一批 Provider,之後可以透過 Provider ID 取回對應實例。
不只是 Cocoa 開發,模塊化在任何程式設計領域都是理想狀態:高內聚、低耦合。就像 shell 命令那樣,接受參數或標準輸入,輸出格式化結果,再透過管道交給下一個工具。
現實場景要複雜得多,模塊化的落地也困難得多。Facebook 定義了一個 FBAppModule 協議:
@protocol FBAppModule + (id)instanceForSession:(FBSession *)arg1 providerMap:(FBProviderMap *)arg2; @property (readonly, nonatomic) NSArray *supportedURLSchemes; @property (readonly, nonatomic) NSArray *supportedKeys; @property (retain, nonatomic) id activeMenuItem; @property (readonly, nonatomic) NSString *defaultIcon; @property (readonly, nonatomic) NSString *ID; - (UIViewController *)viewControllerForMenuItem:(id)arg1; @end
初始化時傳入 FBSession 與 ProviderMap,接著設定支援的 URL schemes、keys(具體用途不明)、對應的 menuItem、icon(用於選單顯示)與 ID。
有了 Module,自然也有 ModuleManager。它的職責是註冊 Module:當一個 URL 進來時,遍歷各模塊看看誰能處理,命中就呼叫該 Module 的 openURL:;當然也可以直接用 ModuleID 取。
FBAppModule 是 Protocol,FBNativeAppModule 是它的實作,因此具體模塊都繼承自後者。
一般情況下系統的 UINavigationController 已經夠用。若需要更高的自由度與可定製性,可以自建導航管理器。Facebook 用 FBUINavigationController(Protocol)來做這件事,屬性與方法和系統版本相近,並有多個實作:FBTariffedNavigationController、FBSwipeNavigationController、FBCustomNavigationController、FBNavigationController。前面說繼承一般不超過兩層,這裡是例外,有三層。
MVVM 是處理 Massive View Controller 的有效手段:抽出一個 ViewModel 作為 View 的資料源,並承擔部分互動邏輯,VC 只負責把 ViewModel 與 View 接起來。實作上通常搭配某種綁定機制,KVO 或 ReactiveCocoa 都可以,這樣 ViewModel 的資料變動就能自動映射到 View。
Facebook 也採用了這個思路,並有一個 FBViewModel 基類:
@interface FBViewModel : NSObject // 省略部分相關性較低的屬性與方法 @property __weak FBViewModelManager *viewModelManager; @property (nonatomic) unsigned int viewModelSource; @property (retain, nonatomic) FBViewModelConfiguration *viewModelConfiguration; @property (readonly, nonatomic) unsigned int viewModelVersion; @property (readonly, nonatomic) NSString *viewModelUUID; @property (retain) FBMemModelObject *memModel; - (void)setNilValueForKey:(id)arg1; - (id)initWithViewModelUUID:(id)arg1 viewModelVersion:(unsigned int)arg2; - (void)setViewModelVersion:(unsigned int)arg1; - (id)humanDescription; - (void)loadPermanentDataModelObjectIDFromDataModelObjectID:(id)arg1 block:(CDUnknownBlockType)arg2; - (void)didUpdateWithChangedProperties:(id)arg1; @property __weak FBViewModelController *modelController; @property (nonatomic) int loadState; @end
因為 ViewModel 是不可變的(Immutable),無法就地修改,所以需要一個集中管理的位置,在有更新時發出通知。FBViewModelController 大概就是幹這件事的,其中可見 - (void)_notifyViewModel:(id)arg1 didUpdateWithChanges:(id)arg2;。不過從職責看,FBViewModelManager 似乎更合適,兩者的分工界線沒那麼清楚。
FBViewModelController 還有一個 Delegate,主要三個方法 didUpdate[Delegate][Insert]ViewModel:,供事後處理使用。
定義一個 ViewController 時,往往需要接收很多參數。用 initWith: 這種形式不太合適,除非你能忍受一個十行的方法宣告。常見做法是把參數宣告為 property,初始化後逐一賦值,再在 viewDidLoad 中使用。這裡有三個問題:不清楚哪些必須在 viewDidLoad 之前設定,容易漏;這些屬性在外部可被任意改動;程式碼也不夠優雅。
Builder 模式正是為了解決這些問題,它與工廠模式有幾分相似。Facebook 用到了它,例如 FBMUserFetchStatus 需要多個參數初始化,於是有了 FBMUserFetchStatusBuilder:
@interface FBMUserFetchStatusBuilder : NSObject + (id)aMUserFetchStatusFromExistingMUserFetchStatus:(id)arg1; + (id)aMUserFetchStatus; - (id)withIdentifiers:(BOOL)arg1; - (id)withImageUrls:(BOOL)arg1; - (id)withHasVerifiedPhone:(BOOL)arg1; - (id)withCanInstallMessenger:(BOOL)arg1; - (id)withHasMessenger:(BOOL)arg1; - (id)withIsFriend:(BOOL)arg1; - (id)withNickname:(BOOL)arg1; - (id)withPhoneticName:(BOOL)arg1; - (id)withName:(BOOL)arg1; - (id)withUserId:(BOOL)arg1; - (id)build; @end
最後的 build 方法會產出 FBMUserFetchStatus 實例。有了 Builder,哪些參數能在初始化時設定便一目了然。
這部分是重頭戲,資訊量也最大,以下推斷可能有誤。
先看實體類。首先是 FBEntityRequest:
@protocol FBEntityRequestParse @optional + (BOOL)canParse:(id)arg1 error:(id *)arg2; @property (retain, nonatomic) NSError *syncError; @property (nonatomic, getter=isSyncing) BOOL syncing; - (unsigned int)parse:(id)arg1 request:(id)arg2 error:(id *)arg3; - (id)request; @end
也就是說,實體都可以被解析與同步,並自帶一個 Request。
再看 FBEntity:
@protocol FBEntity + (NSURL *)entityURLForFBID:(NSString *)arg1; @property (readonly, nonatomic) NSURL *entityURL; @property (readonly, nonatomic, getter=isDataStale) BOOL dataStale; @property (retain, nonatomic) NSDate *lastSyncTime; @property (retain, nonatomic) NSString *fbid; @optional + (unsigned int)collection:(FBEntityCollection *)arg1 parse:(id)arg2 request:(id)arg3 error:(id *)arg4; + (id)collectionRequest:(FBEntityCollection *)arg1; @property (readonly, nonatomic) FBEntityDownloader *entityDownloader; - (NSSet *)parentEdges; - (NSSet *)parentCollections; - (void)entityInitializeWithFBID:(NSString *)arg1; @end
每個 Entity 都有 entityURL,推測是供同步使用;dataStale 應該用來標記資料是否為髒數據,若是則需要同步;此外還能請求 Collection。
FBEntityCollection 與 FBEntity 相似,只是多了 syncAll、memberClass、allObjects 這些成員。
接著是網路請求部分。FBRequest 有點撲朔迷離——它沒有 URL,一個沒有 URL 的 Request 能做什麼?往下看到 FBRequester,這個比較像真正的請求類,具備 URL、responseHandler、連線狀態與 delegate。但它只管單個請求,多請求的管理交給了 FBNetworker,後者有 +sharedNetworker、requestQueue、cancelRequests:、addRequest:。不過下面還有一個 FBNetworkerRequest,看起來像是 FBNetworker 的 Delegate,無法確定。
為了避免 URI 散落各地,Facebook 還為 NSURL 寫了一個 Category 統一管理:
@interface NSURL (FBFoundation) + (id)friendsNearbyURL; + (id)codeGeneratorURL; + (id)tagApprovalURLWithTagId:(id)arg1; + (id)tagApprovalURL; + (id)pokesURL; + (id)personExpandedAboutURLWithFBID:(id)arg1; // ... @end
另外還有一個 URL 生成類 FBURLRequestGenerator,它保存了 appSecret 與 appVersion,生成的 URL 會自動帶上這些參數。
這部分內容還有很多,實在看不下去了。
眾所周知,ViewController 自帶一個 view,可以直接在上面 addSubview。正因為太方便,大量建立 View 的程式碼就一窩蜂擠進了 VC,觀感實在不佳。
更好的做法是換掉 VC 的 view 為自訂 View,並把這個自訂 View 獨立出去。例如在 loadView 中覆寫:
@implementation MyProfileViewController
- (void)loadView {
self.view = [MyProfileView new];
}
同時可以重定義 view 的型別,如 @property (nonatomic) MyProfileView *view,讓編譯器明白型別已改變。由於不少 VC 中都出現了 loadView 方法,推測 Facebook 採用了這項技巧。
在 Web 開發中,Session 用來保存使用者相關資訊,FBSession 也不例外,只是它保存的內容實在不少:
@interface FBSession : NSObject + (void)setCurrentSession:(id)arg1; + (id)_globalSessionForDebugging; + (id)DO_NOT_USE_OR_YOU_WILL_BE_FIREDcurrentSession; @property (readonly) FBAPISessionStore *apiSessionStore; @property (readonly) FBSessionDiskStore *sessionDiskStore; @property (readonly) FBStore *store; @property (readonly) NSString *appSecret; @property (readonly, nonatomic, getter=isValid) BOOL valid; @property (readonly) BOOL hasUser; @property (readonly) NSString *userFBID; @property (retain) FBViewerContext *viewerContext; @property (retain) FBUserPreferences *userPreferences; @property (retain) FBPreferences *sessionPreferences; - (void)updateAccessToken:(id)arg1; - (id)updateActingViewer:(id)arg1; - (void)clearPreferences; - (void)invalidate; - (id)DO_NOT_USE_OR_YOU_WILL_BE_FIREDvalueForKeyRequiresUser:(id)arg1 withInitializer:(CDUnknownBlockType)arg2; - (id)valueForKey:(id)arg1 withInitializer:(CDUnknownBlockType)arg2; - (id)valueForKey:(id)arg1; - (id)initWithAppSecret:(id)arg1 store:(id)arg2 apiSessionStore:(id)arg3; @property (readonly, nonatomic) FBReactionController *reactionController; @property (readonly, nonatomic) FBLocationPingback *locationPingback; @property (readonly, nonatomic) FBAppSectionManager *appSectionManager; @property (readonly, nonatomic) FBBookmarkManager *bookmarkManager; // and many more... @end
Session 可以保存到本地,有狀態變量標識是否有效(valid)、是否已登入(hasUser),還保存著使用者各項設定(同樣會落地),可以更新 AccessToken,並掛著一大堆 Controller 與 Manager。
另外有兩個方法名字很有個性——用了一定會被 Fire。
顧名思義,Service 提供某種服務,通常與介面無關。從目錄層級看,Service 並不在 Module 裡面,兩者是獨立的,例如 FBTimelineModule 並不包含 FBTimelineService。
Service 之間可以存在依賴,透過 startAppServiceWithDependencies: 表達,至於 Service 自身如何聲明依賴了哪些其他 Service,從標頭檔看不出來。
App 的樣式是最容易被忽略的一塊。開發者往往對著設計稿直接開寫,結果是樣式四處散落、不一致,日後調整更是痛苦。
Facebook 用 Category 統一管理樣式,舉個簡單例子:
@interface UIButton (FBMediaKit) + (id)fb_buttonTypeSystemWithTitle:(id)arg1; + (id)fb_buttonWithNormalImage:(id)arg1 highlightedImage:(id)arg2 selectedImage:(id)arg3; + (id)fb_buttonWithTemplateImage:(id)arg1; + (id)fb_buttonWithStyle:(int)arg1 title:(id)arg2; @end @interface UIButton (FBUIKit) + (id)fb_moreOptionsNavBarButton; + (id)fb_backArrowButtonWithText; + (id)fb_backArrowButtonWithRightPadding:(float)arg1; + (id)fb_backArrowButton; @end @interface UIButton (MNLoginFormAppearanceHelpers) + (id)phoneFormHeaderButton; + (id)singleSignOnButton; + (id)skipButton; + (id)formFieldButtonInvertedColors; @end
這樣就不必操心 fontColor、margin、backgroundColor 等細節,直接取用即可。
從目錄結構看,Facebook 分為 FBUIKit、FBFoundation、FBAppKit 與 Module 四層。其中 FBUIKit 與 FBFoundation 與業務無關,可以搬到其他 App 使用;FBAppKit 與 Module 則與業務綁定。
Module 自帶資源,可以看作一個 mini app。
此外使用了 EGODatabase、SDWebImage、SSZipArchive、CocoaLumberjack 這幾個開源庫(可能還有更多)。
時間與能力有限,只能挖到這裡,希望對你有所幫助。