Swift Academy · 강의

기능 조합과 테스트

리듀서를 결합하고 모든 경우를 철저히 테스트합니다.

기능 조합과 테스트은(는) CoddyKit의 무료 Swift Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Swift Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Swift Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

기능 구성하기

실제 앱은 여러 개의 작은 기능으로 구성됩니다. TCA를 사용하면 부모 기능에 자식 기능을 포함할 수 있으므로 각 기능이 한 가지 역할에 집중하면서 더 큰 전체로 결합할 수 있습니다. 이를 위한 도구가 Scope와 자식 상태 및 동작 포함하기입니다.

구성은 The Composable Architecture라는 이름이 붙은 이유이기도 합니다.

import ComposableArchitecture

// A parent feature embeds child State and Action,
// then uses Scope to run the child's reducer.

자식 상태 포함하기

부모의 State는 속성으로 자식의 상태를 보유합니다. 부모의 Action 열거형에는 자식의 동작을 감싸는 케이스가 있습니다. 이러한 중첩 구조는 UI가 중첩되는 방식을 그대로 반영합니다.

이 예제에서는 부모가 카운터 자식을 보유합니다.

import ComposableArchitecture

@Reducer
struct AppFeature {
    @ObservableState
    struct State: Equatable {
        var counter = CounterFeature.State()
    }
    enum Action {
        case counter(CounterFeature.Action)
    }
    var body: some ReducerOf<Self> { EmptyReducer() }
}

자식 범위 지정하기

Scope는 부모 상태와 동작 중 자식에 해당하는 부분에 자식 리듀서를 실행합니다. 상태 키 경로와 동작 케이스 경로를 지정한 다음 자식 리듀서를 전달합니다.

이렇게 하면 자식이 부모의 업데이트 흐름에 연결됩니다.

import ComposableArchitecture

var body: some ReducerOf<Self> {
    Scope(state: \.counter, action: \.counter) {
        CounterFeature()
    }
    Reduce { state, action in
        // parent-specific logic here
        return .none
    }
}

여러 리듀서 결합하기

기능의 body에는 여러 리듀서를 나열할 수 있으며, TCA는 각 동작에 대해 리듀서를 순서대로 실행합니다. 따라서 부모 자체의 Reduce와 하나 이상의 Scope를 함께 배치할 수 있습니다.

이 예제에서는 두 자식과 부모 로직이 함께 작동합니다.

import ComposableArchitecture

var body: some ReducerOf<Self> {
    Scope(state: \.profile, action: \.profile) { ProfileFeature() }
    Scope(state: \.settings, action: \.settings) { SettingsFeature() }
    Reduce { state, action in
        return .none
    }
}

자식 뷰를 위한 저장소 범위 지정하기

뷰 측에서는 자식 뷰에 자식 전용 저장소가 필요합니다. 부모는 store.scope를 사용해 자식의 상태와 동작으로 매핑되는 저장소를 파생합니다.

이 예제에서는 부모 뷰가 범위가 지정된 저장소를 카운터 뷰에 전달합니다.

import ComposableArchitecture
import SwiftUI

struct AppView: View {
    let store: StoreOf<AppFeature>
    var body: some View {
        CounterView(
            store: store.scope(state: \.counter, action: \.counter)
        )
    }
}

TestStore 소개

TestStore를 사용하면 기능이 정확히 어떻게 동작하는지 검증할 수 있습니다. 동작을 보내고 상태가 어떻게 변경되어야 하는지 설명하면, 실제 결과가 다를 때 테스트가 실패합니다. 이러한 철저한 검사는 미묘한 회귀를 찾아냅니다.

초기 상태와 리듀서를 사용해 일반 저장소와 같은 방식으로 만듭니다.

import ComposableArchitecture
import XCTest

func testIncrement() async {
    let store = await TestStore(initialState: CounterFeature.State()) {
        CounterFeature()
    }
}

상태 변경 검증하기

TestStore에 동작을 보낼 때 예상되는 변경을 설명하는 클로저를 전달합니다. 상태가 정확히 그 방식으로 변경될 때만 테스트가 통과합니다.

이 예제에서는 증가 동작으로 카운트가 0에서 1로 올라가야 합니다.

import ComposableArchitecture
import XCTest

