Swift Academy · Lekcja

Store i integracja z SwiftUI

Sterowanie widokami za pomocą store TCA.

Store i integracja z SwiftUI to bezpłatna lekcja Swift Academy na CoddyKit. To lekcja 2 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Swift Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Swift Academy zawiera 4 lekcji w sumie.

Czym jest Store

Store to obiekt czasu działania, który przechowuje stan funkcjonalności i uruchamia jej reducer. Widok SwiftUI obserwuje store, aby odczytywać stan, i wysyła do niego akcje, aby wywoływać zmiany.

Store jest pomostem między czystą logiką reduktora a działającym, interaktywnym interfejsem użytkownika.

import ComposableArchitecture
import SwiftUI

// A Store holds State, runs the Reducer,
// and is observed by SwiftUI views.

Alias typu StoreOf

StoreOf<Feature> to wygodny alias store'a wyspecjalizowanego dla typów stanu i akcji danej funkcjonalności. Widok zwykle przechowuje go jako właściwość.

Widok licznika przechowuje więc StoreOf<CounterFeature>.

import ComposableArchitecture
import SwiftUI

struct CounterView: View {
    let store: StoreOf<CounterFeature>
    var body: some View {
        Text("Count: \(store.count)")
    }
}

Tworzenie Store

Store tworzy się za pomocą inicjalizatora Store, przekazując stan początkowy i reducer, który ma zostać uruchomiony. Zwykle robi się to raz, w pobliżu punktu wejścia aplikacji.

Końcowe domknięcie zwraca instancję danej funkcjonalności.

import ComposableArchitecture
import SwiftUI

@main
struct MyApp: App {
    var body: some Scene {
        WindowGroup {
            CounterView(
                store: Store(initialState: CounterFeature.State()) {
                    CounterFeature()
                }
            )
        }
    }
}

Bezpośrednie odczytywanie stanu

Przy użyciu nowoczesnej obserwacji widok odczytuje stan bezpośrednio ze store'a za pomocą składni kropkowej, na przykład store.count. Ponieważ stan ma oznaczenie @ObservableState, SwiftUI ponownie renderuje tylko te części, które zależą od zmienionych wartości.

W przypadku prostych odczytów nie jest potrzebna żadna dodatkowa obudowa.

import ComposableArchitecture
import SwiftUI

struct CounterView: View {
    let store: StoreOf<CounterFeature>
    var body: some View {
        VStack {
            Text("Count: \(store.count)")
        }
    }
}

Wysyłanie akcji

Aby zmienić stan, widok wysyła akcję za pomocą store.send(.someAction). Store przekazuje akcję do reduktora, który modyfikuje stan i może uruchomić efekty.

W tym przykładzie przyciski wysyłają akcje zwiększania i zmniejszania wartości.

import ComposableArchitecture
import SwiftUI

struct CounterView: View {
    let store: StoreOf<CounterFeature>
    var body: some View {
        HStack {
            Button("-") { store.send(.decrementTapped) }
            Text("\(store.count)")
            Button("+") { store.send(.incrementTapped) }
        }
    }
}

Bindingi ze Store

W przypadku kontrolek SwiftUI wymagających dwukierunkowych bindingów TCA pozwala utworzyć Binding ze store'a, gdy stan korzysta z akcji obsługujących bindingi. Kontrolka aktualizuje stan, wysyłając akcję bindingu.

W tym przykładzie TextField jest powiązany z polem name.

import ComposableArchitecture
import SwiftUI

struct FormView: View {
    @Bindable var store: StoreOf<FormFeature>
    var body: some View {
        TextField("Name", text: $store.name)
    }
}

Starszy WithViewStore

Przed wprowadzeniem obserwacji widoki opakowywały interfejs w WithViewStore, aby odczytywać stan i uzyskiwać viewStore do wysyłania akcji. W starszym kodzie nadal można się z tym spotkać.

Domknięcie observe wybiera stan, od którego zależy widok.

import ComposableArchitecture
import SwiftUI

