Development on Joe's Blog

Swift 網路層生存指南 (Final) —— JPNetworking

Sun, 14 Jun 2026 00:00:00 +0000

前三篇（1、2、3）講完了救災概念——SafeBox 處理型別錯置、ShieldedResponse 導航巢狀 JSON、BaseResponse 統一外殼解析。

這篇把這套思路打包成 Swift Package：JPNetworking。

🏛️ 架構概覽

flowchart TD
 A([URLSession.request]) --> B[Build URLRequest]
 B --> C[networkLogger .request]
 C --> D[URLSession.data]
 D --> E{statusCode}
 E -->|401| F{refresher & 首次 401?}
 F -->|no| ERR([throw APIError])
 F -->|yes| G[TokenRefresher.refresh]
 G --> D
 E -->|other| H[networkLogger .response]
 H --> I[EndPoint.validate]
 I -->|throws| ERR
 I -->|ok| J[decode]
 J -->|throws| ERR
 J -->|ok| K([Return T])
 D -->|network error| L{retriesLeft > 0?}
 L -->|yes| D
 L -->|no| ERR

📦 安裝

1
2
3
4


// Package.swift
dependencies: [
 .package(url: "https://github.com/shinrenpan/JPNetworking", from: "0.1.0")
]

或在 Xcode：File → Add Package Dependencies。

SwiftUI TextField 限制輸入小數

Sat, 13 Jun 2026 00:00:00 +0000

UIKit 版本靠 shouldChangeCharactersIn 攔截每一次按鍵，SwiftUI 沒有這個 delegate，思路需要換一下：改成在 onChange 裡拿到變更後的完整字串，驗證、修正，再寫回去。

UIKit 版本：UITextField 限制輸入小數

實作

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38


struct DecimalTextField: View {
 @Binding var text: String

 var body: some View {
 TextField("0.00", text: $text)
 .keyboardType(.decimalPad)
 .onChange(of: text) { _, newValue in
 text = filtered(newValue)
 }
 }
}

private extension DecimalTextField {
 func filtered(_ input: String) -> String {
 // 只保留數字和小數點
 let cleaned = input.filter { "0123456789.".contains($0) }

 // 總長度限制
 guard cleaned.count <= 10 else { return text }

 // 只允許一個小數點
 let parts = cleaned.components(separatedBy: ".")
 guard parts.count <= 2 else { return text }

 // 小數點後最多 2 位
 if parts.count == 2, parts[1].count > 2 { return text }

 // 首位是 "." 自動補成 "0."
 if cleaned.hasPrefix(".") { return "0" + cleaned }

 // 首位是 0 且下一位不是 "."，移除多餘的 0
 if cleaned.count >= 2, cleaned.hasPrefix("0"), !cleaned.hasPrefix("0.") {
 return String(cleaned.dropFirst())
 }

 return cleaned
 }
}

與 UIKit 版的差異

	UIKit	SwiftUI
攔截時機	按鍵當下（字元尚未寫入）	變更後（拿到完整新字串）
復原方式	return false 阻止	把舊值寫回 `text`
自動補值	直接改 `textField.text`	把新值寫回 `text`
程式碼位置	delegate 方法	`onChange` + private func

SwiftUI 的 onChange 是在字串已經改變後才觸發，所以不能「阻止」輸入，只能「修正」回合法值。這是兩個版本最根本的差異。

為什麼我在 SwiftUI 專案裡自創了一套 MVVMC 架構

Fri, 24 Apr 2026 00:00:00 +0000

在公司與外包共同開發，並在外包離開後接手留下來的 SwiftUI 專案。外包用的是 TCA（The Composable Architecture），target iOS 15+，架構本身有它的邏輯，但接手之後我做了第一個決定，不繼續用 TCA。

接著把 minimum deployment target 直升 iOS 17+。@Observable 可以用了，WithPerceptionTracking 全部可以掃掉，光這件事就讓整個 codebase 清爽不少，bug 也少了不少。

但還有一個問題一直卡著我：導航。

🚩 SwiftUI 導航，用過就知道

NavigationStack、NavigationLink、.navigationDestination，光看 API 名稱感覺很整齊，用下去才知道有多零碎。

