付費限定

🥇SwiftUI 讀完就入坑 #9 SwiftUI + TCA 專案的模組化最佳實踐

更新 發佈閱讀 16 分鐘

前言

切模組可以說是一門藝術,也是考驗程式碼架構與分類功力的絕佳方式。

今天要分享的模組化拆分法,是根據十來個專案,包括公司的 3 個中大型 SwiftUI + TCA 專案,累積三年半實務經驗,研究出的 SwiftUI + TCA 模組化最佳實踐的核心精神。

對於有在使用 TCA 或是想入坑 TCA 的朋友,應該會增加不少功力。

這篇文章相當進階,最好是對 TCA 有一定使用經驗再來讀。

我學習切模組的基礎是來自於 Point-Free 的 Modularization: Part 1(這集免費)、Modularization: Part 2,以及 Point-Free 的 TCA 示範專案──開源遊戲 App isowords

後來實際操作下去以後,覺得踩到了一些坑,所以逐漸發展成自己的解決方案。

建議配菜

我在 iOS 開發配飯吃 #0 有教過把整個 iOS App 的程式碼,都放進 Local Swift Package 的作法。

一個好處是可以繞開 Xcode 專案檔容易衝突的問題,不過在 Xcode 16 用 Folder 就可以避開。

更重要的好處是,用 Package manifest 更容易定義用到的外部依賴,以及模組的切分。

這些模組拆分方法都是基於上面提到的 Local Swift Package。雖然你也可以在 Xcode 開 framework target 來切,但是我還是覺得放在 Package 比較管理。

所以如果你還不熟悉用 Local Swift Package 來搭配 Xcode 專案,可以看一下 iOS 開發配飯吃 #0

目標

我切模組的目標是:

  1. 每個模組的職責非常明確(這是基本),讓分工合作的團隊成員都知道要怎麼分類與管理程式碼。獨立開發者的話,就把未來的自己當成團隊成員
  2. TCA reducers 作為 App 的核心商業邏輯,能夠快速地執行 TCA reducers 的測試是至關重要的。要是編譯速度太慢,會讓人不想好好寫測試,TDD 也不可能實現
  3. 確實掌控 reducers 的測試覆蓋率。測試覆蓋率可以用模組為單位來觀察,所以切到剛剛好有需要測試的範圍為一個模組,這個覆蓋率就很有參考價值
  4. 可以順利跑起 SwiftUI Previews,達到接近即時更新的效果。之前的文章談過很多次,我很強調能夠看到 SwiftUI Previews 才能做好狀態設計。正確地切模組可以讓 Previews 每次更新只編譯需要編譯的部分,這樣就可以更快看到更新
  5. 只有在跑整個 App 的時候才需要編譯外部依賴,進一步增進開發效率
  6. 當有錯誤的時候,可以依照依賴的順序來編譯不同模組,逐步排除問題。這一點在現今的 Xcode 專案與 Swift 編譯器的表現下,會比想像中來得重要

模組化架構圖

來看一張簡化版本的圖。