struct LegacyCounter: View {
    let store: StoreOf<CounterFeature>
    var body: some View {
        WithViewStore(store, observe: { $0 }) { viewStore in
            Text("Count: \(viewStore.count)")
        }
    }
}

Wybór obserwowanego stanu

W starszym stylu domknięcie observe zawęża stan obserwowany przez widok, dzięki czemu widok jest ponownie renderowany tylko wtedy, gdy te wartości się zmienią. Obserwowanie całego stanu jest najprostsze, a obserwowanie podzbioru optymalizuje duże widoki.

Nowoczesne @ObservableState obsługuje to automatycznie, ale zrozumienie observe pomaga podczas czytania starszego kodu.

import ComposableArchitecture
import SwiftUI

// Observe just the count to limit re-renders:
WithViewStore(store, observe: { $0.count }) { viewStore in
    Text("\(viewStore)")
}

Wysyłanie akcji z danymi

Akcje zawierające wartości powiązane wysyła się, przekazując odpowiednią wartość. W ten sposób widok przekazuje dane wejściowe użytkownika potrzebne reducerowi.

W tym przykładzie wybranie wiersza wysyła wybrane id.

import ComposableArchitecture
import SwiftUI

struct ListView: View {
    let store: StoreOf<ListFeature>
    var body: some View {
        Button("Pick 42") {
            store.send(.rowSelected(id: 42))
        }
    }
}

Animowanie akcji

Do wysyłanej akcji można dołączyć animację, aby wynikająca z niej zmiana stanu została zanimowana. Należy przekazać argument animation do metody send.

Dzięki temu kwestie animacji pozostają w miejscu wywołania, a stan nadal jest zwykłymi danymi.

import ComposableArchitecture
import SwiftUI

Button("Toggle") {
    store.send(.toggleTapped, animation: .default)
}

Tworzenie widoku

Kompletny widok TCA przechowuje StoreOf, odczytuje stan za pomocą składni kropkowej i wysyła akcje z kontrolek. Resztę wykonuje reducer, dzięki czemu widok pozostaje zwięzły i deklaratywny.

To rozdzielenie sprawia, że widoki TCA są łatwe do czytania i podglądania.

import ComposableArchitecture
import SwiftUI

struct CounterView: View {
    let store: StoreOf<CounterFeature>
    var body: some View {
        VStack {
            Text("Count: \(store.count)")
            Button("Increment") { store.send(.incrementTapped) }
        }
    }
}

Szybkie sprawdzenie: sterowanie interfejsem

Przypomnij sobie, jak widok SwiftUI wywołuje zmianę stanu w TCA.

Podsumowanie: Store i SwiftUI

Połączono funkcjonalność ze SwiftUI:

StoreOf<Feature> przechowuje stan i uruchamia reducer.
Store tworzy się ze stanem początkowym i reducerem funkcjonalności.
Nowoczesna obserwacja pozwala odczytywać stan za pomocą składni kropkowej, na przykład store.count.
Widoki zmieniają stan, wywołując store.send(.action), opcjonalnie z danymi lub animacją.
Starsze konstrukcje WithViewStore i jego domknięcie observe występują w starszym kodzie.

Następnie do reduktora zostaną dodane efekty uboczne i wstrzykiwane zależności.

import ComposableArchitecture
import SwiftUI

// Recap: StoreOf holds state, view reads with dot syntax,
// store.send(.action) drives every change.

Często zadawane pytania

Czy lekcja „Store i integracja z SwiftUI” jest bezpłatna?

Tak — pełny tekst „Store i integracja z SwiftUI” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Swift Academy, przejdź na CoddyKit PRO. Kurs Swift Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Store i integracja z SwiftUI”?

Sterowanie widokami za pomocą store TCA. Ćwiczysz Swift Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Swift Academy?

Nie wymagamy żadnego doświadczenia. Swift Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 2 z 4.

Ile czasu zajmuje lekcja „Store i integracja z SwiftUI”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Swift Academy?

Tak. Każda lekcja Swift Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do Swift Academy