前端移動開發(fā)【免費下載鏈接】swift-composable-architectureA library for building applications in a consistent and understandable way, with composition, testing, and ergonomics in mind.項目地址https://gitcode.com/GitHub_Trending/sw/swift-composable-architecture點擊查看免費下載導(dǎo)讀Store是 Swift Composable ArchitectureTCA中驅(qū)動整個應(yīng)用運行的運行時對象也是視圖與業(yè)務(wù)邏輯之間的唯一橋梁。本指南以官方文檔 Store.md 為主線結(jié)合 Store.swift 源碼與相關(guān)觀察、綁定擴展系統(tǒng)講解 Store 的創(chuàng)建方式、狀態(tài)讀取、Action 發(fā)送、Store 作用域切分scoping、Binding 綁定以及 Combine 集成。讀完本指南你將掌握如何在一個真實 TCA 項目中正確地構(gòu)造根 Store、向子視圖派生子 Store、綁定可寫狀態(tài)并理解 StoreTask 生命周期管理與底層緩存機制。Store 在 TCA 架構(gòu)中的定位從源碼注釋Store.swift可以看到Store 被明確定義為驅(qū)動應(yīng)用的運行時runtime是需要在視圖中傳遞、用于讀取功能狀態(tài)state和發(fā)送用戶操作action的對象。它的類聲明為dynamicMemberLookup preconcurrency MainActor public final class StoreState, Action: _Store幾個關(guān)鍵設(shè)計點MainActorStore 的所有操作都限定在主線程執(zhí)行這是 UI 框架安全性的硬性保證dynamicMemberLookup允許視圖直接通過store.count這樣的語法讀取狀態(tài)屬性final classStore 是引用類型應(yīng)用通常只創(chuàng)建一個根 Store再通過scope派生多個子 Store。一個典型的應(yīng)用入口會在App中持有根 Store并在WindowGroup中傳遞給根視圖main struct MyApp: App { static let store Store(initialState: AppFeature.State()) { AppFeature() } var body: some Scene { WindowGroup { RootView(store: Self.store) } } }注意Xcode 預(yù)覽運行時同樣會創(chuàng)建 App 入口導(dǎo)致 Store 及依賴被提前執(zhí)行因此源碼特別建議將根 Store 保存在static let中見 Store.swift避免預(yù)覽場景下的意外副作用。創(chuàng)建 Storeinit(initialState:reducer:withDependencies:)與StoreOf初始化方法Store 的公開初始化方法簽名如下Store.swiftpublic convenience initR: ReducerState, Action( initialState: autoclosure () - R.State, ReducerBuilderState, Action reducer: () - R, withDependencies prepareDependencies: ((inout DependencyValues) - Void)? nil )三個參數(shù)的作用參數(shù)類型說明initialState自動閉包應(yīng)用啟動時的初始狀態(tài)使用autoclosure保證惰性求值reducerReducerBuilder驅(qū)動業(yè)務(wù)邏輯的 Reducer可由Reduce、.onChange、.ifLet等操作符組合構(gòu)建withDependencies可選閉包覆蓋依賴注入容器中的依賴nil時使用默認依賴底層實現(xiàn)Store.swift在初始化時會做三件事讀取當前依賴注入環(huán)境、為當前狀態(tài)追加一個新的導(dǎo)航 IDnavigationIDPath.append(NavigationID())、最后將固定后的依賴寫回 reducer 的dependency(\.self, dependencies)。這意味著創(chuàng)建 Store 的時刻就是依賴固化snapshot的時刻后續(xù)依賴變化不會影響該 Store。實際使用示例let store Store( initialState: AppFeature.State(), reducer: { AppFeature() }, withDependencies: { $0.apiClient .mock } )StoreOf便捷別名Store需要兩個泛型參數(shù)State與Action而一個 Reducer 的領(lǐng)域通常固定為R.State和R.Action。因此源碼定義了一個類型別名Store.swiftpublic typealias StoreOfR: Reducer StoreR.State, R.Action對比兩種寫法// 完整寫法 let store: StoreFeature.State, Feature.Action // StoreOf 寫法 let store: StoreOfFeatureStoreOf大量出現(xiàn)在視圖屬性聲明中例如let store: StoreOfAppFeature不僅減少樣板代碼還讓 Reducer 與 Store 的領(lǐng)域自動保持同步。訪問狀態(tài)state、動態(tài)成員查找與withState(_:)直接讀取state當State符合ObservableState協(xié)議即狀態(tài)標注了ObservableState宏時Store 暴露只讀的state屬性StoreObservation.swiftpublic var state: State { self.observableState }其中observableState會先通過 observation registrar 登記對該狀態(tài)的訪問再返回當前狀態(tài)——這正是視圖內(nèi)讀取store.state能夠被 Observation 框架跟蹤依賴的原因。動態(tài)成員查找得益于dynamicMemberLookupStore 上定義了讀下標StoreObservation.swiftpublic subscriptValue(dynamicMember keyPath: KeyPathState, Value) - Value { self.state[keyPath: keyPath] }這使得視圖可以直接寫struct RootView: View { let store: StoreOfAppFeature var body: some View { Form { Text(\(store.count)) // 等價于 store.state.count Button(Tap) { store.send(.buttonTapped) } } } }withState(_:)已廢棄早期版本通過withState讀取狀態(tài)但現(xiàn)在它被標記為廢棄Deprecations.swift官方遷移建議是改用ObservableState宏// 舊寫法已廢棄 store.withState { $0.count } // 新寫法 store.count詳細遷移步驟可參考 MigratingTo1.7.md。發(fā)送 Actionsend(_:)系列與StoreTask基本發(fā)送send是視圖與業(yè)務(wù)邏輯交互的唯一入口discardableResult public func send(_ action: Action) - StoreTask標注discardableResult意味著可以忽略返回值內(nèi)部實現(xiàn)會調(diào)用底層 core 的send(action, origin: .store)Store.swift。帶動畫與事務(wù)的發(fā)送文檔列出另外兩個重載send(_:animation:)攜帶 SwiftUI 動畫發(fā)送 actionsend(_:transaction:)攜帶完整Transaction發(fā)送。不過源碼中這兩個 API 已被標注為計劃廢棄deprecation 年份設(shè)為 9999推薦的新寫法是// 舊寫法計劃廢棄 store.send(.increment, animation: .default) // 推薦寫法 withAnimation(.default) { store.send(.increment) }對于事務(wù)同理withTransaction(transaction) { store.send(action) }見 Store.swift 與 #L236-L270。在 Effect 內(nèi)部發(fā)送帶動畫的 action 時應(yīng)使用.run { send in await send(.response, animation: .default) }見 Deprecations.swift。StoreTask效果生命周期與取消send返回的StoreTask代表該 action 觸發(fā)的 Effect 的生命周期Store.swift它提供三個成員成員類型作用cancel()方法取消底層任務(wù)finish()async 方法等待任務(wù)執(zhí)行完畢isCancelled只讀屬性任務(wù)是否已被取消典型用法是把效果的生命周期綁定到 SwiftUI 的task視圖修飾符上.task { await store.send(.task).finish() }當視圖離開屏幕時task修飾符自動取消異步上下文StoreTask會隨之取消對應(yīng)的 Effect——這正是 TCA 中效果自動清理的核心機制。與 Swift 原生Task不同StoreTask會在當前異步上下文與任務(wù)之間自動建立取消處理Store.swift。派生子 Storescope(_:action:)與作用域切分為什么需要 scope大型應(yīng)用中根 Store 承載整個應(yīng)用的領(lǐng)域State Action。如果把根 Store 直接傳給每個子視圖子視圖將被迫依賴全局領(lǐng)域模塊化將無從談起。scope方法允許把根 Store 變換為只處理某個子領(lǐng)域child state/child action的 Storepublic func scopeChildState, ChildAction( _ state: KeyPathState, ChildState, action: CaseKeyPathAction, ChildAction ) - StoreChildState, ChildAction例如一個包含登錄、搜索、個人頁三個 Tab 的應(yīng)用struct AppView: View { let store: StoreOfAppFeature var body: some View { TabView { ActivityView(store: store.scope(\.activity, action: \.activity)) .tabItem { Text(Activity) } SearchView(store: store.scope(\.search, action: \.search)) .tabItem { Text(Search) } ProfileView(store: store.scope(\.profile, action: \.profile)) .tabItem { Text(Profile) } } } }通過 scopingSearchView可以被打包成獨立模塊完全不感知AppFeature.State與AppFeature.Action的存在Store.swift。底層實現(xiàn)ScopedCore 與子 Store 緩存scope的實現(xiàn)Store.swift值得深挖構(gòu)建ScopedCore(base:stateKeyPath:actionKeyPath:)在父 core 之上完成狀態(tài)投影與 action 包裝用statekey path 和actioncase key path 組合成ScopeIDStore.swift作為子 Store 的緩存鍵通過children字典緩存子 StoreStore.swift相同 key path 組合重復(fù)調(diào)用 scope 會返回同一個 Store 實例避免視圖刷新時不斷創(chuàng)建新 Store 導(dǎo)致狀態(tài)丟失。當子狀態(tài)是可選值Optional時還有對應(yīng)的 optional 版本scope(_:action:fileID:filePath:line:column:)它返回StoreChildState, ChildAction?常用于if let解包子 Storeif let childStore store.scope(\.child, action: \.child) { ChildView(store: childStore) }重要此操作只能在 SwiftUI 視圖內(nèi)部或withPerceptionTracking中使用才能正確觀察可選狀態(tài)的變化StoreObservation.swift。文件路徑、行號參數(shù)用于定位運行時警告自動由#fileID、#line等字面量填充?？蓪懡壎▌討B(tài)成員下標與BindableAction當 Store 的Action符合BindableAction且State與Action.State一致時Store 額外獲得可寫的動態(tài)成員下標BindingObservation.swiftpublic subscriptValue: Equatable Sendable( dynamicMember keyPath: WritableKeyPathState, Value ) - Value { get { self.state[keyPath: keyPath] } set { self.send(.set(keyPath.unsafeSendable(), newValue, ...)) } }讀取返回當前狀態(tài)寫入則通過發(fā)送.set綁定 action 走完整 reducer 管道。于是視圖可以極簡地綁定可寫字段TextField(Search, text: $store.query)這里的$store.query通過Binding(subscript:)橋接將 SwiftUI 的Binding與 Store 的可寫下標打通。若Action符合ViewAction且其ViewAction符合BindableAction同樣支持通過.view(.set(...))間接綁定BindingObservation.swift。Combine 集成StorePublisher對于仍在使用 Combine 的場景Store 提供publisher屬性Store.swift返回類型為StorePublisherState——一個dynamicMemberLookup的 Publisher其Output State、Failure Never。它支持動態(tài)成員查找可直接抽取狀態(tài)中的某個字段且該字段必須Equatable以便自動removeDuplicates()Store.swiftstore.publisher.alert .sink { ... }需要注意StorePublisher 目前已被標注為計劃廢棄官方建議改用 Observation 框架ObservableStateobserve替代但在存量 Combine 代碼中仍可正常使用。ObservableObject 與 ObservationStore 的觀察方式Store 聲明為ObservableObject但這一協(xié)議符合是惰性的Store.swift它的唯一用途是讓 Store 能被 SwiftUI 的StateObject持有而不是通過ObservedObject觀察。extension Store: ObservableObject {}真正的狀態(tài)觀察依賴兩套機制iOS 17或 macOS 14 等新平臺Store 在canImport(Observation)條件下擴展為ObservableStore.swift配合狀態(tài)上的ObservableState宏使用舊系統(tǒng)iOS 17通過 Perception 包實現(xiàn)等價的感知跟蹤Store 擴展為PerceptibleStoreObservation.swift。此外 Store 還實現(xiàn)了值語義比較Equatable采用引用相等Hashable基于對象標識并符合IdentifiableStoreObservation.swift這使得 Store 可以直接放入 SwiftUI 的ForEach、task等場景使用。其他值得了解的接口與棄用接口Store 文檔中還列出了以下補充接口scope 的另一種形式早期帶參數(shù)標簽的scope(state:action:)已被renamed: scope(_:action:)標記棄用Store.swiftcase運算符與 case key path 模式匹配相關(guān)的運算符用于對 Store 的 action 做 case 分解與綁定調(diào)試描述Store 的debugDescription會智能輸出類型名例如當State/Action恰好以.State/.Action結(jié)尾且前綴一致時輸出StoreOfFeatureStore.swift方便日志與調(diào)試生命周期日志Store 初始化與析構(gòu)都會寫入統(tǒng)一 LoggerStore.swift結(jié)合storeTypeName可以追蹤 Store 的創(chuàng)建與釋放排查內(nèi)存泄漏。所有已棄用接口的完整說明集中收錄在 StoreDeprecations.md 中。測試驗證與進一步探索Store 的核心行為在倉庫中有大量測試覆蓋可作為理解與驗證的參考StoreTests.swiftStore 初始化、send、scope 的基礎(chǔ)行為StorePerceptionTests.swiftObservation/Perception 感知跟蹤的正確性BindableStoreTests.swift可寫綁定下標的讀寫與 reducer 聯(lián)動StoreLifetimeTests.swiftStore 生命周期、子 Store 緩存與釋放行為。在實際項目中建議遵循一個根 Store 按功能 scope 子 Store的實踐根 Store 只在 App 入口創(chuàng)建一次子視圖一律通過store.scope(...)接收最小領(lǐng)域的 Store需要寫回狀態(tài)時優(yōu)先使用ObservableState配合可寫動態(tài)成員下標讓綁定始終經(jīng)過 reducer從而保證整個應(yīng)用的狀態(tài)流轉(zhuǎn)可預(yù)測、可測試。贊分享前端移動開發(fā)【免費下載鏈接】swift-composable-architectureA library for building applications in a consistent and understandable way, with composition, testing, and ergonomics in mind.項目地址https://gitcode.com/GitHub_Trending/sw/swift-composable-architecture點擊查看免費下載相關(guān)推薦深入Zustand核心Store創(chuàng)建與狀態(tài)管理深入Zustand核心Store創(chuàng)建與狀態(tài)管理 本文深入探討了Zustand狀態(tài)管理庫的核心機制從create函數(shù)的工作原理與實現(xiàn)機制開始詳細解析了其函數(shù)前端Pinia 組合式 Store 實戰(zhàn)跨 Store 共享狀態(tài)、Getter 與 Action 的完整指南Pinia 組合式 Store 實戰(zhàn)跨 Store 共享狀態(tài)、Getter 與 Action 的完整指南 組合式 StoreComposing Stores前端狀態(tài)管理Yup 擴展指南通過 addMethod、transform 與繼承構(gòu)建自定義 Schema 校驗?zāi)芰up 擴展指南通過 addMethod、transform 與繼承構(gòu)建自定義 Schema 校驗?zāi)芰?Yup 是一個用于運行時值解析與校驗的 schema前端移動開發(fā)上一篇A-to-Z-Resources-for-Students技術(shù)博客流量增長策略下一篇A-to-Z-Resources-for-Students開源許可證詳解與選擇指南創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考