State Management on jHoon

Ch05-6. 아키텍처와 상태관리 총정리 - 정답은 없고 차이만 있다

Sun, 03 May 2026 02:00:00 +0900

Ch05 시리즈를 통해 같은 Todo 앱을 ValueNotifier → GetX → BLoC → Riverpod → Hooks까지 5가지 방식으로 다뤄봤다. 강의 마지막에 “그래서 뭘 써야 하나"에 대한 총정리가 나왔는데, 여기에 내 생각도 섞어서 정리한다.

왜 아키텍처를 고민하는가

많은 개발자들이 앱의 아키텍처를 궁금해하고, 어떻게 해야 좋은지 고뇌한다. 내 생각은 결국 쉬운 구조를 위해서가 아닐까 싶다.

그 “쉬운 구조"를 판단하는 기준은 크게 5가지로 나눌 수 있다.

1. 쉬운 개발

가장 직관적인 기준이다.

구조 파악이 쉬운가 — 코드를 처음 보는 사람도 흐름을 빠르게 이해할 수 있는가
작성하는 코드의 양이 적은가 — 보일러플레이트가 적을수록 생산성이 올라간다
가독성이 좋은가 — 6개월 뒤의 내가 봐도 바로 이해되는가

Ch05에서 직접 체감한 걸 돌아보면:

방식	보일러플레이트	진입 장벽	구조 파악
ValueNotifier	중간	낮음	쉬움
GetX	적음	낮음	쉬움
BLoC	많음	높음	Event 따라가면 명확
Riverpod	적음	중간	Provider 단위로 명확
Hooks + Riverpod	적음	중간	역할 분리 깔끔

BLoC은 Event/State/Bloc 클래스를 다 만들어야 하니까 코드량이 확실히 많다. 근데 그 대신 “이 이벤트가 이 상태를 바꾼다"가 명확해서 대규모 팀에서는 오히려 파악이 쉬울 수 있다. 결국 “쉬움"의 기준도 상황마다 다르다.

2. 안정성

여기서 말하는 안정성은 “앱이 잘 돌아가느냐"가 아니다.

일반적으로 코드를 짜면 코딩한 대로 동작하기 마련이다. 어떤 아키텍처를 쓰든, 어떤 상태관리를 쓰든, 출시 전에 개발자와 테스터가 테스트를 마치고 앱이 나가기 때문에 작동하지 않는 경우는 없다. 이런 관점에서는 모두 안정적이고 차이가 거의 없다.

여기서 말하는 안정성은 Test Code를 작성할 수 있는가다.

스펙이 변경되고 그에 따른 수정을 할 때, 예상하지 못한 버그가 일어나는 걸 최소화하려면 테스트 코드가 필요하다. 새 기능을 추가했는데 기존 기능이 깨지는 걸 사전에 잡아내는 것. 이게 진짜 안정성이다.

방식	테스트 용이성	이유
GetX (Static)	어려움	전역 상태라 격리가 힘듦
BLoC (Scoped)	좋음	Event 입력 → State 출력 검증이 깔끔
Riverpod (Scoped)	좋음	ProviderScope로 격리, override로 mock 주입
ValueNotifier (Scoped)	보통	가능하지만 편의 기능이 적음

3. 성능

사실 성능은 일반적인 모바일 앱에서는 거의 동일하다.

약 500만 번 정도의 연산이 일어나야 120Hz 렌더링을 방해할 수 있다 (애니메이션 예제 기준)
코드를 잘못 짜서 상호참조나 무한루프를 만드는 게 아닌 이상, 성능 차이를 체감하기는 어렵다
Flutter 자체가 **C 레벨의 네이티브(Skia/Impeller)**로 렌더링하기 때문에 성능이 워낙 좋다

물론 위젯 트리 구조대로 필요한 곳만 빌드하게 해서 성능을 최적화할 수는 있다. const 위젯이나 Consumer/BlocBuilder 같은 걸로 리빌드 범위를 줄이는 식으로.

하지만 배터리 타임이나 CPU 타임에 영향을 줄 정도로 아키텍처나 상태관리 패키지가 차이를 만들지는 않는다. 아키텍처 선택이 성능을 좌우한다는 건 사실상 미신이다.

4. 확장성

스펙이 바뀌거나 기능이 추가될 때, 기존 아키텍처가 유지되는 게 베스트다.

새 화면 추가할 때 기존 구조를 건드리지 않아도 되는가
상태 하나 추가할 때 수정 범위가 해당 모듈 안에서 끝나는가
팀원이 늘어나도 각자 독립적으로 작업할 수 있는가

Scoped 방식(BLoC, Riverpod)은 Provider/Bloc 단위로 관심사가 나뉘어 있어서 확장할 때 기존 코드를 건드릴 일이 적다. GetX도 Controller 단위로 나누면 되지만, 전역 접근이 가능하다는 특성상 의도치 않은 의존성이 생길 수 있다.

5. 제공되는 추가 기능들

각 패키지마다 별도로 제공하는 기능들이 있고, 이것도 선택에 영향을 준다.

패키지	특화 기능
GetX	라우팅, 다이얼로그, 스낵바, 다국어 — 올인원
BLoC	BlocObserver (Event 로깅), bloc_test
Riverpod	`.when` (비동기 분기), `family` (키 기반 상태), `@riverpod` 코드 생성
Hooks	Controller 자동 dispose, Custom Hook 재사용

GetX는 상태관리 외에도 네비게이션, UI 유틸리티까지 한 패키지에 들어있다. BLoC은 이벤트 추적에 강하다. Riverpod은 비동기 처리가 압도적이다. 프로젝트에서 어떤 기능이 중요한지에 따라 선택이 달라진다.

정답은 없다, 차이만 있다

아키텍처와 상태관리는 맞고 틀리고의 정답이 없다. ‘차이점’만 존재한다.

5가지 기준을 한눈에 정리하면:

기준	GetX	BLoC	Riverpod
쉬운 개발	쉬움	보일러플레이트 많음	적당함
안정성 (테스트)	격리 어려움	Event/State 검증 용이	override로 mock 주입
성능	동일	동일	동일
확장성	전역이라 의존성 주의	Bloc 단위 분리	Provider 단위 분리
추가 기능	올인원	Event 로깅	`.when`, `family`

Scoped vs Static — 접근성 다시 보기

Ch04에서 Scoped Model과 Static Model을 다뤘었다. 실제로 써보고 나니 “접근"에 대한 생각이 좀 바뀌었다.

모델	상태 접근 방식	대표
Scoped	`context.read()` (BLoC), `ref.read()` (Riverpod)	BLoC, Riverpod
Static	`Get.find()` — 어디서나 접근	GetX

Static이 언뜻 보면 쉬워 보인다. context니 ref니 하는 참조 엘리먼트를 안 써도 되니까. 하지만 실무적으로 살짝 불편할 뿐, 구조적으로는 접근에 문제가 없다.

애초에 앱을 실행시키는 main 함수에서 앱 객체를 만들 때부터 코드에서는 context와 ref를 참조할 수 있다. initState나 afterFirstLayout에서 context 접근이 가능하고, Riverpod은 ConsumerWidget만 쓰면 ref로 필요한 접근이 다 된다.

그렇기 때문에 “접근” 자체는 정말 사소하게 불편할 뿐, 참조를 연결만 한다면 구조적으로 언제나 접근이 된다고 봐도 무방하다.

진짜 차이가 나는 건 Widget Tree에 기반한 설계다.

Scoped 방식(BLoC, Riverpod)은 위젯 트리 위치에 따라 상태의 범위가 자연스럽게 정해진다. 화면이 닫히면 해당 스코프의 상태도 자동으로 정리된다.

GetX로 같은 걸 하려면 직접 구조를 구현해야 한다. 이전 블로그에서 다뤘듯이 임시 ID(tag)를 부여해서 관리해야 하는데, 해당 트리에 해당되는 위젯 생성자에 ID를 매번 전달하거나, InheritedWidget을 직접 구현해야 한다. 메모리 관리도 따로 해줘야 해서 오히려 더 불편해진다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


// Riverpod: 스코프가 자연스럽게 관리됨
ProviderScope(
 overrides: [commentProvider.overrideWith(() => CommentNotifier(videoId: id))],
 child: CommentSection(),
)
// 화면 닫히면 자동 정리

// GetX: tag로 직접 관리해야 함
Get.put(CommentController(videoId: id), tag: id);
// ...
Get.delete<CommentController>(tag: id); // 직접 정리

4가지 방식 최종 비교

Ch05 전체를 통해 같은 Todo 앱을 돌려본 결과:

	ValueNotifier	GetX	BLoC	Riverpod
모델	Scoped (내장)	Static	Scoped	Scoped
상태 변경	`notifyListeners()`	`.obs` 자동	`emit()`	`state =` 재할당
UI 구독	`ValueListenableBuilder`	`Obx`	`BlocBuilder`	`ref.watch`
비동기 분기	직접 처리	직접 처리	직접 처리	`.when` 자동
보일러플레이트	중간	적음	많음	적음
추적성	낮음	낮음	높음	중간
메모리 관리	자동	수동	자동	자동
테스트	보통	어려움	좋음	좋음
접근 방식	`context`	`Get.find()`	`context`	`ref`

여기에 Hooks를 더하면 로컬 UI 상태(useState, useTextEditingController)는 Hooks가, 공유 비즈니스 상태는 Riverpod이 맡아서 역할 분리가 깔끔해진다.

공부법에 대한 생각

Flutter를 공부해보니 몇 개월, 몇 년 이상 공부한 사람들은 패키지, 아키텍처, 상태관리 관련해서 블로그나 유튜브 등을 찾아보면서 시간을 꽤 많이 쓰지 않았을까 싶다. 물론 좋은 방향이지만, 너무 알아보고 너무 살펴보는 데 많은 시간을 쏟는다면 조금은 낭비가 아닐까 조심스레 생각해본다.

필자의 성격은 새로운 하나를 접하면(개발 외 모든 분야) A에서 Z까지 파보는 성격이다. 처음 개발을 접할 때도 그렇게 공부했다가 몇 달 만에 번아웃이 와버렸다.

이번에 Flutter를 새로 공부하면서 그 습관은 버리고, 직접 프로젝트에 적용해 가며 안 되는 것들을 찾아가고, 이를 해결하기 위해 직접 코드를 구현하거나 다른 패키지들을 도입해보면서 해결할 수 있는 능력을 길렀다. 해보지도 않고 이론에만 시간 쏟는 것보다 와닿는 게 훨씬 빨랐다.

물론 매우 주관적인 의견일 수 있다. 하지만 적어도 나한테는 이 방법이 맞았다:

일단 만들어본다 — Todo 앱 하나를 4가지 방식으로 전환해본 게 블로그 10개 읽는 것보다 나았다
안 되는 걸 찾아본다 — 필요할 때 찾아보는 게 기억에 남는다
비교는 직접 해본 뒤에 — 써보지도 않고 “BLoC vs Riverpod” 비교 글만 읽으면 감이 안 온다

마무리

