在大型 iOS 專案中,常會把共用功能拆成多個子專案或靜態庫,再整合到主專案。這樣做的好處是職責清楚、便於維護,也能降低不同模組之間的耦合。
首先建立需要的靜態庫,再將這些子專案加入主專案。加入後要確認 Target Dependencies 與連結設定是否正確,避免編譯時找不到符號。

在主專案的 Build Phases 中加入對應的靜態庫產物,確保連結階段可以取得實作內容。

如果直接引用子專案標頭檔時出現找不到檔案的錯誤,通常表示 Header Search Paths 沒有設定完整。

可以在 Build Settings 中加入 $(BUILT_PRODUCTS_DIR) 與 $(SRCROOT) 等路徑變數。前者代表建置成功後的最終產品路徑,後者代表專案檔所在位置。

另外,non-recursive 表示不遞迴搜尋子目錄,recursive 則會遞迴搜尋。依團隊結構選擇即可。
子專案本身也可能需要調整公開標頭檔或產品名稱,確保主專案可以正確引用。

多子專案架構能提升維護性,但一開始的路徑與依賴設定要特別小心。只要釐清 Header Search Paths、Target Dependencies 與產品路徑,後續整合就會順利很多。