一、概述
Objective-C 公用庫的使用場景相當常見:iOS SDK 本身就是公用庫的集合;一些開放平台為了方便開發者接入,會提供相應平台的 SDK;還有一種場景是大型公司往往擁有多個甚至幾十個 app,彼此之間難免存在重複邏輯,出於「提升效率」「保障安全」或業務指標等考量,便會沉澱出一些公用庫供內部各個 app 共用。
公用庫本質上就是一些可重用邏輯的集合,是「分而治之」的一種途徑,其呈現形式可以是源碼,也可以是二進制。
公用庫同樣需要理清自身的依賴關係,比如依賴系統 SDK 的哪些庫、哪些接口(這決定了公用庫適用的系統版本),以及依賴了哪些第三方庫。既然要把東西拿出來給別人用,就要想方設法減少不必要的依賴。
作為公用庫的開發者,在提供給他人使用時,需要站在使用者的角度思考問題——接口設計是否清晰、接入是否簡便,都體現著作者的職業道德與專業素養。
二、設計與實現
第一步當然是明確公用庫的目標:要做什麼、不做什麼,一五一十列出來,並在後續實現中盡可能地堅持這些原則。
項目構建有幾種選擇:
在此基礎上,你還可以通過 CocoaPods 來管理公用庫自身的依賴。
實現時,公用庫自身的源碼應全部放進某個目錄或其子目錄中(指那些可以直接拷貝出去使用的源碼,不包括編譯所依賴的文件,比如 prefix.pch)。頭文件只暴露那些必須公開的;能在實現文件中引入的,就在實現文件中引入;如果在需要暴露的頭文件裡引入了另一個頭文件,那麼後者也必須一并暴露。
另一個常見問題是接口方法聲明不符合 Objective-C 的語言規範,讓人一看就覺得「山寨」。建議公用庫最好由熟悉當前語言的老手帶著做,掌握語言規範和常用範式,比如何時該用 delegate、何時該用 block。
此外,實現時要盡可能少引入第三方依賴。如果確實需要引入,千萬別把公用庫依賴的第三方內容當成自己的一部分;實在要這麼做,起碼得修改這些依賴相關類的類名、靜態變量名,若是 category,還要修改其方法名,以免與使用者的代碼衝突。
最後,要坚持良好的註釋與文檔。某個方法若有需要特別注意的地方,應註釋說明;同時提供一份 README,描述公用庫的目的以及各接口的使用範例。
三、分發與集成
其實在公用庫構建的初期,你就該想清楚分發方式,一種好的分發方式能大幅降低集成的成本。
公用庫給別人用,無非兩種形式:源碼或二進制(額外提供頭文件、資源文件)。源碼方便使用者調試,二進制則適用於那些不便公開源碼的公用庫。
先說源碼形式,源碼一般放在某個版本控制庫中:
再說二進制形式,要談的東西就更多了,一般也有兩種方式:
vendored_frameworks 或 vendored_libraries 指定需要分發的庫。無論以何種方式分發,你都必須明確聲明公用庫適用的系統版本、依賴哪些系統 SDK 框架或靜態庫、依賴哪些第三方庫及對應版本——這既是對自己負責,也是對別人負責。
使用公用庫時,Xcode 通過 header search path 查找靜態庫的頭文件,通過 framework search path 查找 framework。若用 CocoaPods 管理,這些環境變量的設置會自動在你的 xcconfig 文件中完成。
四、和庫相關的幾個命令
下面幾個命令都與二進制庫相關。這些二進制文件也稱為對象文件,在 Mac 或 iOS 平台中採用的是 Mach-O(Mach Object)格式,因此這些命令本質上都是讀取或操作 Mach Object 的,你可以通過 man 查看詳細手冊。