앞으로 많은 프로젝트를 할 예정이고, 현재 운영 중인 iOS 네이티브 앱을 Flutter로 전환하는 계획도 있다. 상태관리, 아키텍처, 각종 패키지 등 프로젝트 상황에 맞게 잘 적용해보자.

Ch05 시리즈를 한 문장으로 정리하면:

아키텍처와 상태관리는 정답이 없다. 차이점만 있을 뿐이다. 직접 써보고 프로젝트에 맞는 걸 고르자.

Ch05-4. Todo 앱 Riverpod 전환 - 이게 진짜 사기다

Sat, 02 May 2026 00:00:00 +0900

Ch05 시리즈 마지막이다. BLoC에서 Riverpod으로 전환한다. 솔직히 BLoC의 Event 기반 구조가 MVI 느낌이라 꽤 마음에 들었는데, Riverpod 써보니까 생산성이 말이 안 된다. 뷰에서 상태별 분기가 .when 하나로 되고, BLoC에서 필요했던 Event 클래스, State 래퍼, Emitter 전달 같은 보일러플레이트가 싹 사라진다.

이 글의 코드는 flutter_riverpod 2.6.1 기준이다. 최신 Riverpod 3.0과의 차이점은 글 하단에 정리했다.

BLoC → Riverpod, 뭐가 바뀌나

영역	BLoC	Riverpod
상태 클래스	`Bloc<Event, State>` 상속	`StateNotifier<T>` 상속
이벤트	`sealed class TodoEvent` 별도 정의	없음. 메서드 직접 호출
State 래퍼	`@freezed TodoBlocState`	직접 `List<Todo>`
등록	`BlocProvider(create: ...)`	`StateNotifierProvider(...)` 전역 선언
UI 위젯	`StatelessWidget` + `BlocBuilder`	`ConsumerWidget`
접근	`context.read<TodoBloc>()`	`ref.read(provider.notifier)`
구독	`BlocBuilder<TodoBloc, TodoBlocState>`	`ref.watch(provider)`
상태 발행	`emit(state.copyWith(...))`	`state = newValue`

요약하면 BLoC에서 Event 클래스 + State 래퍼 + Emitter 패턴이 전부 사라지고, 직접 메서드 호출 + state 재할당으로 단순해진다.

StateNotifierProvider — 핵심 구조

Provider 선언 (전역)

1
2
3


final todoDataProvider =
 StateNotifierProvider<TodoDataHolder, List<Todo>>(
 (ref) => TodoDataHolder());

이게 끝이다. BLoC에서는 BlocProvider로 위젯 트리에 감싸야 했는데, Riverpod은 전역 변수처럼 선언한다. “provider가 전역으로 선언되었다고 데이터도 전역으로 같이 쓰는 게 아니다” — 이건 뒤에서 Scope로 설명한다.

StateNotifier 구현

 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


class TodoDataHolder extends StateNotifier<List<Todo>> {
 TodoDataHolder() : super(<Todo>[]);

 void addTodo() async {
 final result = await WriteTodoDialog().show();
 if (result != null) {
 state.add(
 Todo(
 id: DateTime.now().microsecondsSinceEpoch,
 title: result.text,
 dueDate: result.dateTime,
 ),
 );
 state = List.of(state); // 새 리스트로 재할당 → 리빌드 트리거
 }
 }

 void changeTodoStatus(Todo todo) async {
 switch (todo.status) {
 case TodoStatus.inComplete:
 todo.status = TodoStatus.onGoing;
 case TodoStatus.onGoing:
 todo.status = TodoStatus.complete;
 case TodoStatus.complete:
 final result = await ConfirmDialog('정말로 처음 상태로 변경하시겠어요?').show();
 result?.runIfSuccess((data) {
 todo.status = TodoStatus.inComplete;
 });
 }
 state = List.of(state);
 }

 void editTodo(Todo todo) async {
 final result = await WriteTodoDialog(todoForEdit: todo).show();
 if (result != null) {
 todo.title = result.text;
 todo.dueDate = result.dateTime;
 state = List.of(state);
 }
 }

 void removeTodo(Todo todo) {
 state.remove(todo);
 state = List.of(state);
 }
}

BLoC에서는 emit(state.copyWith(todoList: oldTodoList))로 새 State를 발행했는데, Riverpod에서는 state = List.of(state)로 직접 재할당한다. state에 새 값을 넣으면 구독 중인 위젯이 자동으로 리빌드된다.

BLoC과 비교하면:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


// BLoC: Event를 정의하고, 핸들러를 등록하고, Emitter로 발행
sealed class TodoEvent {}
class TodoAddEvent extends TodoEvent {}

class TodoBloc extends Bloc<TodoEvent, TodoBlocState> {
 TodoBloc() : super(...) {
 on<TodoAddEvent>(_addTodo); // 핸들러 등록
 }
 void _addTodo(TodoAddEvent event, Emitter<TodoBlocState> emit) {
 emit(state.copyWith(todoList: newList)); // Emitter로 발행
 }
}

// Riverpod: 그냥 메서드 쓰면 됨
class TodoDataHolder extends StateNotifier<List<Todo>> {
 void addTodo() {
 state = List.of(state); // state 재할당이 곧 발행
 }
}

Event 클래스 정의 → 핸들러 등록 → Emitter 전달 → emit 호출. 이 4단계가 state 재할당 한 줄로 줄었다.

Extension으로 접근 축약

1
2
3


extension TodoListHolderProvider on WidgetRef {
 TodoDataHolder get readTodoHolder => read(todoDataProvider.notifier);
}

ref.read(todoDataProvider.notifier).addTodo() 대신 ref.readTodoHolder.addTodo()로 쓸 수 있다. BLoC에서 context.readTodoBloc으로 축약했던 것과 같은 패턴이다.

ConsumerWidget — UI에서 사용

ProviderScope 설정

1
2
3
4
5
6
7
8
9


// s_main.dart
class MainScreenWrapper extends StatelessWidget {
 const MainScreenWrapper({super.key});

 @override
 Widget build(BuildContext context) {
 return const ProviderScope(child: MainScreen());
 }
}

ProviderScope은 Riverpod의 DI 컨테이너다. 이 안에 있는 위젯들이 Provider에 접근할 수 있다. BLoC의 BlocProvider와 같은 역할이지만, 여러 Provider를 개별적으로 감쌀 필요 없이 하나의 ProviderScope만 있으면 된다.

ConsumerWidget으로 구독

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


// w_todo_list.dart
class TodoList extends ConsumerWidget {
 const TodoList({super.key});

 @override
 Widget build(BuildContext context, WidgetRef ref) {
 final todoList = ref.watch(todoDataProvider); // 구독

 return todoList.isEmpty
 ? const Expanded(
 child: Center(
 child: Text('할 일을 작성해 보세요.',
 style: TextStyle(fontSize: 32)),
 ),
 )
 : Column(
 children: todoList.map((e) => TodoItem(e)).toList(),
 );
 }
}

BLoC에서는 BlocBuilder<TodoBloc, TodoBlocState> 위젯으로 감싸야 했는데, Riverpod은 ConsumerWidget을 상속하면 build 메서드에 WidgetRef ref가 들어온다. ref.watch(provider)로 구독하면 state가 바뀔 때마다 자동 리빌드된다.

ref.watch vs ref.read

 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


// w_todo_item.dart
class TodoItem extends ConsumerWidget {
 final Todo todo;

 const TodoItem(this.todo, {super.key});

 @override
 Widget build(BuildContext context, WidgetRef ref) {
 return Dismissible(
 key: ValueKey(todo.id),
 onDismissed: (direction) {
 ref.readTodoHolder.removeTodo(todo); // ref.read: 한 번 읽기
 },
 child: RoundedContainer(
 child: Row(
 children: [
 TodoStatusWidget(todo),
 Text(todo.title),
 const Spacer(),
 IconButton(
 onPressed: () {
 ref.readTodoHolder.editTodo(todo); // ref.read: 이벤트용
 },
 icon: const Icon(EvaIcons.editOutline),
 )
 ],
 ),
 ),
 );
 }
}

메서드	용도	리빌드
`ref.watch(provider)`	상태 구독 (UI 그릴 때)	O
`ref.read(provider.notifier)`	메서드 호출 (이벤트용)	X

BLoC의 context.watch / context.read와 정확히 같은 개념이다. 차이라면 BLoC은 context에서 꺼내고, Riverpod은 ref에서 꺼낸다.

ConsumerStatefulWidget

Rive 애니메이션처럼 lifecycle 메서드가 필요하면 ConsumerStatefulWidget을 쓴다:

 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


class TodoStatusWidget extends ConsumerStatefulWidget {
 final Todo todo;

 const TodoStatusWidget(this.todo, {super.key});

 @override
 ConsumerState<TodoStatusWidget> createState() => _TodoStatusWidgetState();
}

class _TodoStatusWidgetState extends ConsumerState<TodoStatusWidget> {
 // initState, dispose 등 lifecycle 사용 가능
 // ref도 사용 가능

 @override
 Widget build(BuildContext context) {
 return Tap(
 onTap: () {
 ref.readTodoHolder.changeTodoStatus(widget.todo);
 },
 child: SizedBox(
 width: 50,
 height: 50,
 child: switch (widget.todo.status) {
 TodoStatus.complete => Checkbox(value: true, onChanged: null),
 TodoStatus.inComplete => const Checkbox(value: false, onChanged: null),
 TodoStatus.onGoing => _riveReady
 ? RiveWidget(controller: _controller!, fit: Fit.cover)
 : const SizedBox(),
 },
 ),
 );
 }
}

위젯 타입	BLoC 대응	언제 쓰나
`ConsumerWidget`	`StatelessWidget` + `BlocBuilder`	단순 UI
`ConsumerStatefulWidget`	`StatefulWidget` + `BlocBuilder`	lifecycle 필요

ProviderScope — 스코프 개념

Provider가 전역으로 선언되었다고 데이터도 전역으로 같이 쓰는 게 아니다. ProviderScope으로 나눠주면 별도의 데이터를 가지게 된다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


// 같은 Provider인데 Scope가 다르면 다른 데이터
ProviderScope(
 overrides: [todoDataProvider.overrideWith(() => TodoDataHolder())],
 child: ScreenA(), // 이 안에서는 독립된 TodoDataHolder
)

ProviderScope(
 overrides: [todoDataProvider.overrideWith(() => TodoDataHolder())],
 child: ScreenB(), // 여기도 독립된 TodoDataHolder
)

Ch04에서 다뤘던 Scoped Model의 진짜 실현이다. BLoC에서는 BlocProvider를 위젯 트리 특정 위치에 넣어서 스코프를 만들었는데, Riverpod은 ProviderScope의 overrides로 더 유연하게 스코프를 지정할 수 있다.

유튜브 앱에서 영상마다 다른 댓글 리스트를 보여줘야 한다면:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


// BLoC: 각 화면에 BlocProvider를 별도로 감싸야 함
BlocProvider(
 create: (_) => CommentBloc(videoId: 'abc123'),
 child: CommentSection(),
)

// Riverpod: ProviderScope로 override
ProviderScope(
 overrides: [commentProvider.overrideWith(() => CommentNotifier(videoId: 'abc123'))],
 child: CommentSection(),
)

