付費限定

🥇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 編譯器的表現下,會比想像中來得重要

模組化架構圖

來看一張簡化版本的圖。

以行動支持創作者!付費即可解鎖
本篇內容共 6199 字、0 則留言,僅發佈於📦 SwiftUI & TCA你目前無法檢視以下內容,可能因為尚未登入,或沒有該房間的查看權限。
留言
avatar-img
留言分享你的想法!
avatar-img
13+
1.2K會員
66內容數
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
2025 vocus 推出最受矚目的活動之一——《開箱你的美好生活》,我們跟著創作者一起「開箱」各種故事、景點、餐廳、超值好物⋯⋯甚至那些讓人會心一笑的生活小廢物;這次活動不僅送出了許多獎勵,也反映了「內容有價」——創作不只是分享、紀錄,也能用各種不同形式變現、帶來實際收入。
Thumbnail
2025 vocus 推出最受矚目的活動之一——《開箱你的美好生活》,我們跟著創作者一起「開箱」各種故事、景點、餐廳、超值好物⋯⋯甚至那些讓人會心一笑的生活小廢物;這次活動不僅送出了許多獎勵,也反映了「內容有價」——創作不只是分享、紀錄,也能用各種不同形式變現、帶來實際收入。
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) 抽象工廠
追蹤感興趣的內容從 Google News 追蹤更多 vocus 的最新精選內容追蹤 Google News