func testIncrement() async {
    let store = await TestStore(initialState: CounterFeature.State()) {
        CounterFeature()
    }
    await store.send(.incrementTapped) {
        $0.count = 1
    }
}

철저한 검사

기본적으로 TestStore는 철저하게 검사합니다. 모든 상태 변경과 효과가 다시 전달하는 모든 동작을 빠짐없이 처리해야 합니다. 처리되지 않은 변경이 있으면 테스트가 실패하므로, 검증이 실제 동작과 일치하는지 확인할 수 있습니다.

집중적인 테스트를 위해 store.exhaustivity = .off로 이 설정을 완화할 수 있습니다.

import ComposableArchitecture

// Exhaustive (default): every change must be asserted.
// Relax when you only care about part of the behavior:
store.exhaustivity = .off

효과 동작 받기

효과가 동작을 다시 보내면 테스트에서 해당 동작을 receive하고 그에 따른 상태를 검증해야 합니다. 이를 통해 비동기 흐름이 처음부터 끝까지 제대로 작동하는지 확인할 수 있습니다.

이 예제에서는 새로 고침이 응답을 발생시키고, 테스트가 이를 기다린 다음 확인합니다.

import ComposableArchitecture
import XCTest

func testReload() async {
    let store = await TestStore(initialState: NumberFeature.State()) {
        NumberFeature()
    }
    await store.send(.reload)
    await store.receive(\.response) {
        $0.value = 42
    }
}

테스트에서 의존성 재정의하기

효과를 결정론적으로 만들려면 TestStore를 생성할 때 의존성을 재정의합니다. 가짜 클라이언트나 테스트용 시계를 제공하면 결과를 예측할 수 있습니다.

이 예제에서는 숫자 클라이언트를 항상 42를 반환하는 클라이언트로 교체합니다.

import ComposableArchitecture
import XCTest

func testReload() async {
    let store = await TestStore(initialState: NumberFeature.State()) {
        NumberFeature()
    } withDependencies: {
        $0.numberClient.fetch = { 42 }
    }
    await store.send(.reload)
    await store.receive(\.response) { $0.value = 42 }
}

구성된 기능 테스트하기

구성에서는 상태와 동작이 중첩되므로, 부모 케이스로 감싼 자식 동작을 보내 부모를 테스트합니다. 동일한 철저한 검증을 적용해 전체 트리를 확인할 수 있습니다.

이 예제에서는 부모가 범위를 통해 카운터 증가 동작을 받습니다.

import ComposableArchitecture
import XCTest

func testChildInParent() async {
    let store = await TestStore(initialState: AppFeature.State()) {
        AppFeature()
    }
    await store.send(.counter(.incrementTapped)) {
        $0.counter.count = 1
    }
}

빠른 확인: TestStore 동작

기본 TestStore가 검증에 요구하는 사항을 떠올려 보세요.

복습: 구성과 테스트

TCA 도구 모음을 완성했습니다.

Scope는 부모 상태와 동작의 일부에 자식 리듀서를 실행하며, 하나의 body에서 여러 리듀서를 결합할 수 있습니다.
store.scope는 자식 뷰에 자식 전용 저장소를 전달합니다.
TestStore는 send로 동작을 보낼 때 정확한 상태 변경을 검증합니다.
기본적으로 철저하게 검사하며, 효과가 발생시킨 동작에는 receive를 사용합니다.
결정론적인 테스트를 위해 withDependencies로 의존성을 재정의합니다.

이제 The Composable Architecture를 사용해 기능을 만들고 구성하며 엄격하게 테스트할 수 있습니다.

import ComposableArchitecture

// Recap: Scope to compose, TestStore to verify.
// Exhaustive assertions + injected fakes = confidence.

자주 묻는 질문

“기능 조합과 테스트” 강의는 무료인가요?

네 — “기능 조합과 테스트” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Swift Academy 강의 전체를 잠금 해제할 수 있습니다. Swift Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“기능 조합과 테스트”에서 뭘 배우나요?

리듀서를 결합하고 모든 경우를 철저히 테스트합니다. 브라우저에서 직접 실행하는 실습 코드로 Swift Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Swift Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Swift Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.

“기능 조합과 테스트” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Swift Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Swift Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Swift Academy(으)로 돌아가기