사실 결과적으로 비슷하지만, Riverpod은 Provider 선언이 전역이니까 어떤 Provider들이 있는지 한눈에 파악이 된다. BLoC은 각 화면의 BlocProvider를 찾아다녀야 한다.

FutureProvider — 비동기 상태의 끝판왕

Todo 앱에서는 안 썼지만, 실제 앱을 만들면 API 호출이 필수다. 여기서 Riverpod의 진가가 나온다.

기본 사용법

1
2
3
4


final userProvider = FutureProvider<User>((ref) async {
 final response = await http.get(Uri.parse('https://api.com/user'));
 return User.fromJson(jsonDecode(response.body));
});

이걸 뷰에서 쓰면:

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


class UserPage extends ConsumerWidget {
 @override
 Widget build(BuildContext context, WidgetRef ref) {
 final userAsync = ref.watch(userProvider);

 return Scaffold(
 body: Center(
 child: userAsync.when(
 loading: () => CircularProgressIndicator(),
 error: (e, _) => Text('에러: $e'),
 data: (user) => Text(user.name),
 ),
 ),
 );
 }
}

.when 하나로 로딩/에러/데이터 분기가 끝난다. 세 가지 상태를 빠뜨릴 수가 없어서 안전하기도 하다. Swift에서 비슷하게 하려면:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


// Swift - 직접 분기 처리
var body: some View {
 if isLoading {
 ProgressView()
 } else if let error {
 Text("에러: \(error)")
 } else if let user {
 Text(user.name)
 }
}

이걸 .when 하나로 끝내는 거다.

화면 일부만 분기하기

.when이 화면 전체를 교체하는 것만은 아니다. 부분에도 쓸 수 있다:

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


Scaffold(
 appBar: AppBar(title: Text('마이페이지')), // 고정
 body: Column(
 children: [
 Text('항상 보이는 영역'), // 고정

 // 이 부분만 로딩/에러/데이터 처리
 ref.watch(userProvider).when(
 loading: () => CircularProgressIndicator(),
 error: (e, _) => Text('로드 실패'),
 data: (user) => UserCard(user: user),
 ),

 Text('여기도 항상 보임'), // 고정
 ],
 ),
)

프로필 페이지, 상품 목록, 검색 결과 같은 데서 엄청 자주 쓰는 패턴이다. loading이나 error 분기에도 커스텀 위젯을 자유롭게 넣을 수 있다:

1
2
3
4
5
6
7
8


ref.watch(userProvider).when(
 loading: () => ShimmerSkeleton(), // 스켈레톤 UI
 error: (e, _) => ErrorRetryWidget(
 message: '불러오기 실패',
 onRetry: () => ref.invalidate(userProvider), // 재시도
 ),
 data: (user) => UserProfileCard(user: user),
)

ref.listen — 오버레이 로딩

.when은 화면의 특정 영역을 교체하는 방식이다. 기존 화면 위에 오버레이로 로딩을 띄우고 싶다면 ref.listen을 쓴다:

 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


class LoginPage extends ConsumerWidget {
 @override
 Widget build(BuildContext context, WidgetRef ref) {
 // 상태 변화를 '듣고' 오버레이 처리
 ref.listen(loginProvider, (prev, next) {
 if (next.isLoading) {
 showDialog(
 context: context,
 builder: (_) => Center(child: CircularProgressIndicator()),
 );
 } else {
 Navigator.of(context).pop(); // 로딩 닫기
 next.whenOrNull(
 error: (e, _) => ScaffoldMessenger.of(context)
 .showSnackBar(SnackBar(content: Text('실패: $e'))),
 data: (user) => Navigator.pushReplacement(...),
 );
 }
 });

 // 메인 UI는 그대로
 return Scaffold(
 body: Column(
 children: [
 TextField(...),
 ElevatedButton(
 onPressed: () => ref.read(loginProvider.notifier).login(),
 child: Text('로그인'),
 ),
 ],
 ),
 );
 }
}

상황	방식
화면 영역이 로딩/에러/데이터로 교체	`ref.watch` + `.when`
기존 화면 위에 오버레이 로딩	`ref.listen` + `showDialog`
데이터만 필요하고 로딩 무시	`.valueOrNull`

when은 화면 교체용, listen은 이벤트 반응용이다.

@riverpod — 코드 제너레이션

지금까지 StateNotifierProvider<TodoDataHolder, List<Todo>>((ref) => ...) 같은 긴 타입을 직접 썼는데, @riverpod을 쓰면 이 보일러플레이트도 자동 생성된다:

1
2
3
4
5
6
7
8
9


// @riverpod 방식: 함수 쓰듯이 로직만 짜면 끝
@riverpod
Future<User> user(ref) async {
 final response = await http.get(Uri.parse('https://api.com/user'));
 return User.fromJson(jsonDecode(response.body));
}

// build_runner 돌리면 userProvider가 자동 생성됨
// 뷰에서 ref.watch(userProvider).when(...) 으로 사용

알아야 하는 건 3개뿐이다:

@riverpod 붙이고 로직 짜기
build_runner 돌려서 코드 생성
뷰에서 ref.watch / ref.read로 사용

StateNotifierProvider<TodoNotifier, List<Todo>>((ref) => ...) 이런 보일러플레이트를 직접 안 짜도 된다. 요즘 새 프로젝트는 대부분 @riverpod 방식을 쓴다.

BLoC vs Riverpod 최종 비교

코드 비교

항목	BLoC	Riverpod
방식	Event → Bloc → State	직접 메서드 호출
이벤트 정의	`sealed class TodoEvent` + 하위 클래스 4개	없음
State 래퍼	`@freezed TodoBlocState` (BlocStatus 포함)	직접 `List<Todo>`
등록	`BlocProvider` (위젯 트리)	`StateNotifierProvider` (전역 선언)
UI 위젯	`BlocBuilder` 래퍼	`ConsumerWidget` 상속
상태 발행	`emit(state.copyWith(...))`	`state = newValue`
비동기 분기	직접 처리	`.when(loading, error, data)`
Event 추적	BlocObserver로 가능	직접 로깅 필요
보일러플레이트	많음	적음
스코프	BlocProvider 위치	ProviderScope overrides

같은 “Todo 삭제” 동작

 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


// BLoC: Event 정의 → 핸들러 등록 → Event dispatch
// 1. Event 정의
class TodoRemoveEvent extends TodoEvent {
 final Todo removedTodo;
 TodoRemoveEvent(this.removedTodo);
}

// 2. 핸들러 등록
on<TodoRemoveEvent>(_removeTodo);

// 3. 핸들러 구현
void _removeTodo(TodoRemoveEvent event, Emitter<TodoBlocState> emit) {
 final oldTodoList = List<Todo>.from(state.todoList);
 oldTodoList.removeWhere((e) => e.id == event.removedTodo.id);
 emit(state.copyWith(todoList: oldTodoList));
}

// 4. UI에서 dispatch
context.readTodoBloc.add(TodoRemoveEvent(todo));


// Riverpod: 메서드 하나
// 1. 메서드 구현
void removeTodo(Todo todo) {
 state.remove(todo);
 state = List.of(state);
}

// 2. UI에서 호출
ref.readTodoHolder.removeTodo(todo);

BLoC은 4단계, Riverpod은 2단계. 추적성 vs 생산성의 트레이드오프다.

언제 뭘 쓸까

상황	추천
대규모 팀 (10명+)	BLoC — Event 히스토리 추적, 팀 컨벤션 강제
소규모 팀 / 개인	Riverpod — 생산성, 적은 보일러플레이트
API 호출 많은 앱	Riverpod — `.when` 패턴이 압도적
Event 로깅 필수	BLoC — BlocObserver
프로토타입	Riverpod (또는 GetX)

2026년 기준으로 새 프로젝트는 대부분 Riverpod이 기본 선택이고, BLoC은 대규모 엔터프라이즈에서 쓰이는 추세다.

4가지 방식 총 비교

Ch05 전체를 통해 같은 Todo 앱을 4가지 방식으로 만들어봤다:

	ValueNotifier	GetX	BLoC	Riverpod
방식	Scoped (내장)	Static	Scoped	Scoped
상태 변경	`notifyListeners()`	`.obs` 자동	`emit()`	`state =` 재할당
UI 구독	`ValueListenableBuilder`	`Obx`	`BlocBuilder`	`ref.watch`
비동기 분기	직접 처리	직접 처리	직접 처리	`.when` 자동
보일러플레이트	중간	적음	많음	적음
추적성	낮음	낮음	높음	중간
메모리 관리	자동	수동	자동	자동

내가 느낀 점

BLoC의 Event 기반 구조가 사실상 Scope 역할을 하는 거라고 느꼈다. 어떤 이벤트가 어떤 상태를 바꾸는지 명확히 분리되니까. 근데 Riverpod은 Provider 단위로 관심사를 나누면서도 코드량이 훨씬 적다.

1
2
3
4


// 관심사 분리: Provider 단위로 나누면 됨
final todoDataProvider = StateNotifierProvider<TodoDataHolder, List<Todo>>(...);
final userProvider = FutureProvider<User>(...);
final settingsProvider = StateNotifierProvider<SettingsNotifier, Settings>(...);

젤 좋은 건 뷰에서 상태별 화면 분기가 .when 하나로 되는 점이다. 로딩/에러/데이터를 빠뜨릴 수 없게 강제하니까 안전하고, 각 분기에 아무 위젯이나 넣을 수 있으니까 커스텀도 자유롭다.

앱이 커져서 상태가 많아지면 Provider를 나누면 되고, Scope가 필요하면 ProviderScope의 overrides로 해결된다. 개인 프로젝트에서 쓴다면 Riverpod이 정답인 것 같다.

Riverpod 3.0 — 2025년 9월 기준 변경점

이 글에서 쓴 코드는 Riverpod 2.x 기반이다. 2025년 9월에 Riverpod 3.0이 나왔는데, 핵심 개념(ref.watch, ref.read, .when, ProviderScope)은 그대로고 보일러플레이트가 더 줄었다.

	Riverpod 2.x (이 글)	Riverpod 3.0
Provider 선언	`StateNotifierProvider<T, S>((ref) => ...)` 직접 작성	`@riverpod` 붙이면 자동 생성
상태 클래스	`StateNotifier<T>`	`Notifier<T>` (`StateNotifier` deprecated)
비동기	`FutureProvider` 별도 선언	`@riverpod Future<T>` 함수로 통일
Mutation	없음	`@mutation`으로 폼 제출/버튼 액션의 로딩/에러 자동 관리 (experimental)
AsyncValue	일반 클래스	`sealed class` — 패턴 매칭 시 빠뜨리면 컴파일 에러

3.0에서 가장 큰 변화는 StateNotifier가 Notifier로 대체된 것과, @riverpod 코드 제너레이션이 기본이 된 것이다:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


// 2.x: 직접 선언
final todoDataProvider = StateNotifierProvider<TodoDataHolder, List<Todo>>(
 (ref) => TodoDataHolder());

class TodoDataHolder extends StateNotifier<List<Todo>> {
 TodoDataHolder() : super([]);
 // ...
}

