/inspector:bloc — 화면 상태 들여다보기#

한마디로#

앱이 지금 화면 안에서 "어떤 상태"인지(예: 로그인됨, 장바구니 비어 있음)를 실시간으로 들여다보는 돋보기입니다. 자동차 계기판처럼, 겉으로 보이는 화면 뒤에서 무슨 값이 켜지고 꺼졌는지 그대로 보여줍니다.

누가·언제 쓰나요#

• 개발자나 QA 담당자가 앱이 실제로 돌아가는 중에 화면 동작을 점검할 때 사용합니다.
• 특히 이런 상황에서 씁니다:
  • 버튼을 눌렀는데 화면이 바뀌지 않을 때 (상태가 안 바뀜)
  • 예상과 다른 화면이 떠 있을 때 (이상한 상태)
  • 화면이 깜빡이거나 불필요하게 자꾸 다시 그려질 때

무엇을 해주나요#

앱 안에서 화면 상태를 관리하는 부품(BLoC/Cubit)들의 현재 상태를 꺼내서 보여줍니다.

• 지금 살아 있는 화면 상태 부품 목록 (예: AuthBloc, HomeBloc, CartCubit)
• 특정 부품의 현재 상태 값 (예: "로딩 완료, 아이템 15개")
• 상태가 어떻게 바뀌어 왔는지 변경 이력
• 어떤 동작(이벤트)들이 일어났는지 이벤트 이력

어떻게 쓰나요#

# 지금 살아 있는 화면 상태 부품 목록 보기
/inspector/bloc list

# 특정 부품(HomeBloc)의 현재 상태 보기
/inspector/bloc state HomeBloc

# 특정 부품(AuthBloc)에서 일어난 동작(이벤트) 이력 보기
/inspector/bloc events AuthBloc

list는 전체 목록, state는 특정 부품의 현재 값, events는 그 부품에 어떤 일이 있었는지를 보여줍니다.

안에서 무슨 일이 벌어지나요#

문제 유형별로 정해진 순서대로 점검합니다.

• 화면이 안 바뀔 때: 부품이 실제로 있는지 → 동작이 발생했는지 → 상태가 바뀌었는지 순서로 따라가며 어디서 막혔는지 찾습니다.
• 이상한 화면일 때: 현재 상태 값을 확인하고, 어떻게 그 상태까지 왔는지 변경 과정을 되짚어 봅니다.
• 화면이 자꾸 다시 그려질 때: 동작이 너무 자주 일어나는지 점검하고, 다시 그리는 조건이 올바른지 살펴봅니다.

{
   " blocs " : [
    { " type " :  " AuthBloc " ,  " state " :  " Authenticated " },
    { " type " :  " HomeBloc " ,  " state " :  " Loaded " },
    { " type " :  " CartCubit " ,  " state " :  " Empty " }
  ]
}

{
   " type " :  " HomeBloc " ,
   " state " : {
     " status " :  " loaded " ,
     " items " : 15,
     " selectedCategory " :  " all " 
   }
}

1. bloc_list_active - >   Confirm BLoC exists
2. bloc_get_events - >   Confirm event was fired
3. bloc_get_history - >   Track state changes

1. bloc_get_state - >   Check current state
2. bloc_get_history - >   Track change process
3. Review event handler logic

1. bloc_get_events - >   Check event frequency
2. Review buildWhen conditions
3. Check state comparison logic

/inspector/bloc list

/inspector/bloc state HomeBloc

/inspector/bloc events AuthBloc