頁面跳轉的邏輯開始出現在各個 View 裡，A 頁知道 B 頁的存在，B 頁知道 C 頁的存在。專案小的時候還好，Feature 一多，導航邏輯就像藤蔓一樣纏進每個 View，要改一個跳轉邏輯得找半天。

更麻煩的是 state 管理，navigationPath、@State var isPresented、.sheet、.fullScreenCover 各自為政，散落在不同層級的 View 裡，沒有一個統一的地方可以看清楚整個 app 的導航狀態。

然後你就會遇到這種需求：

「使用者在購物車結帳完成後，dismiss 掉結帳流程，然後自動切換到『訂單』Tab，同時把購物車的 Navigation stack 清空。」

UIKit 的做法很直覺：

1
2
3
4


// 清空 stack、切 Tab，三行搞定
navigationController?.popToRootViewController(animated: false)
tabBarController?.selectedIndex = 2
dismiss(animated: true)

SwiftUI 呢？你需要在對的時機、對的層級，同時操控 navigationPath、selectedTab 這些分散在不同 View 的 state，還要確保時序正確，不然畫面會閃、動畫會跳、甚至 state 不同步。更麻煩的是，深層的 View 根本拿不到外層的 selectedTab，除非你用 @Environment 或 @Binding 一層一層往下傳，然後每個中間層都變成了導航邏輯的搬運工。

Swift 網路層生存指南 (3) —— API 亂象下的終極防線

Fri, 06 Feb 2026 00:00:00 +0000

這篇文章，我想聊聊一個「笑著笑著就哭了」的開發日常。

在過去開發的經驗中，常遇到 Backends 他們自己也沒 Spec, 給出的 Response 像是一場隨機發生的驚喜：

(成功 200)：
1. 直球對決型：{ "id": 1, "name": "Gemini" } (直接就是 DTO)。
2. 標準殼型：{ "data": { "id": 1, "name": "Gemini" } }。
3. 腦袋抽風多一層型：{ "data": { "somekey": { "id": 1, "name": "Gemini" } } } (不知道為何要多個 key)。
4. 大禮包型：{ "data": { "list": [...] } }。
(失敗 4xx/5xx)：
- 資料欄位瞬間蒸發，只剩 { "message": "something wrong" }。

面對這種「薛丁格的 JSON」，如果你只寫標準的 Codable，你的 Console 大概會被 keyNotFound 洗版到你懷疑人生。

🏛️ 架構圖：當 HTTP 狀態碼與動態路徑聯動

這套設計的核心在於：不再盲目相信 JSON 內容，而是透過注入「解析路徑 (decodePath)」來對付那些抽風的 Key。

Swift 網路層生存指南 (2)

Sat, 10 Jan 2026 00:00:00 +0000

如果說 SafeBox 是處理「單兵作戰」的防禦，那麼 BaseResponseProtocol 就是針對「陣地戰」的全局控管。

在一個大型專案中，你可能會遇到來自多個微服務的 API，它們的結構通常長這樣：

服務 A: { "status": true, "data": { ... } }
服務 B: { "code": 200, "result": { ... }, "msg": "success" }
服務 C: 直接吐一個 [ { ... } ] 連殼都沒有。

為了不幫每個服務都寫一套 Decoder，我們需要一個強大的通用協議。

🏛️ 響應層架構圖

這張圖展示了 BaseResponseProtocol 如何協同 ShieldedResponse 進行深度導航，直接挖出內部的 Payload。

graph LR
 A[API Response JSON] --> B{BaseResponseProtocol}
 B --> C[Status Check: isSuccess]
 B --> D[Message: message]
 B --> E[Data Container: result]

 subgraph Shielded_Navigation [路徑導航引擎]
 E --> F[userInfo: decodePath]
 F --> G[Key Path: 'data' -> 'items']
 G --> H[Final Payload: T]
 end

 H --> I[Domain Convertible]

🛠️ 核心協議定義

這套協議的核心在於 associatedtype Payload，它讓你在實作時才決定具體的資料型別，同時強制要求必須符合 Sendable 以適應 Swift 6。

Swift 網路層生存指南 (1)

Thu, 01 Jan 2026 00:00:00 +0000

這套架構的核心，是我在無數個被 API 炸掉的午夜，與一個「非人類助手」共同參悟出來的生存法則。