// 3.0: @riverpod + Notifier
@riverpod
class TodoDataHolder extends _$TodoDataHolder {
 @override
 List<Todo> build() => []; // 초기 상태

 void addTodo(Todo todo) {
 state = [...state, todo];
 }
}
// build_runner가 todoDataHolderProvider 자동 생성

Mutation API는 아직 experimental이라 API가 바뀔 수 있지만, 폼 제출 같은 액션의 로딩/성공/에러 상태를 자동으로 관리해주는 기능이다. 정식 출시되면 ref.listen으로 수동 처리하던 부분이 더 간결해질 예정이다.

Ch05-3. Todo 앱 BLoC + freezed 전환 - 이벤트 기반 상태관리

Fri, 01 May 2026 00:00:00 +0900

Ch05 시리즈 세 번째다. GetX에서 BLoC으로 전환한다. 핵심 변화는 2가지다: (1) 상태 변경을 Event로 제한하고, (2) Todo 모델을 freezed로 immutable하게 바꾸는 것. 코드량은 늘어나지만 “상태가 어디서 왜 바뀌었는지” 추적이 확실해진다.

BLoC이란

Business Logic Component. UI에서 Event를 보내면, Bloc이 처리해서 새로운 State를 내보내는 단방향 흐름이다.

1
2
3


[UI] --Event--> [Bloc] --State--> [UI]
 |
 비즈니스 로직

GetX에서는 todoData.addTodo(todo) 처럼 직접 메서드를 호출했다. BLoC에서는 bloc.add(TodoAddEvent()) 처럼 이벤트를 보낸다. 뷰에서는 호출만 하고, Bloc 내부에서 이벤트를 받아 해당하는 로직을 수행하고, 상태를 변경하면, BlocBuilder가 돌아간다.

차이가 뭐냐: 모든 상태 변경이 Event로 기록된다. 어떤 이벤트가 언제 발생했는지 로그로 추적할 수 있고, 디버깅이 쉬워진다. GetX는 “야 이거 바꿔"라고 직접 수정하는 거고, BLoC은 “이거 바꿔달라"는 요청서를 제출하는 거다.

Swift에서 TCA(The Composable Architecture)를 써봤다면 Action → Reducer → State 흐름과 거의 같은 패턴이다.

freezed로 불변 모델 만들기

mutable의 문제 (Ch05-2 복습)

GetX에서 Todo의 상태를 바꿀 때 이런 식이었다:

1
2
3


// GetX 시절: mutable 객체를 직접 수정
todo.status = TodoStatus.complete;
todoList.refresh(); // 수동 refresh 필요

문제점:

어디서 todo.status를 바꿨는지 추적 불가
refresh() 까먹으면 UI 안 바뀜
같은 Todo 인스턴스를 여러 곳에서 참조하면 의도치 않은 사이드 이펙트

freezed 적용

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


@freezed
class Todo with _$Todo {
 const factory Todo({
 required int id,
 required String title,
 required DateTime createdTime,
 DateTime? modifyTime,
 required DateTime dueDate,
 required TodoStatus status,
 }) = _Todo;
}

const factory로 선언하면 모든 필드가 final이 된다. 직접 수정이 불가능하다. 대신 copyWith로 새 인스턴스를 만들어야 한다.

1
2
3
4
5


// Before (mutable class)
todo.status = TodoStatus.complete; // 직접 수정

// After (freezed)
final newTodo = todo.copyWith(status: TodoStatus.complete); // 새 인스턴스 생성

Swift의 struct(value type)와 거의 같다. Swift에서는 struct가 기본 제공하는 ==, hashCode, copyWith(없지만 멤버와이즈 이니셜라이저가 비슷한 역할)를 Dart에서는 freezed가 코드 생성으로 만들어준다.

처음에는 좀 번거로웠다. 기존처럼 switch문으로 상태를 변경하고 할당시켜도 안 됐다. 내부에서 상태를 수정할 수 없으니까 copyWith로 별도 수정해줘야 한다. 근데 이 불편함이 안전함의 대가다.

BlocState도 freezed로

1
2
3
4
5
6
7
8
9


enum BlocStatus { initial, loading, success, error }

@freezed
class TodoBlocState with _$TodoBlocState {
 const factory TodoBlocState({
 required BlocStatus status,
 required List<Todo> todoList,
 }) = _TodoBlocState;
}

State에 BlocStatus를 포함시켜서 로딩/에러 상태도 관리할 수 있다. todoList와 status를 하나의 immutable State 객체로 묶었다.

build_runner로 코드 생성

1

flutter pub run build_runner build

이 명령어로 vo_todo.freezed.dart, todo_bloc_state.freezed.dart가 생성된다. copyWith, ==, hashCode, toString이 전부 자동으로 만들어진다.

Event 설계 — sealed class

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


sealed class TodoEvent {}

class TodoAddEvent extends TodoEvent {}

class TodoStatusUpdateEvent extends TodoEvent {
 final Todo updatedTodo;
 TodoStatusUpdateEvent(this.updatedTodo);
}

class TodoContentUpdateEvent extends TodoEvent {
 final Todo updatedTodo;
 TodoContentUpdateEvent(this.updatedTodo);
}

class TodoRemoveEvent extends TodoEvent {
 final Todo removedTodo;
 TodoRemoveEvent(this.removedTodo);
}

처음에는 abstract class로 했다가 sealed class로 바꿨다. sealed로 바꾸면 switch문에서 모든 이벤트를 빠짐없이 처리했는지 컴파일 타임에 체크해준다. 이벤트를 하나 추가했는데 핸들러를 안 만들면 컴파일 에러가 나니까 실수를 방지할 수 있다.

Swift의 enum + associated values와 거의 같은 역할이다:

1
2
3
4
5
6
7


// Swift equivalent
enum TodoAction {
 case add
 case updateStatus(Todo)
 case updateContent(Todo)
 case remove(Todo)
}

이벤트를 sealed class로 만드는 이유는 각 이벤트가 서로 다른 데이터를 가져야 할 때 유연하기 때문이다. TodoAddEvent는 데이터가 필요 없고(다이얼로그에서 받으니까), TodoRemoveEvent는 어떤 Todo를 삭제할지 알아야 하고, 이런 차이를 타입으로 표현할 수 있다.

TodoBloc — 핵심 로직

Bloc 클래스 구조

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


class TodoBloc extends Bloc<TodoEvent, TodoBlocState> {
 TodoBloc() : super(const TodoBlocState(
 status: BlocStatus.initial,
 todoList: <Todo>[],
 )) {
 on<TodoAddEvent>(_addTodo);
 on<TodoStatusUpdateEvent>(_changeTodoStatus);
 on<TodoContentUpdateEvent>(_editTodo);
 on<TodoRemoveEvent>(_removeTodo);
 }
}

super(initialState)로 초기 상태를 설정하고, on<EventType>(handler)로 각 이벤트별 핸들러를 등록한다. 이벤트가 들어오면 해당 핸들러가 실행되는 구조다.

추가

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


void _addTodo(TodoAddEvent event, Emitter<TodoBlocState> emit) async {
 final result = await WriteTodoDialog().show();
 if (result != null) {
 final oldTodoList = List.of(state.todoList);
 oldTodoList.add(
 Todo(
 id: DateTime.now().microsecondsSinceEpoch,
 title: result.text,
 dueDate: result.dateTime,
 createdTime: DateTime.now(),
 status: TodoStatus.inComplete,
 ),
 );
 emitNewList(oldTodoList, emit);
 }
}

핵심 패턴: List.of(state.todoList)로 기존 리스트를 복사 → 수정 → emit으로 새 State를 발행한다. BLoC에서는 add를 사용할 수 없기 때문에(state.todoList가 immutable) 새 List로 감싸서 조작해야 한다.

1
2
3


void emitNewList(List<Todo> oldTodoList, Emitter<TodoBlocState> emit) {
 emit(state.copyWith(todoList: oldTodoList));
}

emit을 호출하면 BLoC이 새 State를 내보내고, 구독 중인 BlocBuilder가 리빌드된다.

상태 전환 (가장 복잡한 부분)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


void _changeTodoStatus(TodoStatusUpdateEvent event, Emitter<TodoBlocState> emit) async {
 final oldTodoList = List.of(state.todoList);
 final todo = event.updatedTodo;
 final todoIndex = oldTodoList.indexWhere((e) => e.id == todo.id);

 TodoStatus status = todo.status;
 switch (todo.status) {
 case TodoStatus.inComplete:
 status = TodoStatus.onGoing;
 case TodoStatus.onGoing:
 status = TodoStatus.complete;
 case TodoStatus.complete:
 final result = await ConfirmDialog('정말로 처음 상태로 변경하시겠어요?').show();
 result?.runIfSuccess((data) {
 status = TodoStatus.inComplete;
 });
 }
 oldTodoList[todoIndex] = todo.copyWith(status: status);
 emitNewList(oldTodoList, emit);
}

GetX에서는 todo.status = status로 직접 수정했는데, BLoC에서는 todo.copyWith(status: status)로 새 인스턴스를 만들고, indexWhere로 찾아서 교체한다. immutable이라 기존 객체를 수정할 수 없으니까 새 객체로 대체하는 거다.

GetX에서 todoList.refresh()를 수동으로 호출해야 했던 문제가 여기서 사라진다. 새 리스트를 emit하면 BLoC이 자동으로 상태 변경을 감지한다.

삭제

1
2
3
4
5
6


void _removeTodo(TodoRemoveEvent event, Emitter<TodoBlocState> emit) {
 final oldTodoList = List<Todo>.from(state.todoList);
 final todo = event.removedTodo;
 oldTodoList.removeWhere((e) => e.id == todo.id);
 emitNewList(oldTodoList, emit);
}

수정

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


void _editTodo(TodoContentUpdateEvent event, Emitter<TodoBlocState> emit) async {
 final todo = event.updatedTodo;
 final result = await WriteTodoDialog(todoForEdit: todo).show();
 if (result != null) {
 final oldTodoList = List<Todo>.from(state.todoList);
 oldTodoList[oldTodoList.indexOf(todo)] = todo.copyWith(
 title: result.text,
 dueDate: result.dateTime,
 modifyTime: DateTime.now(),
 );
 emitNewList(oldTodoList, emit);
 }
}

UI에서 BLoC 사용

BlocProvider로 등록

1
2
3
4
5
6
7


// app.dart
BlocProvider(
 create: (BuildContext context) => TodoBloc(),
 child: MaterialApp(
 home: const MainScreen(),
 ),
)

InheritedWidget을 직접 만들 필요 없이 BlocProvider가 대신해준다. 내부적으로 InheritedWidget 기반이지만 보일러플레이트가 없다. GetX의 Get.put()과 비교하면, BlocProvider는 위젯이 dispose될 때 자동으로 Bloc도 close해준다. 메모리 관리를 신경 쓸 필요가 없다.

BlocBuilder로 구독

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