創作者正在準備中
請加入 13+ 了解最新動態!
留言
avatar-img
13+
3.3K會員
161內容數
13 以 10+ 年 iOS 開發經驗為基礎撰寫,助你在 AI 時代成為更有自信的技術工作者。 ❤️ 支持 13 創作! 🤖 AI 工具實戰經驗與深度思考 🧠 軟體開發思維、職涯發展建議 💡 實用技巧與踩坑經驗分享 😔 開發者身心健康與職業傷害
13+的其他內容
2025/04/24
Swift Tagged 是我幾乎寫每個 iOS App 都會預設使用的 Swift Package。這篇文章會介紹它解決的問題,以及解法背後的思路哲學。
2025/04/24
Swift Tagged 是我幾乎寫每個 iOS App 都會預設使用的 Swift Package。這篇文章會介紹它解決的問題,以及解法背後的思路哲學。
2025/04/18
最近跟家人聊到 AI 的發展,產生一段有趣的對話,於是寫了這篇短文。
2025/04/18
最近跟家人聊到 AI 的發展,產生一段有趣的對話,於是寫了這篇短文。
2025/04/13
聊聊幾件重要的進度與想法,包括近期寫作狀況、全新官網、內容整合的規劃,以及幾個還在構思中的方向。歡迎你試用新官網,並給我一些回饋。
2025/04/13
聊聊幾件重要的進度與想法,包括近期寫作狀況、全新官網、內容整合的規劃,以及幾個還在構思中的方向。歡迎你試用新官網,並給我一些回饋。
看更多
你可能也想看
Thumbnail
債券投資,不只是高資產族群的遊戲 在傳統的投資觀念中,海外債券(Overseas Bonds)常被貼上「高資產族群專屬」的標籤。過去動輒 1 萬甚至 10 萬美元的最低申購門檻,讓許多想尋求穩定配息的小資族望而卻步。 然而,在股市波動劇烈的環境下,尋求穩定的美元現金流與被動收入成為許多投資人
Thumbnail
債券投資,不只是高資產族群的遊戲 在傳統的投資觀念中,海外債券(Overseas Bonds)常被貼上「高資產族群專屬」的標籤。過去動輒 1 萬甚至 10 萬美元的最低申購門檻,讓許多想尋求穩定配息的小資族望而卻步。 然而,在股市波動劇烈的環境下,尋求穩定的美元現金流與被動收入成為許多投資人
Thumbnail
透過川普的近期債券交易揭露,探討債券作為資產配置中「穩定磐石」的重要性。文章分析降息對債券的潛在影響,以及股神巴菲特的操作策略。並介紹玉山證券「小額債」平臺,如何讓小資族也能低門檻參與海外債券市場,實現「低門檻、低波動、固定收益」的務實投資方式。
Thumbnail
透過川普的近期債券交易揭露,探討債券作為資產配置中「穩定磐石」的重要性。文章分析降息對債券的潛在影響,以及股神巴菲特的操作策略。並介紹玉山證券「小額債」平臺,如何讓小資族也能低門檻參與海外債券市場,實現「低門檻、低波動、固定收益」的務實投資方式。
Thumbnail
解析「債券」如何成為資產配置中的穩定錨,提供低風險高回報的投資選項。 藉由玉山證券的低門檻債券服務,投資者可輕鬆入手,平衡風險並穩定財務。
Thumbnail
解析「債券」如何成為資產配置中的穩定錨,提供低風險高回報的投資選項。 藉由玉山證券的低門檻債券服務,投資者可輕鬆入手,平衡風險並穩定財務。
Thumbnail
相較於波動較大的股票,債券能提供固定現金流,而玉山證券推出的小額債,更以1000 美元的低門檻,讓學生與新手也能參與全球優質企業債投資。玉山E-Trader平台即時報價、條件式篩選與清楚的交易流程等特色,大幅降低投資難度,對於希望分散風險、建立穩定現金流的人來說,玉山小額債是一個值得嘗試的理財起點。
Thumbnail
相較於波動較大的股票,債券能提供固定現金流,而玉山證券推出的小額債,更以1000 美元的低門檻,讓學生與新手也能參與全球優質企業債投資。玉山E-Trader平台即時報價、條件式篩選與清楚的交易流程等特色,大幅降低投資難度,對於希望分散風險、建立穩定現金流的人來說,玉山小額債是一個值得嘗試的理財起點。
Thumbnail
深入探討一些程式碼撰寫的習慣
Thumbnail
深入探討一些程式碼撰寫的習慣
Thumbnail
這本書在書單中很久了,前陣子有空繞去天龍書局發現有中譯版就買回家來翻翻 (沒錯,買中譯版 XD),一看很合胃口,很快就翻完了,心有戚戚焉的句子很多,特別是在最後一章關於框架設計的部分。
Thumbnail
這本書在書單中很久了,前陣子有空繞去天龍書局發現有中譯版就買回家來翻翻 (沒錯,買中譯版 XD),一看很合胃口,很快就翻完了,心有戚戚焉的句子很多,特別是在最後一章關於框架設計的部分。
Thumbnail
這篇文章將會講述類圖的基本介紹,並且詳細敘述從零開始製作完整的類圖流程。
Thumbnail
這篇文章將會講述類圖的基本介紹,並且詳細敘述從零開始製作完整的類圖流程。
Thumbnail
** 3C機構設計爸版權所有 ©️ ** 移模,是一個不得已的動作,移模的原因不外乎原廠商生產的品質/交期/價格/配合度問題、或是廠商內部發生了問題、或是因為系統廠的生產地點改變,...等等的問題,使得系統廠或OEM/ODM客戶不得不做出移模到第二廠商的決定。 移模的啟動來源有兩種,一種是OTS(O
Thumbnail
** 3C機構設計爸版權所有 ©️ ** 移模,是一個不得已的動作,移模的原因不外乎原廠商生產的品質/交期/價格/配合度問題、或是廠商內部發生了問題、或是因為系統廠的生產地點改變,...等等的問題,使得系統廠或OEM/ODM客戶不得不做出移模到第二廠商的決定。 移模的啟動來源有兩種,一種是OTS(O
Thumbnail
小心設計模式別亂用 📷 介紹 設計模式就是過去的人,根據常見的軟體設計的問題,提出的解決方案。 設計模式總共有23種,根據情境分成三大類型,建立型、結構型、行為型。 建立型模式(Creational Patterns) 簡單工廠(Simple Factory) 工廠方法(Factory) 抽象工廠
Thumbnail
小心設計模式別亂用 📷 介紹 設計模式就是過去的人,根據常見的軟體設計的問題,提出的解決方案。 設計模式總共有23種,根據情境分成三大類型,建立型、結構型、行為型。 建立型模式(Creational Patterns) 簡單工廠(Simple Factory) 工廠方法(Factory) 抽象工廠
Thumbnail
介紹 在過去的歷史裡開發程式都是以呼叫Function的方式來做程式開發,後來才有了物件導向設計的概念,而物件導向程式設計的概念就是,使用【物件】的方式來設計程式。 Q: 什麼是【物件】? A:【物件】會包含以下這四個特性: 抽象(Abstraction) 封裝(Encapsulation)
Thumbnail
介紹 在過去的歷史裡開發程式都是以呼叫Function的方式來做程式開發,後來才有了物件導向設計的概念,而物件導向程式設計的概念就是,使用【物件】的方式來設計程式。 Q: 什麼是【物件】? A:【物件】會包含以下這四個特性: 抽象(Abstraction) 封裝(Encapsulation)
追蹤感興趣的內容從 Google News 追蹤更多 vocus 的最新精選內容追蹤 Google News