Flutter Bloc·Cubit 상태 공유와 불필요한 재빌드 줄이기
페이지 사이에서 Cubit을 공유할 때 발생하는 상태 수명, BuildContext, 중복 조회와 과도한 재빌드 문제를 설명하고 화면 상태를 작게 분리하는 방법을 예제로 정리한다.
Cubit 하나에 목록, 상세, 수정, 스캔 상태를 모두 넣으면 처음에는 편하지만 작은 변경에도 전체 화면이 다시 그려진다. 상태의 소유자와 수명을 먼저 정의해야 한다.
flowchart TD
A[Route Scope] --> B[List Cubit]
A --> C[Detail Cubit]
A --> D[Edit Cubit]
B --> E[목록 UI]
C --> F[상세 UI]
D --> G[입력 폼]
Cubit을 어디에 제공할까
목록과 상세가 같은 검색 조건을 공유해야 한다면 상위 Route에서 제공할 수 있다.
class OrderFlowPage extends StatelessWidget {
const OrderFlowPage({super.key});
@override
Widget build(BuildContext context) {
return BlocProvider(
create: (_) => OrderListCubit(context.read<OrderRepository>())..load(),
child: const OrderListView(),
);
}
}
기존 Cubit을 다음 Route로 전달할 때는 새 인스턴스를 생성하지 않는다.
Navigator.of(context).push(
MaterialPageRoute<void>(
builder: (_) => BlocProvider.value(
value: context.read<OrderListCubit>(),
child: const OrderDetailPage(),
),
),
);
BlocProvider.value는 기존 인스턴스를 전달할 때 사용한다. 새로운 Cubit을 만들 때 사용하는 패턴과 섞지 않는 것이 중요하다.
상태를 작은 값으로 선택하기
final count = context.select(
(OrderListCubit cubit) => cubit.state.orders.length,
);
또는 buildWhen으로 다시 그릴 조건을 제한한다.
BlocBuilder<OrderListCubit, OrderListState>(
buildWhen: (previous, current) =>
previous.orders != current.orders ||
previous.status != current.status,
builder: (context, state) {
return OrderList(orders: state.orders);
},
)
buildWhen은 잘못 설계된 거대한 상태를 영구적으로 가리는 도구가 아니다. 서로 다른 화면 책임이라면 Cubit 자체를 분리하는 편이 명확하다.
상태와 일회성 효과 분리
목록 데이터는 상태지만 SnackBar와 화면 이동은 UI 효과다.
BlocConsumer<OrderEditCubit, OrderEditState>(
listenWhen: (previous, current) =>
previous.submitStatus != current.submitStatus,
listener: (context, state) {
if (state.submitStatus == SubmitStatus.success) {
Navigator.of(context).pop(true);
}
},
buildWhen: (previous, current) =>
previous.form != current.form ||
previous.submitStatus != current.submitStatus,
builder: (context, state) => OrderEditForm(state: state),
)
화면 복귀 후 갱신
상세에서 수정했을 때만 목록을 갱신한다.
final changed = await Navigator.of(context).push<bool>(detailRoute);
if (changed == true && context.mounted) {
context.read<OrderListCubit>().reloadKeepingSelection();
}
매번 전체 재조회하는 것보다 “변경 여부”와 “직전 선택 ID”를 명시하면 지도 마커나 스크롤 위치도 복원하기 쉽다.
관련 문서
다른 게시글
현장 Flutter 앱 디버깅에 자주 쓴 ADB 명령어
기기 지정, Logcat, APK 설치, 파일 복사, 포트 reverse를 실기기 점검 흐름으로 정리한다.
Android 입력 장치 목록 조회하기: 키보드·마우스·HID 스캐너 구분
Android `InputManager`와 `InputDevice` API로 연결된 입력 장치를 조회하고, 키보드·포인터·외부 장치 여부를 판별하는 방법을 정리한다. USB·Bluetooth HID 바코드 스캐너를 일반 키보드와 구분할 때의 한계와 연결 변경 감지 방법도 함께 살펴본다.
Android 위치 권한과 FusedLocationProvider 실전 정리: 현재 위치·지속 추적·GPS 설정
Jetpack Compose 앱에서 Android 위치 권한을 요청하고, Fused Location Provider로 캐시 위치·일회성 현재 위치·지속 위치 업데이트를 처리하는 흐름을 정리한다. Android 12의 대략적·정확한 위치 선택, 백그라운드 위치 정책, GPS 설정 확인과 생명주기 연동까지 예제 코드로 살펴본다.