// w_todo_list.dart
BlocBuilder<TodoBloc, TodoBlocState>(
 builder: (context, state) {
 return state.todoList.isEmpty
 ? const Center(child: Text('할 일을 작성해 보세요.'))
 : Column(
 children: state.todoList.map((e) => TodoItem(e)).toList(),
 );
 },
)

state로 현재 상태 전체를 받는다. GetX의 Obx처럼 .obs 변수를 직접 접근하는 게 아니라, Bloc이 emit한 State 객체를 통해 데이터에 접근한다.

context.read vs context.watch

1
2
3
4
5


// context_extension.dart
extension ContextExtension on BuildContext {
 TodoBloc get readTodoBloc => read(); // 이벤트 보낼 때 (리빌드 안 함)
 TodoBloc get watchTodoBloc => watch(); // 상태 구독할 때 (리빌드 함)
}

read: 한 번 읽고 끝. 이벤트를 보낼 때 사용한다. 리빌드를 트리거하지 않는다.
watch: 상태 변경을 구독한다. State가 바뀌면 해당 위젯이 리빌드된다.

1
2
3
4
5
6


// 이벤트 보내기: read (리빌드 불필요)
context.readTodoBloc.add(TodoAddEvent());
context.readTodoBloc.add(TodoRemoveEvent(todo));
context.readTodoBloc.add(TodoStatusUpdateEvent(todo));

// 상태 구독: BlocBuilder 안에서 자동으로 처리

주로 이벤트를 보낼 때는 read, UI를 그릴 때는 BlocBuilder 안에서 state를 받아 쓴다.

실제 위젯에서 사용

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22


// w_todo_item.dart - 스와이프 삭제
Dismissible(
 key: ValueKey(todo.id),
 onDismissed: (direction) {
 context.readTodoBloc.add(TodoRemoveEvent(todo));
 },
 child: RoundedContainer(
 child: Row(
 children: [
 TodoStatusWidget(todo),
 Text(todo.title),
 const Spacer(),
 IconButton(
 onPressed: () {
 context.readTodoBloc.add(TodoContentUpdateEvent(todo));
 },
 icon: const Icon(EvaIcons.editOutline),
 )
 ],
 ),
 ),
)

1
2
3
4
5
6
7


// s_main.dart - FAB으로 추가
FloatingActionButton(
 onPressed: () {
 context.readTodoBloc.add(TodoAddEvent());
 },
 child: const Icon(EvaIcons.plus),
)

UI에서는 add(Event)로 이벤트를 보내기만 한다. 로직은 전부 Bloc 내부에 있다. 이게 관심사 분리다.

Rive 애니메이션 (보너스)

상태관리와 직접 관련은 없지만, Todo 상태가 onGoing일 때 Rive 애니메이션이 재생되는 게 꽤 재밌었다.

1
2
3
4
5
6
7


child: switch (widget.todo.status) {
 TodoStatus.complete => Checkbox(value: true, onChanged: null),
 TodoStatus.inComplete => const Checkbox(value: false, onChanged: null),
 TodoStatus.onGoing => _riveReady
 ? RiveWidget(controller: _controller!, fit: Fit.cover)
 : const SizedBox(),
}

Dart 3의 switch expression으로 상태별 위젯을 깔끔하게 분기한다. _cachedFile을 static으로 캐싱해서 .riv 파일을 한 번만 로드하는 것도 포인트다.

3가지 방식 최종 비교

코드 비교

항목	ValueNotifier	GetX	BLoC
방식	Scoped (내장)	Static	Scoped (패키지)
상태 객체	mutable	mutable	immutable (freezed)
변경 알림	`notifyListeners()` 수동	`.obs` 자동	`emit()`
UI 구독	`ValueListenableBuilder`	`Obx(() =>)`	`BlocBuilder`
등록	InheritedWidget 직접 구현	`Get.put()`	`BlocProvider`
접근	`of(context)`	`Get.find()`	`context.read/watch`
상태 변경	메서드 직접 호출	메서드 직접 호출	Event dispatch
추적성	낮음	낮음	높음 (Event 로깅)
보일러플레이트	중간	적음	많음
메모리 관리	위젯 트리 자동	개발자 직접	위젯 트리 자동

같은 “Todo 추가” 동작

1
2
3
4
5
6
7
8


// ValueNotifier
context.todoHolder.addTodo(todo);

// GetX
Get.find<TodoDataHolder>().addTodo(todo);

// BLoC
context.readTodoBloc.add(TodoAddEvent());

Swift/iOS 대응표

Flutter	Swift/iOS
ValueNotifier	`ObservableObject` + `@Published`
InheritedWidget	`@EnvironmentObject`
GetX (`.obs` + `Obx`)	`Combine` + `@Published` (싱글톤)
BLoC (Event → State)	TCA (`Action` → `Reducer` → `State`)
freezed	`struct` (value type)
sealed class	`enum` + associated value
BlocProvider	DI Container (Scoped)

어떤 걸 써야 하나

프로토타입/작은 앱 → GetX가 빠르다
중간 규모 → Provider나 Riverpod이 적당하다
대규모/팀 프로젝트 → BLoC이 Event 추적, 테스트 용이성에서 유리하다
Flutter 원리 학습 → ValueNotifier + InheritedWidget부터 이해하자

개인 프로젝트에서 정답은 없다. 트레이드오프를 이해하고 고르면 된다.

정리

Ch05 시리즈를 통해 같은 Todo 앱을 3가지 방식으로 만들어봤다. 어떤 방식이든 하는 일은 같다. 상태를 만들고, 변경하고, UI에 반영하는 것. 차이는 “변경을 얼마나 통제할 것인가”, “추적성을 얼마나 확보할 것인가"에 있다.

iOS 개발할 때도 RxSwift → Combine → TCA 순서로 더 구조화된 방향으로 흘러왔는데, Flutter에서도 비슷한 흐름을 체감했다. Ch04에서 이론을 정리하고 Ch05에서 실전을 해보니까 왜 상태관리가 중요한지 확실히 느꼈다.

Ch05-2. Todo 앱 GetX로 전환 - .obs와 Obx의 마법

Thu, 30 Apr 2026 00:00:00 +0900

Ch05-1에서 ValueNotifier + InheritedWidget으로 만든 Todo 앱을 GetX로 전환한다. Ch04에서 다뤘던 Static Model의 실전 적용 버전이다. 결론부터 말하면, 일일이 업데이트 걸어줄 필요 없이 심플하게 상태관리가 가능해진다. 근데 그 대가가 있다.

뭐가 바뀌나

바꾸는 곳은 정해져 있다. 상태 클래스, 등록, 구독, 접근. 이 4가지만 바꾸면 된다.

영역	Before (ValueNotifier)	After (GetX)
상태 클래스	`ValueNotifier` 상속	`GetxController` 상속
상태 변수	`List<Todo>` + `notifyListeners()`	`RxList<Todo>` (`.obs`)
UI 구독	`ValueListenableBuilder`	`Obx(() =>)`
등록	`InheritedWidget` 직접 구현	`Get.put()`
접근	`context.dependOn...`	`Get.find()`

.obs — 자동 변경 감지

변환 핵심

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


// Before: ValueNotifier
class TodoDataNotifier extends ValueNotifier<List<Todo>> {
 TodoDataNotifier() : super([]);

 void addTodo(Todo todo) {
 value.add(todo);
 notifyListeners(); // 수동 호출 필수!
 }
}

// After: GetX
class TodoDataHolder extends GetxController {
 final RxList<Todo> todoList = <Todo>[].obs;

 void addTodo(Todo todo) {
 todoList.add(todo);
 // notifyListeners 불필요! .obs가 변경을 자동 감지
 }
}

핵심 차이는 .obs다. .obs를 붙이면 Rx<T> 타입으로 래핑되면서, add, remove, []= 같은 List 조작을 전부 intercept한다. 변경이 생기면 자동으로 구독자에게 알림을 보내기 때문에 ValueNotifier에서 notifyListeners() 까먹어서 UI가 안 바뀌는 버그가 사라진다.

다양한 타입에 .obs

1
2
3
4


final count = 0.obs; // RxInt
final name = ''.obs; // RxString
final items = <Todo>[].obs; // RxList<Todo>
final user = User().obs; // Rx<User>

기본 타입은 .value로 접근하고, List는 직접 메서드를 호출할 수 있다. Swift에서 @Published가 프로퍼티 단위로 감시하는 것과 비슷한데, .obs는 변수 단위로 감시한다.

같은 값이면 리빌드 안 함

1
2
3


final count = 0.obs;
count.value = 0; // 같은 값 → Obx 리빌드 안 함
count.value = 1; // 다른 값 → Obx 리빌드

ValueNotifier의 notifyListeners()는 값이 같아도 무조건 알림을 보내는데, GetX는 내부적으로 이전 값과 비교해서 불필요한 리빌드를 막아준다.

Obx — 반응형 UI 빌더

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


// Before: ValueListenableBuilder
ValueListenableBuilder<List<Todo>>(
 valueListenable: todoNotifier,
 builder: (context, todoList, child) {
 return Column(
 children: todoList.map((e) => TodoItem(e)).toList(),
 );
 },
)

// After: Obx
Obx(() => Column(
 children: todoDataHolder.todoList.map((e) => TodoItem(e)).toList(),
))

Obx가 내부에서 어떤 .obs 변수를 읽었는지 자동으로 추적한다. 해당 변수가 바뀌면 Obx 블록만 리빌드된다. SwiftUI에서 @Published 프로퍼티가 바뀌면 body가 리빌드되는 것과 같은 원리인데, Obx 단위로 범위를 좁힐 수 있어서 더 세밀한 제어가 가능하다.

코드량으로만 보면 ValueListenableBuilder 대비 거의 반으로 줄었다. builder 패턴의 보일러플레이트가 사라진 게 크다.

InheritedWidget 제거 — Get.put / Get.find

등록

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


// Before: InheritedWidget으로 위젯 트리 감싸기
TodoDataHolder(
 notifier: TodoDataNotifier(),
 child: MaterialApp(
 home: const MainScreen(),
 ),
)

// After: Get.put 한 줄
@override
void initState() {
 super.initState();
 Get.put(TodoDataHolder());
}

InheritedWidget 클래스를 만들고, 위젯 트리에 감싸고, of(context) 패턴을 구현하는 보일러플레이트가 전부 사라진다. Get.put() 한 줄이면 끝이다.

접근

1
2
3
4
5


// Before: context 필요
context.todoHolder.addTodo(todo);

// After: context 불필요
Get.find<TodoDataHolder>().addTodo(todo);

Get.find()로 어디서든 접근할 수 있다. context가 필요 없으니까 StatelessWidget이든, 일반 클래스든, 어디서든 상태에 접근 가능하다.

mixin으로 더 축약할 수도 있다:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


mixin TodoDataProvider {
 TodoDataHolder get todoData => Get.find<TodoDataHolder>();
}

// 사용
class SomeWidget extends StatelessWidget with TodoDataProvider {
 @override
 Widget build(BuildContext context) {
 todoData.addTodo(todo); // 깔끔
 }
}

상태 변경 로직 — mutable의 함정

추가, 삭제

1
2
3
4
5
6
7
8
9