身為 iOS 工程師，我們最大的壓力來源通常不是複雜的 UI，而是**「後端不按牌理出牌的 API」**。當髒資料導致 App 出錯，面對老闆的連環追問：「為什麼別人的 App 沒事，我們的會閃退？」、「這不是昨天才修過嗎？」，你需要的不是更多的 try?，而是這套強大的「救災架構」。

🚩 BadBackend 奇葩行為大賞 (血汗處刑清單)

在給出解決方案前，我們先看看這些讓開發者血壓飆升的真實案例。這不是虛構，這是我們的日常：

【薛丁格的 ID】：有資料時 id: "123"，沒資料時欄位直接失蹤，或是給 id: null。
【型別人格分裂】：price 這一秒是 Double (99.0)，下一秒變 String ("99.0")。
【Bool 的創意大賽】：true 有時是 1，有時是 "Y"，有時是 "on"，甚至還給過 "checked"。
【外殼變色龍】：今天資料包在 data，明天改叫 items，後天直接吐 Array 不包殼。

🏛️ 救災架構視覺化

為了讓你理解這套系統是如何在混亂中維持秩序，我們來看這張資料流向圖：

graph TD
 subgraph JSON_Source [原始髒資料]
 A[Missing Keys / Nulls]
 B[Type Mismatch: '123' vs 123]
 C[Corrupted Array Elements]
 end

 subgraph Defense_Layer [DTO 防禦層 - SafeBox / SafeArray]
 D{SafeBox Decoder}
 E{SafeArray Recovery}
 D -->|Type Rescue| F[Normalizing Types]
 D -->|Key Missing| G[Inject Default Value]
 E -->|Element Fail| H[Insert Default Instance]
 end

 subgraph Domain_Layer [Domain 轉換層]
 I[toDomain Mapping]
 J{關鍵欄位驗證策略}
 I --> J
 J -->|情境一| K[給予隨機 ID / 保證渲染]
 J -->|情境二| L[回傳 nil / 直接過濾]
 end

 JSON_Source --> Defense_Layer
 Defense_Layer --> Domain_Layer
 Domain_Layer --> M[ViewModel / UI]

 style Defense_Layer fill:#f96,stroke:#333,stroke-width:2px
 style Domain_Layer fill:#bbf,stroke:#333,stroke-width:2px

🛠️ 核心救災工具包

SafeBox 是整套架構的基石，處理三種情況：null 補預設值、型別錯置嘗試轉換、欄位缺失補預設值。

FHIR OAuth Demo

Tue, 18 Mar 2025 00:00:00 +0000

醫療系統的 App 要存取病患資料，繞不開 FHIR。這篇記錄如何用 SMART on FHIR 完成 OAuth 授權，並用 Apple 官方的 FHIRModels 套件解析回傳的資料。

什麼是 SMART on FHIR

FHIR（Fast Healthcare Interoperability Resources）：HL7 制定的醫療資料交換標準，R4 是目前主流版本
SMART on FHIR：在 FHIR 上套用 OAuth 2.0 的授權框架，讓第三方 App 可以安全存取醫療系統的資料

流程跟一般的 OAuth Authorization Code Flow 一樣：取得 code → 換 token → 用 token 呼叫 API。

整體流程

sequenceDiagram
 participant App
 participant Browser as ASWebAuthenticationSession
 participant Server as SMART Server

 App->>Browser: 開啟授權 URL
 Browser->>Server: 使用者登入授權
 Server-->>Browser: redirect_uri?code=xxx
 Browser-->>App: callback URL
 App->>Server: POST /token（帶 code）
 Server-->>App: access_token
 App->>Server: GET /fhir/Patient（帶 Bearer token）
 Server-->>App: FHIR Bundle（病患資料）

Step 1：建立授權 URL

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


func makeOAuthURL() -> URL? {
 let authURI = "https://launch.smarthealthit.org/.../auth/authorize"

 guard var components = URLComponents(string: authURI) else { return nil }
 components.queryItems = [
 .init(name: "response_type", value: "code"),
 .init(name: "redirect_uri", value: "app://"),
 .init(name: "aud", value: "https://launch.smarthealthit.org/.../fhir"),
 .init(name: "scope", value: "patient/*.cruds"),
 ]
 return components.url
}