void addTodo(Todo todo) {
 todoList.add(todo);
 // 끝. RxList가 자동으로 감지한다.
}

void removeTodo(Todo todo) {
 todoList.remove(todo);
 // 역시 자동.
}

List의 add, remove는 RxList가 감지해서 자동으로 UI가 갱신된다.

상태 전환 — refresh()가 필요한 순간

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


void changeTodoStatus(Todo todo) async {
 switch (todo.status) {
 case TodoStatus.inComplete:
 todo.status = TodoStatus.onGoing;
 case TodoStatus.onGoing:
 todo.status = TodoStatus.complete;
 case TodoStatus.complete:
 final result = await ConfirmDialog('정말로 처음 상태로 변경하시겠어요?').show();
 result?.runIfSuccess((data) {
 todo.status = TodoStatus.inComplete;
 });
 }
 todoList.refresh(); // 이거 없으면 UI 안 바뀜!
}

여기서 함정이 하나 있다. todo.status를 직접 바꾸면 Todo 객체의 프로퍼티만 변경되고, List 자체는 변경이 없다. RxList 입장에서는 “List에 아무 변화 없는데?“라고 판단하기 때문에 refresh()를 수동으로 호출해야 한다.

mutable 객체를 직접 수정할 때 생기는 문제다. ValueNotifier에서 notifyListeners()를 수동으로 호출해야 했던 것과 본질적으로 같은 문제가 형태만 바뀌어서 다시 등장한 거다.

수정도 마찬가지

1
2
3
4
5
6


void editTodo(Todo todo, WriteTodoResult result) {
 todo.title = result.text;
 todo.dueDate = result.dateTime;
 todo.modifyTime = DateTime.now();
 todoList.refresh(); // 수동 refresh
}

GetX의 편리함과 위험성

코드량 비교

항목	ValueNotifier + InheritedWidget	GetX
상태 클래스	ValueNotifier 상속 + InheritedWidget 별도 클래스	GetxController 하나
등록	InheritedWidget 래퍼로 위젯 트리 감싸기	`Get.put()` 한 줄
구독	`ValueListenableBuilder` (builder 패턴)	`Obx(() =>)`
변경 알림	`notifyListeners()` 수동	`.obs` 자동
접근	`context.dependOnInheritedWidgetOfExactType`	`Get.find()`

확실히 코드량은 GetX가 압도적으로 적다.

근데 왜 GetX를 안 쓰는 프로젝트가 있을까?

Ch04에서 다뤘던 Static Model의 위험성이 그대로 적용된다:

Get.find()로 어디서든 접근/수정 가능 → 상태 변경 추적이 어려움
메모리 관리를 개발자가 직접 → Get.delete() 안 하면 메모리 누수
mutable 상태 + 전역 접근 → 디버깅 지옥이 될 수 있음

iOS 개발할 때 싱글톤 패턴의 교훈과 정확히 같다. AppState.shared.user = newUser를 아무 데서나 부르면 어디서 바뀌었는지 추적이 안 되는 것처럼, GetX의 Get.find()도 어디서든 상태를 수정할 수 있기 때문에 같은 문제가 생긴다.

Swift 커뮤니티가 싱글톤에서 DI(의존성 주입)로 이동한 것처럼, Flutter 커뮤니티에서도 GetX에서 Scoped 방식(Provider, BLoC, Riverpod)으로 이동하는 추세가 있다. 물론 작은 앱이나 프로토타이핑에는 GetX가 여전히 최고의 선택이다.

정리

개념	ValueNotifier	GetX
방식	Scoped (내장)	Static (패키지)
변경 알림	`notifyListeners()` 수동	`.obs` 자동
UI 구독	`ValueListenableBuilder`	`Obx(() =>)`
등록/접근	InheritedWidget / `of(context)`	`Get.put()` / `Get.find()`
context 필요	필요	불필요
메모리 관리	위젯 트리가 자동 해제	개발자가 직접 `Get.delete()`

GetX는 확실히 편하다. notifyListeners() 안 불러도 되고, InheritedWidget 만들 필요도 없다. 근데 mutable 객체의 refresh() 함정이 있고, 앱이 커지면 상태 추적이 힘들어진다. 다음 Ch05-3에서는 BLoC으로 전환한다. Event-driven 구조가 이 추적 문제를 어떻게 해결하는지, 그리고 mutable Todo를 freezed로 immutable하게 만들면 refresh() 같은 함정이 어떻게 사라지는지 비교해보자.

Ch05-1. Todo 앱으로 상태관리 입문 - ValueNotifier + InheritedWidget

Wed, 29 Apr 2026 00:00:00 +0900

Ch04에서 상태관리의 역사와 Scoped vs Static을 다뤘으니, 이제 실전이다. Todo 앱 하나를 만들고, 같은 앱을 3가지 상태관리 방식으로 리팩토링하는 시리즈다. 첫 번째는 Flutter 내장 도구만 쓴다. 외부 패키지 없이 원리부터 이해하는 게 목적이다.

Todo 앱 구조

먼저 전체 프로젝트 구조를 보자.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


lib/
├── app.dart // 앱 진입점
├── data/
│ └── memory/
│ ├── vo_todo.dart // Todo 모델
│ ├── todo_status.dart // 상태 enum
│ ├── todo_data_notifier.dart // ValueNotifier
│ └── todo_data_holder.dart // InheritedWidget
├── screen/
│ └── main/
│ ├── s_main.dart // 메인 화면 (탭 네비게이션)
│ ├── todo/
│ │ ├── f_todo.dart // Todo 탭 전체
│ │ ├── w_todo_list.dart // 리스트 위젯
│ │ ├── w_todo_item.dart // 개별 아이템
│ │ └── w_todo_status.dart // 상태 표시 (Rive 애니메이션)
│ └── write/
│ ├── d_write_todo.dart // 추가/수정 다이얼로그
│ └── vo_write_result.dart

파일 이름에 접두어가 붙는다. s_는 screen, f_는 fragment, w_는 widget, d_는 dialog, vo_는 value object. iOS에서 ViewController, ViewModel 같은 네이밍 컨벤션과 비슷한 느낌이다.

Todo 모델

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


class Todo {
 int id;
 String title;
 final DateTime createdTime;
 DateTime? modifyTime;
 DateTime dueDate;
 TodoStatus status;

 Todo({
 required this.id,
 required this.title,
 required this.dueDate,
 this.status = TodoStatus.inComplete,
 }) : createdTime = DateTime.now();
}

그냥 평범한 mutable class다. id, title, dueDate, status를 가지고 있고, 직접 프로퍼티를 수정할 수 있다. Swift로 치면 class(reference type)에 var 프로퍼티들을 쓴 거다. 나중에 Ch05-3에서 이걸 freezed로 immutable하게 바꾸면 뭐가 달라지는지 비교할 예정이다.

1
2
3
4
5


enum TodoStatus {
 inComplete,
 onGoing,
 complete,
}

상태 흐름은 inComplete → onGoing → complete 순서다. complete에서 한 번 더 누르면 확인 다이얼로그가 뜨고, 승인하면 다시 inComplete로 돌아간다.

UI 위젯들

UI는 간단하게 넘어가자. 핵심만 보면:

MainScreen: 하단 탭 네비게이션 + FloatingActionButton으로 할 일 추가
TodoItem: Dismissible 위젯으로 스와이프 삭제 지원. SwiftUI의 .swipeActions와 같은 역할인데, Flutter는 위젯 자체가 스와이프를 지원해서 편하다
TodoStatusWidget: 상태에 따라 체크박스 표시. onGoing일 때는 Rive 애니메이션이 재생된다
WriteTodoDialog: 할 일 추가/수정 다이얼로그. todoForEdit이 있으면 수정 모드, 없으면 추가 모드

 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


// TodoItem에서 스와이프 삭제
Dismissible(
 key: ValueKey(todo.id),
 onDismissed: (direction) {
 // 여기서 삭제 로직 호출
 },
 child: RoundedContainer(
 child: Column(
 children: [
 Text(todo.dueDate.toString()),
 Row(
 children: [
 TodoStatusWidget(todo),
 Text(todo.title),
 const Spacer(),
 IconButton(
 onPressed: () {
 // 수정 로직 호출
 },
 icon: const Icon(EvaIcons.editOutline),
 )
 ],
 ),
 ],
 ),
 ),
)

ValueNotifier — setState의 진화

setState의 한계

setState는 해당 위젯 내부에서만 작동한다. 부모에서 만든 todoList를 여러 자식 위젯이 공유해야 할 때, 콜백으로 내려보내거나 prop drilling을 해야 한다. SwiftUI에서 @Binding을 n단계 내려보내는 고통과 같다.

ValueNotifier란

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


class TodoDataNotifier extends ValueNotifier<List<Todo>> {
 TodoDataNotifier() : super([]); // 최초 빈 리스트로 시작

 void addTodo(Todo todo) {
 value.add(todo);
 notifyListeners();
 }

 void notify() {
 notifyListeners();
 }
}

ValueNotifier<T>는 Flutter 내장 클래스다. value가 바뀌면 notifyListeners()를 호출해서 구독 중인 위젯을 리빌드시킨다.

Swift랑 비교하면:

Flutter	SwiftUI
`ValueNotifier<T>`	`ObservableObject` + `@Published`
`notifyListeners()`	`objectWillChange.send()` (수동)
`value`	`@Published var value: T`

핵심 차이는, Swift의 @Published는 값이 바뀌면 자동으로 알림을 보내는데, Flutter의 ValueNotifier에서는 List 내부를 수정하면(value.add()) 참조 자체는 안 바뀌니까 수동으로 notifyListeners()를 호출해야 한다. 이걸 까먹으면 UI가 안 바뀌는 버그가 생긴다.

ValueListenableBuilder로 UI 연결

1
2
3
4
5
6
7
8


ValueListenableBuilder<List<Todo>>(
 valueListenable: todoNotifier,
 builder: (context, todoList, child) {
 return Column(
 children: todoList.map((e) => TodoItem(e)).toList(),
 );
 },
)

SwiftUI에서 @ObservedObject를 쓰면 body가 자동 리빌드되는 것과 같은 역할이다. builder 안에서 todoList가 바뀔 때마다 UI가 다시 그려진다. child 파라미터는 리빌드할 필요 없는 자식을 캐싱하는 용도인데, 이건 성능 최적화 포인트다.

InheritedWidget — 위젯 트리로 데이터 전파

왜 필요한가

ValueNotifier만으로는 “누가 이 Notifier를 들고 있느냐"가 문제다. 생성자로 내려보내면 결국 prop drilling이 다시 발생한다. InheritedWidget은 위젯 트리에 데이터를 심어두고, 하위 어디서든 꺼내 쓸 수 있게 해주는 메커니즘이다.

사실 이 프로젝트에서 이미 다크모드 테마 시스템으로 InheritedWidget을 쓰고 있었다:

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


// 이미 있던 테마용 InheritedWidget
class CustomThemeHolder extends InheritedWidget {
 final AbstractThemeColors appColors;
 final CustomTheme theme;
 final Function(CustomTheme) changeTheme;

 static CustomThemeHolder of(BuildContext context) {
 return context.dependOnInheritedWidgetOfExactType<CustomThemeHolder>()!;
 }

 @override
 bool updateShouldNotify(CustomThemeHolder old) {
 return theme != old.theme;
 }
}

같은 원리를 상태관리에 적용하는 거다.

TodoDataHolder 구현

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


class TodoDataHolder extends InheritedWidget {
 final TodoDataNotifier notifier;

 const TodoDataHolder({
 required this.notifier,
 required Widget child,
 Key? key,
 }) : super(key: key, child: child);

 static TodoDataNotifier of(BuildContext context) {
 return context
 .dependOnInheritedWidgetOfExactType<TodoDataHolder>()!
 .notifier;
 }

 @override
 bool updateShouldNotify(TodoDataHolder old) {
 return notifier != old.notifier;
 }
}

of(context) 패턴은 Flutter에서 아주 관용적인 접근법이다. Theme.of(context), MediaQuery.of(context) 등 전부 이 패턴이다. 내부적으로 context.dependOnInheritedWidgetOfExactType은 Element의 해시 테이블을 조회해서 O(1)로 찾는다.

SwiftUI 비교:

Flutter	SwiftUI
`InheritedWidget` + `of(context)`	`@EnvironmentObject`
직접 InheritedWidget 클래스 작성	Property Wrapper가 자동 처리
`context.dependOn...`	`@EnvironmentObject var vm: ViewModel`

SwiftUI가 확실히 간편하다. Flutter에서는 InheritedWidget 클래스를 직접 만들어야 하는데, SwiftUI는 @EnvironmentObject만 붙이면 끝이다. 근데 원리는 같다.

context extension으로 축약

1
2
3
4
5
6


extension ContextExtension on BuildContext {
 TodoDataHolder get todoHolder => TodoDataHolder.of(this);
}

// 사용
context.todoHolder.addTodo(todo);

매번 TodoDataHolder.of(context).notifier.addTodo()라고 쓰면 너무 기니까 extension으로 축약한다. 테마에서도 context.appColors로 이미 같은 패턴을 쓰고 있었다.

App에서 Provide

1
2
3
4
5
6
7
8
9


// app.dart
CustomThemeApp(
 child: TodoDataHolder(
 notifier: TodoDataNotifier(),
 child: MaterialApp(
 home: const MainScreen(),
 ),
 ),
)

MaterialApp 위에 InheritedWidget을 감싸서 앱 전체에서 접근 가능하게 한다. SwiftUI에서 .environmentObject(todoVM)을 최상위에 넣는 것과 같은 구조다.

mounted — 비동기에서 context 안전하게 쓰기

상태관리와 별개로 중요한 포인트가 하나 있었다. 비동기 작업 중에 위젯이 dispose되면 context를 쓸 수 없는 문제다.

1
2
3
4
5
6
7
8
9


void _loadRive() async {
 _cachedFile = await File.asset('assets/rive/fire_button.riv');

 // 비동기 작업이 끝났는데 위젯이 이미 사라졌다면?
 if (_cachedFile != null && mounted) { // mounted로 체크!
 _controller = RiveWidgetController(_cachedFile!);
 setState(() => _riveReady = true);
 }
}

await 후에 setState를 부르는데, 그 사이에 사용자가 화면을 나갔다면 위젯이 dispose된 상태다. 이때 setState를 호출하면 에러가 난다. mounted 프로퍼티로 위젯이 아직 살아있는지 체크하는 게 안전하다.

iOS에서 [weak self]로 self가 nil인지 체크하는 것과 비슷한 맥락이다:

1
2
3
4
5
6


// Swift
Task { [weak self] in
 let data = await fetchData()
 guard let self else { return } // self가 살아있는지 체크
 self.updateUI(data)
}

1
2
3
4
5
6
7


// Flutter
void someAsyncWork() async {
 final data = await fetchData();
 if (mounted) { // 위젯이 살아있는지 체크
 setState(() => _data = data);
 }
}

상태 변경 흐름 정리

추가

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


void _addTodo() async {
 final result = await WriteTodoDialog().show();
 if (result != null) {
 context.todoHolder.addTodo(
 Todo(
 id: DateTime.now().microsecondsSinceEpoch,
 title: result.text,
 dueDate: result.dateTime,
 ),
 );
 }
}

다이얼로그에서 결과를 받아와서 Notifier에 추가한다. WriteTodoDialog는 제네릭 타입으로 WriteTodoResult를 반환하는 구조다.

상태 전환

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


void _changeTodoStatus(Todo todo) async {
 switch (todo.status) {
 case TodoStatus.inComplete:
 todo.status = TodoStatus.onGoing;
 case TodoStatus.onGoing:
 todo.status = TodoStatus.complete;
 case TodoStatus.complete:
 final result = await ConfirmDialog('정말로 처음 상태로 변경하시겠어요?').show();
 result?.runIfSuccess((data) {
 todo.status = TodoStatus.inComplete;
 });
 }
 context.todoHolder.notify(); // 수동으로 알림
}

mutable이니까 todo.status를 직접 바꾸고, notify()로 UI를 갱신한다. ConfirmDialog는 SimpleResult 패턴으로 결과를 체이닝한다. Swift의 Result<Success, Failure> 패턴과 비슷하다.

삭제

1
2
3


// Dismissible의 onDismissed에서
context.todoHolder.value.remove(todo);
context.todoHolder.notify();

스와이프로 삭제하면 리스트에서 제거하고 알림을 보낸다.

이 접근법의 장단점

장점:

외부 패키지 0개. Flutter 기본 API만으로 구현
InheritedWidget 동작 원리를 이해하면 Provider, BLoC 등 모든 Scoped 방식의 기반을 이해한 거다
간단한 앱에는 충분

한계:

notifyListeners() 수동 호출을 까먹기 쉬움
mutable 객체를 직접 수정하니까 어디서 바뀌었는지 추적이 어려움
비즈니스 로직이 Notifier, UI 여기저기에 흩어질 수 있음
InheritedWidget을 직접 만드는 보일러플레이트가 꽤 있음

정리

개념	Flutter (ValueNotifier)	SwiftUI
상태 홀더	`ValueNotifier`	`ObservableObject`
변경 알림	`notifyListeners()` 수동	`@Published` 자동
UI 구독	`ValueListenableBuilder`	`@ObservedObject` / body 자동
트리 전파	`InheritedWidget` + `of(context)`	`@EnvironmentObject`
비동기 안전	`mounted` 체크	`[weak self]` / `guard let self`

Flutter 내장만으로 상태관리를 해봤다. 동작은 하는데 notifyListeners() 수동 호출이 좀 거슬린다. 다음 Ch05-2에서는 GetX로 전환하면서 이 수동 호출이 .obs로 바뀌면 얼마나 코드가 줄어드는지 비교해보자.

Ch04. 상태관리를 왜 해야 하는가 - MVC에서 선언형 UI까지

Tue, 28 Apr 2026 03:00:00 +0900

Ch04부터는 상태관리다. 왜 상태관리를 해야 하는지, 어떤 방식들이 있는지 정리한다. 개인적으로 이 부분이 꽤 재밌었다.

상태관리를 왜 해야 하나

결론부터 말하면 앱을 더 쉽게 개발하기 위해서다.

처음 개발할 때 빠르게 만들기 위해
스펙이 바뀌었을 때 수정할 곳을 빠르게 찾기 위해

작은 앱에서는 setState만으로도 충분한데, 화면이 10개 넘어가고 여러 화면에서 같은 데이터를 공유해야 하면 어디서 상태를 관리하고 어떻게 전달할지가 문제가 된다. 이걸 체계적으로 정리한 게 상태관리 패턴이다.

MVC에서 선언형 UI까지 — 왜 이렇게 바뀌었나

MVC (Model-View-Controller)

1970년대에 나온 패턴이다. 근데 많이들 오해하는 게 있다:

원래 작은 컴포넌트 단위의 설계였다. 앱 전체 아키텍처용이 아니었다.
MVVM에서 말하는 데이터 Observing이 이미 포함돼 있던 개념이다.
Controller는 원래 키보드/마우스 입력을 처리하는 역할이었다.

문제는 모바일에서 Controller의 의미가 변질됐다는 거다. Android의 Activity, iOS의 UIViewController가 이미 Controller이면서 동시에 View였다. 화면 자체가 Controller 역할을 하는 짬뽕이 된 거다. 결과적으로 Controller가 뚱뚱해지면서(Massive View Controller라고 부른다) 유지보수가 힘들어졌다.

Swift에서 UIKit 개발해본 사람이면 ViewController에 네트워크 호출, 테이블뷰 delegate, 데이터 가공 로직까지 다 때려넣어본 경험이 있을 거다. 그게 바로 MVC의 한계다.

MVP (Model-View-Presenter)

MVC의 문제를 해결하려고 나온 게 MVP다.

Android는 View가 XML로 분리돼 있었고
iOS는 View가 ViewController + Storyboard로 분리돼 있었다

이렇게 코드와 분리된 View를 제어할 Presenter가 필요했다. Presenter가 로직을 담당하고, View는 그리기만 한다.

근데 문제가 있었다. Presenter가 View에게 일일이 명령을 내려야 화면이 갱신됐다. “이 라벨 텍스트 바꿔”, “이 버튼 숨겨”, “이 리스트 리로드해”… 하나하나 다 지시해야 했다. 코드가 장황해지고 빠뜨리면 UI 버그가 났다.

MVVM (Model-View-ViewModel)

MVP의 “일일이 명령” 문제를 해결한 게 MVVM이다.

1

ViewModel의 상태를 바꾸면 → View가 알아서 갱신된다

핵심은 데이터 바인딩이다:

Android에서는 DataBinding 라이브러리가 나왔고
iOS에서는 RxSwift 같은 Rx 라이브러리로 Observable 패턴을 구현했다

값만 세팅하면 알아서 뷰가 갱신되니까 UI 버그가 확 줄었다. 근데 완벽하진 않았다. 뷰가 내부적으로 코드와 분리돼 있었기 때문에(XML, Storyboard) ViewModel과 View를 연결하는 바인딩 코드가 노가다였다.

iOS에서 RxSwift 쓸 때를 떠올리면:

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


// iOS + RxSwift: 바인딩 노가다
viewModel.userName
 .bind(to: nameLabel.rx.text)
 .disposed(by: disposeBag)

viewModel.isLoading
 .bind(to: activityIndicator.rx.isAnimating)
 .disposed(by: disposeBag)

viewModel.items
 .bind(to: tableView.rx.items(cellIdentifier: "Cell")) { ... }
 .disposed(by: disposeBag)

프로퍼티 하나하나 다 바인딩해줘야 했다.

선언형 UI — 최종 보스

그리고 선언형 UI가 등장했다.

Android → Jetpack Compose
iOS → SwiftUI
크로스플랫폼 → Flutter, React

Flutter 공식 문서에서 설명하는 핵심 차이는 이거다:

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


// 명령형 (Imperative) — 어떻게 바꿀지 지시
button.setColor(red);
button.setText('완료');
container.removeChild(oldChild);
container.addChild(newChild);