scope: patient/*.cruds 代表要求對所有 Patient 資源的讀寫權限。redirect_uri 用自訂 scheme app://，授權完成後系統會把 callback URL 傳回 App。

用 MQTT 設計 IM 架構

Thu, 06 Mar 2025 00:00:00 +0000

上一篇寫了 MQTT 聊天 Demo，這篇來聊設計思路。

MQTT 的 Pub/Sub 模型乍看只適合廣播，但只要 Topic 設計得好，點對點、群組、系統通知全部都能處理，payload 再加上 REST API 補完，一套完整的 IM 架構就出來了。

sequenceDiagram
 participant A as User A
 participant B as User B
 participant Broker as MQTT Broker
 participant API as REST API

 Note over A, Broker: 登入 / 訂閱
 A->>Broker: subscribe(userId_A)
 A->>Broker: subscribe(system)
 B->>Broker: subscribe(userId_B)
 B->>Broker: subscribe(system)

 Note over A, API: A 傳訊息給 B
 A->>Broker: publish(userId_B, payload: { type, content, senderId })
 Broker-->>B: 推送訊息

 Note over B, API: B 取補充資料
 B->>API: GET /api/users/A/profile
 API-->>B: 頭像、顯示名稱

 Note over Broker: 系統廣播
 Broker-->>A: system topic
 Broker-->>B: system topic

Topic 設計：每個 User 訂閱兩個 Topic

{userId} ← 只有你收得到
system ← 所有人都收得到

登入後，每個 User 訂閱自己的 userId Topic 和 system Topic，就這樣。

MQTT 實作聊天 Demo

Tue, 04 Mar 2025 00:00:00 +0000

MQTT 是一個輕量的 Pub/Sub 協定，拿來做聊天有幾個優點：

QoS（Quality of Service）內建：提供三個等級的送達保證，最高等級 QoS 2 確保訊息恰好送達一次，不需要自己實作重送機制
Payload 完全客製化：IM 需要的語意——已讀、上線狀態、群組通知——全部定義在 payload 裡，彈性高

Facebook Messenger 早期也是用 MQTT 做即時訊息的傳輸層。

架構概覽

採用 MVVMC，兩個頁面：

Home：輸入使用者名稱進入聊天室
Room：聊天室主頁面，連線 MQTT broker、收發訊息

MQTT 的操作集中在 MQTTManager，ViewModel 不直接碰 MQTT。

MQTTManager

1
2
3
4
5
6


actor MQTTManager {
 static let shared = MQTTManager()
 private let topic = "JoeChatDemo/chat"
 private var client: MQTTClient?
 private let eventLoopGroup = NIOTSEventLoopGroup()
}

用 actor 封裝，確保 client 的狀態在 concurrent 環境下安全存取。

播放本地端 m3u8

Wed, 13 Jul 2022 00:00:00 +0000

AVPlayer 可以直接以 file:// URL 播放本地影片，但對於 .m3u8 playlist，它會在解析完 manifest 後，直接嘗試以原始路徑載入每一個 segment。這個過程完全繞過了 AVAssetResourceLoaderDelegate，導致無法攔截並自訂載入行為。

簡單說：file:// URL 太「正常」了，AVPlayer 自己就處理掉，不給你插手的機會。

解法：自訂 Scheme

AVAssetResourceLoaderDelegate 只對 AVPlayer 不認識的 scheme 生效。

做法是在建立 AVURLAsset 時，把 file:// 替換成自訂的 local://：

file:///var/mobile/.../video.m3u8
 ↓ 替換 scheme
local:///var/mobile/.../video.m3u8

AVPlayer 看到 local://，不知道怎麼處理，就把請求轉交給 AVAssetResourceLoaderDelegate。

關鍵 delegate 方法：

1
2
3


func resourceLoader(_ resourceLoader: AVAssetResourceLoader, shouldWaitForRenewalOfRequestedResource renewalRequest: AVAssetResourceRenewalRequest) -> Bool { }

func resourceLoader(_ resourceLoader: AVAssetResourceLoader, shouldWaitForLoadingOfRequestedResource loadingRequest: AVAssetResourceLoadingRequest) -> Bool { }

Demo ｜參考

本文使用 Claude 共同完成

UITextField 限制輸入小數

Fri, 25 Dec 2020 00:00:00 +0000

金融、電商類的 app 常常需要限制輸入金額，只允許輸入合法的小數——不能有多個小數點、小數點後只能兩位、開頭不能多餘的零。

UITextField 本身不提供這些限制，需要自己透過 delegate 的 shouldChangeCharactersIn 來攔截每一次輸入。

設定

1
2


textField.keyboardType = .decimalPad
textField.delegate = self

decimalPad 讓鍵盤只顯示數字和小數點，但這只是 UI 層面的限制，使用者仍然可以透過貼上功能輸入任意字元，所以 delegate 的驗證不能省。

shouldChangeCharactersIn 實作

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35


func textField(_ textField: UITextField, shouldChangeCharactersIn range: NSRange, replacementString string: String) -> Bool {
 guard let text = textField.text else { return true }

 // 1. 刪除事件直接放行
 guard !string.isEmpty else { return true }

 // 2. 只允許數字和小數點
 guard "0123456789.".contains(string) else { return false }

 // 3. 總長度限制（最多 10 位）
 if text.count >= 10 { return false }

 // 4. 小數點後最多 2 位
 if let dotRange = text.range(of: ".") {
 let dotIndex = NSRange(dotRange, in: text).location
 if range.location - dotIndex > 2 { return false }
 }

 // 5. 首位是 0 時，下一個只能是小數點
 if text == "0", string != "." {
 textField.text = string
 return false
 }

 // 6a. 首位直接輸入小數點，自動補成 "0."
 if text.isEmpty, string == "." {
 textField.text = "0."
 return false
 }

 // 6b. 禁止重複輸入小數點
 if text.contains("."), string == "." { return false }

 return true
}

六種邊界情況

情況	處理方式
刪除（string 為空）	直接放行
貼上非法字元	攔截，return false
超過 10 位	攔截，return false
小數點後超過 2 位	攔截，return false
首位輸入 0 再輸入數字	替換成輸入的數字
首位輸入小數點	自動補成 `0.`
重複輸入小數點	攔截，return false

SwiftUI 版本另見：SwiftUI TextField 限制輸入小數

UILabel 計算行數、每行字串、每行大小

Wed, 01 Jul 2020 00:00:00 +0000

UILabel 很方便，但有幾件事它不告訴你：這段文字實際跑了幾行？每行的內容是什麼？每行佔的大小是多少？

這些需求在做客製化 UI 的時候常常會遇到，例如「超過三行就顯示漸層遮罩」、「第一行要特別標色」、「根據每行高度計算捲動位置」。UILabel 的公開 API 沒有提供，只好自己往下挖。

為什麼 UILabel 沒有這些 API

UILabel 的設計目標是顯示文字，不是提供排版資訊。實際的排版工作由底層的 CoreText 或 TextKit（NSLayoutManager） 完成，UILabel 把這些細節都封裝起來了。

要拿到行數和行內容，就必須繞過 UILabel，自己用同樣的文字和寬度重新跑一遍排版計算。

三個計算屬性

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65


extension UILabel {

 // MARK: - 行數

 var lineCount: Int {
 guard let text = attributedText else { return .zero }

 let framesetter = CTFramesetterCreateWithAttributedString(text)
 let fittingRect = CGRect(x: 0, y: 0, width: frame.width, height: .greatestFiniteMagnitude)
 let path = UIBezierPath(rect: fittingRect)
 let ctFrame = CTFramesetterCreateFrame(framesetter, CFRangeMake(0, 0), path.cgPath, nil)
 let lines = CTFrameGetLines(ctFrame) as Array

 return lines.count
 }

 // MARK: - 每行字串

 var lineStrings: [String]? {
 guard let text = text, let font = font else { return nil }

 let attStr = NSMutableAttributedString(string: text)
 attStr.addAttribute(.font, value: font, range: NSRange(location: 0, length: attStr.length))

 let framesetter = CTFramesetterCreateWithAttributedString(attStr)
 let fittingRect = CGRect(x: 0, y: 0, width: frame.width, height: .greatestFiniteMagnitude)
 let path = UIBezierPath(rect: fittingRect)
 let ctFrame = CTFramesetterCreateFrame(framesetter, CFRangeMake(0, attStr.length), path.cgPath, nil)

 guard let lines = CTFrameGetLines(ctFrame) as? [CTLine] else { return nil }

 return lines.map { line in
 let range = CTLineGetStringRange(line)
 return (text as NSString).substring(with: NSRange(location: range.location, length: range.length))
 }
 }

 // MARK: - 每行 Frame

 var lineFrames: [CGRect] {
 guard let text = attributedText else { return [] }

 let layoutManager = NSLayoutManager()
 let textStorage = NSTextStorage(attributedString: text)
 textStorage.addLayoutManager(layoutManager)

 let textContainer = NSTextContainer(size: CGSize(width: frame.width, height: .greatestFiniteMagnitude))
 textContainer.lineFragmentPadding = 0
 textContainer.lineBreakMode = .byWordWrapping
 textContainer.maximumNumberOfLines = 0
 layoutManager.addTextContainer(textContainer)

 var result: [CGRect] = []
 var index = 0
 var lineRange = NSRange(location: NSNotFound, length: 0)

 while index < layoutManager.numberOfGlyphs {
 let rect = layoutManager.lineFragmentUsedRect(forGlyphAt: index, effectiveRange: &lineRange)
 result.append(rect)
 index = NSMaxRange(lineRange)
 }

 return result
 }
}

為什麼 lineCount 和 lineStrings 用 CoreText，lineFrames 用 TextKit

CoreText 和 TextKit 是兩套不同層級的文字排版系統：

變更 Git commit 註解符號

Fri, 06 Mar 2020 00:00:00 +0000

Git commit message 的編輯器裡，# 預設是註解符號，存檔後這一行不會被納入 commit message。

大多數時候沒問題，但如果你的 commit message 需要用 # 開頭——例如引用 issue 編號 #123 Fix login bug——Git 就會把整行吃掉，留下一個空的 commit message。

解法

把 Git 的 commit 註解符號改成其他字元，例如 ;：

1

git config --global core.commentchar ';'

改完之後，commit 編輯器裡改以 ; 開頭的行才會被視為註解，# 就可以自由使用了。

只改單一 repo

如果不想改全域設定，拿掉 --global 就只會影響當前 repo：

1

git config core.commentchar ';'

硬體推播至 iPhone

Wed, 04 Mar 2020 00:00:00 +0000

如果你在網路上搜尋「讓硬體裝置接收 iPhone 通知」，大概會找不到什麼有用的結果。這個需求聽起來直覺，實作起來卻很冷門——大多數人根本不知道這個功能叫什麼。

關鍵字是 ANCS：Apple Notification Center Service。

ANCS 是什麼

ANCS 是 Apple 定義的一套 BLE（Bluetooth Low Energy）GATT 協定，讓藍牙配件可以接收 iPhone 上的通知。

角色分兩種：

Notification Provider（NP）：iPhone，扮演 GATT Server，負責發送通知
Notification Consumer（NC）：硬體配件，扮演 GATT Client，負責接收通知

ANCS 公開三個 GATT Characteristic：

Characteristic	方向	用途
Notification Source	NP → NC	推送通知事件（新增、修改、刪除）
Control Point	NC → NP	請求通知的詳細資料
Data Source	NP → NC	回傳通知詳細內容

流程大致是：iPhone 有新通知 → 透過 Notification Source 推給配件 → 配件透過 Control Point 要求詳細內容 → iPhone 透過 Data Source 回傳 app 名稱、標題、內文等資訊。

NSObject 鏈式 Setter

Sun, 01 Mar 2020 00:00:00 +0000

UIKit 開發久了，最煩的事情之一就是初始化一個 View：

1
2
3
4
5


let subView: UIView = .init(frame: .zero)
subView.translatesAutoresizingMaskIntoConstraints = false
subView.clipsToBounds = true
subView.layer.cornerRadius = 10
subView.backgroundColor = .black

五個屬性，五行，subView 重複出現五次。這還只是一個 View，整個畫面十幾個元件疊下來，viewDidLoad 就已經半條命了。

核心想法

Swift 的 WritableKeyPath 可以讓你用 \.propertyName 的語法指向某個屬性，配合 @discardableResult 讓方法回傳 self，就能串起來一路點下去。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


extension NSObjectProtocol {
 @discardableResult
 func setup<Value>(_ keypath: WritableKeyPath<Self, Value>, value: Value) -> Self {
 var result = self
 result[keyPath: keypath] = value
 return result
 }

 @discardableResult
 func setup<Value>(_ keypath: WritableKeyPath<Self, Value>, condition: () -> Value) -> Self {
 var result = self
 result[keyPath: keypath] = condition()
 return result
 }
}

兩個多載：