// 선언형 (Declarative) — 어떤 상태인지 선언
return ElevatedButton(
 style: ButtonStyle(backgroundColor: MaterialStateProperty.all(Colors.red)),
 onPressed: onTap,
 child: Text('완료'),
);

명령형은 “빨간색으로 바꿔, 텍스트 바꿔, 자식 교체해” 하고 일일이 지시하는 거고, 선언형은 “이 상태일 때 UI는 이렇게 생겼다"고 선언만 하면 프레임워크가 알아서 그려준다.

SwiftUI에서 @State가 바뀌면 body가 다시 그려지는 것과 완전히 같은 원리다:

1
2
3
4
5
6
7


// SwiftUI
struct CounterView: View {
 @State var count = 0
 var body: some View {
 Button("\(count)") { count += 1 }
 }
}

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


// Flutter
class CounterWidget extends StatefulWidget {
 @override
 State<CounterWidget> createState() => _CounterWidgetState();
}

class _CounterWidgetState extends State<CounterWidget> {
 int count = 0;

 @override
 Widget build(BuildContext context) {
 return ElevatedButton(
 onPressed: () => setState(() => count++),
 child: Text('$count'),
 );
 }
}

선언형 UI가 나오면서 View의 패턴 구조를 논의할 필요가 없어졌다. MVC냐 MVP냐 MVVM이냐가 아니라, 상태와 데이터를 어떻게 관리할지가 더 중요해진 거다. 그게 바로 State Management다.

흐름 정리

1
2
3
4
5
6
7


MVC: 원래 작은 컴포넌트용이었는데 모바일에서 Controller가 비대해짐
 ↓
MVP: View와 로직을 Presenter로 분리. 근데 일일이 명령해야 함
 ↓
MVVM: 데이터 바인딩으로 자동 갱신. 근데 바인딩 코드가 노가다
 ↓
선언형 UI: 상태만 바꾸면 끝. 이제 "상태를 어떻게 관리할까"가 핵심

Scoped Model vs Static Model

Flutter 상태관리 구조는 크게 두 가지로 나뉜다.

Scoped Model

상태의 범위를 제한하는 방식이다. 특정 화면이나 위젯 트리 안에서만 상태가 유효하다.

1
2
3
4
5


// Provider 예시: 이 위젯 하위에서만 CartModel에 접근 가능
ChangeNotifierProvider(
 create: (_) => CartModel(),
 child: ShoppingPage(), // 이 안에서만 CartModel 사용 가능
)

특징:

해당 화면이 사라지면 자동으로 메모리 해제된다
자식 위젯에서 id 없이도 상위 데이터를 참조할 수 있다
내부적으로 Flutter의 InheritedWidget을 활용한다

대표적인 Scoped 방식: Provider, BLoC, Riverpod

Static Model

상태가 전역으로 떠 있는 방식이다. 앱 어디서든 접근할 수 있다.

1
2
3
4
5
6
7
8


// GetX 예시: 어디서든 접근 가능
Get.put(UserController());

// A 화면에서
Get.find<UserController>().user.value;

// B 화면에서도
Get.find<UserController>().user.value; // 같은 인스턴스

특징:

메모리 관리를 개발자가 직접 해야 한다
자식에서 데이터 참조할 때 id(tag)가 항상 필요하다
Scoped보다 구현이 훨씬 쉽다
어디서든 접근/수정 가능하니까 상태가 꼬일 위험이 있다

대표적인 Static 방식: GetX

뭐가 다른지 예시로 보면

유튜브 앱이라고 치자. 영상 재생 화면은 코드상으로는 같은 VideoScreen인데, 어떤 영상이냐에 따라 동영상 URL, 댓글, 좋아요 수가 전부 다르다.

Scoped 방식에서는:

1
2
3
4
5


// 각 영상 화면의 상위에 해당 영상의 상태를 넣어줌
ChangeNotifierProvider(
 create: (_) => VideoState(videoId: 'abc123'),
 child: VideoScreen(), // 이 안에서는 abc123 영상의 상태만 보임
)

Riverpod에서는 family라는 기능으로 더 깔끔하게 처리한다:

1
2
3
4
5
6
7
8


// Riverpod: videoId별로 자동으로 다른 상태 인스턴스 생성
final videoProvider = FutureProvider.family<Video, String>((ref, videoId) {
 return fetchVideo(videoId);
});

// 사용: 같은 provider인데 id가 다르면 다른 상태
ref.watch(videoProvider('abc123')); // 영상 1의 상태
ref.watch(videoProvider('xyz789')); // 영상 2의 상태 (별도)

Static 방식(GetX)에서는:

1
2
3
4
5
6


// tag로 구분해서 따로 관리
Get.put(VideoController(), tag: 'abc123');
Get.put(VideoController(), tag: 'xyz789');

// 사용할 때 tag로 찾아와야 함
Get.find<VideoController>(tag: 'abc123');

둘 다 가능하다. 근데 Scoped는 화면 닫으면 알아서 정리되고, Static은 개발자가 직접 Get.delete(tag: 'abc123') 해줘야 한다.

또 다른 예시 — ID가 없는 경우

데스크탑 앱에서 “새 문서” 버튼을 3번 눌렀다고 치자. 각 문서는 아직 저장 전이라 고유 ID가 없다. 이때는 Scoped가 자연스럽다:

1
2
3
4
5
6
7


// Scoped: 각 문서 화면이 자기 스코프 안에 상태를 가짐
Navigator.push(context, MaterialPageRoute(
 builder: (_) => ChangeNotifierProvider(
 create: (_) => DocumentState(), // 각각 독립된 상태
 child: DocumentScreen(),
 ),
));

Static으로도 가능은 하다 — 임시 ID를 생성해서 tag로 관리하면 된다. 근데 굳이 그럴 필요 없이 Scoped가 더 깔끔한 케이스다.

그래서 뭘 써야 하나

정답은 스펙에 따라 다르다. 하지만 일반적인 기준은 있다:

	Scoped Model	Static Model
메모리 관리	자동 해제	직접 관리
데이터 접근	위젯 트리 통해서	어디서든 직접
구현 난이도	상대적으로 복잡	쉬움
상태 안정성	범위가 제한돼서 안전	어디서든 수정 가능해서 꼬일 수 있음
테스트	스코프 단위로 격리 가능	전역 상태라 격리 어려움
대표 패키지	Provider, BLoC, Riverpod	GetX

Swift 개발자 입장에서 비유하면:

Scoped = SwiftUI에서 @StateObject를 뷰 계층에 맞게 넣는 것
Static = 싱글톤으로 전역 접근하는 것 (AppState.shared)

iOS 개발할 때도 싱글톤 남발하면 테스트 힘들고 상태 꼬이는 걸 경험해봤을 텐데, Flutter에서도 똑같다. GetX가 쉬운 건 맞지만 앱이 커지면 Scoped 방식이 관리하기 편하다.

상태관리 패키지 현황

Flutter 공식 문서에서도 여러 접근법을 소개하고 있다. 현재 주요 패키지들의 포지션을 정리하면:

패키지	방식	특징
Provider	Scoped	Flutter 팀 추천 입문용. InheritedWidget 래퍼
BLoC	Scoped	Event → State 단방향 흐름. 엔터프라이즈 앱에 적합
Riverpod	Scoped	Provider의 진화형. 컴파일 타임 안전성. family로 키 기반 관리
GetX	Static	전역 접근, 쉬운 구현. tag로 인스턴스 구분

Flutter 공식 입장은 “setState로 시작하고, 복잡해지면 패키지를 도입하라"다. 어떤 패키지가 절대적으로 좋다기보다는 앱 규모와 팀 상황에 맞는 걸 고르는 게 맞다.

정리

상태관리의 역사를 보면 결국 한 방향으로 흘러왔다:

1

"UI를 어떻게 그릴까" → "상태를 어떻게 관리할까"

MVC에서 선언형 UI까지 오는 동안 패턴이 계속 바뀐 이유는 “상태가 바뀌면 UI가 알아서 반영되게” 하고 싶었기 때문이다. 선언형 UI가 그걸 해결했고, 이제 남은 문제는 그 상태를 어떤 범위에서 어떻게 관리할지다.

Scoped냐 Static이냐는 결국 트레이드오프다. 쉬운 걸 원하면 Static(GetX), 안전한 걸 원하면 Scoped(Provider/BLoC/Riverpod). iOS 개발할 때 싱글톤 vs 의존성 주입 고민했던 것과 본질적으로 같은 문제다.

State Management on jHoon

Ch05-6. 아키텍처와 상태관리 총정리 - 정답은 없고 차이만 있다

왜 아키텍처를 고민하는가

1. 쉬운 개발

2. 안정성

3. 성능

4. 확장성

5. 제공되는 추가 기능들

정답은 없다, 차이만 있다

Scoped vs Static — 접근성 다시 보기

Widget Tree 기반 설계의 차이

4가지 방식 최종 비교

공부법에 대한 생각

마무리

Ch05-4. Todo 앱 Riverpod 전환 - 이게 진짜 사기다

BLoC → Riverpod, 뭐가 바뀌나

StateNotifierProvider — 핵심 구조

Provider 선언 (전역)

StateNotifier 구현

Extension으로 접근 축약

ConsumerWidget — UI에서 사용

ProviderScope 설정

ConsumerWidget으로 구독

ref.watch vs ref.read

ConsumerStatefulWidget

ProviderScope — 스코프 개념

FutureProvider — 비동기 상태의 끝판왕

기본 사용법

화면 일부만 분기하기

ref.listen — 오버레이 로딩

@riverpod — 코드 제너레이션

BLoC vs Riverpod 최종 비교

코드 비교

같은 “Todo 삭제” 동작

언제 뭘 쓸까

4가지 방식 총 비교

내가 느낀 점

Riverpod 3.0 — 2025년 9월 기준 변경점

Ch05-3. Todo 앱 BLoC + freezed 전환 - 이벤트 기반 상태관리

BLoC이란

freezed로 불변 모델 만들기

mutable의 문제 (Ch05-2 복습)

freezed 적용

BlocState도 freezed로

build_runner로 코드 생성

Event 설계 — sealed class

TodoBloc — 핵심 로직

Bloc 클래스 구조

추가

상태 전환 (가장 복잡한 부분)

삭제

수정

UI에서 BLoC 사용

BlocProvider로 등록

BlocBuilder로 구독

context.read vs context.watch

실제 위젯에서 사용

Rive 애니메이션 (보너스)

3가지 방식 최종 비교

코드 비교

같은 “Todo 추가” 동작

Swift/iOS 대응표

어떤 걸 써야 하나

정리

Ch05-2. Todo 앱 GetX로 전환 - .obs와 Obx의 마법

뭐가 바뀌나

.obs — 자동 변경 감지

변환 핵심

다양한 타입에 .obs

같은 값이면 리빌드 안 함

Obx — 반응형 UI 빌더

InheritedWidget 제거 — Get.put / Get.find

등록

접근

상태 변경 로직 — mutable의 함정

추가, 삭제

상태 전환 — refresh()가 필요한 순간

수정도 마찬가지

GetX의 편리함과 위험성

코드량 비교