· Flutter 개발 · 6 min read
테스트가 계속 깨져서… 엔진과 화면을 갈라버렸다
BloomEngine 단위 테스트와 Flutter 위젯 테스트를 나눈 방식.
이미지 출처: Unsplash · Jakub Żerdzicki
게임 규칙은 빠르게 수백 번 검증해야 하고, 화면은 실제 흐름을 검증해야 한다. 그래서 병합·점수·새 타일 생성은 순수 Dart 테스트로, 홈·테마 선택·튜토리얼은 위젯 테스트로 나눴다.
버그가 나면 먼저 엔진인지 화면인지 범위를 줄일 수 있었다. 테스트가 느리면 개발 중에 실행하지 않게 되므로, 경계를 나눈 선택이 가장 실용적이었다.
엔진 단위 테스트는 빠른 실패 신호를 주고, 위젯 테스트는 실제 버튼과 화면 문구가 바뀌지 않았는지 알려준다. 스토어용 캡처는 통합 테스트로 분리해 재현성을 확보했다.
테스트가 실패했을 때 화면부터 의심하면 시간이 너무 많이 샜다. 규칙이 틀렸는지, 버튼이 틀렸는지 따로 말해 주는 테스트가 필요했다.
코드만 따라 하지 않고 확인한 것
Flutter 검색 결과에는 동작하는 짧은 예제가 많다. 하지만 실제 앱에서는 예제 밖의 조건이 더 자주 문제를 만든다. 화면 크기가 줄어들고, 이전 버전의 저장 값이 남고, 네트워크나 스토어가 준비되지 않은 상태가 생긴다. 그래서 새 패키지나 패턴을 적용할 때는 정상 흐름 하나만 보지 않고, 중단·실패·복원 흐름을 같이 적었다.
특히 상태가 바뀌는 기능은 누가 상태를 소유하는지부터 정해야 한다. 게임 규칙처럼 화면과 독립적인 것은 Dart 영역에 두고, 제스처·레이아웃·애니메이션은 Flutter에 맡겼다. 이 분리가 되어 있으면 테스트는 훨씬 작아지고, 화면을 다듬다가 핵심 규칙을 망가뜨릴 가능성도 줄어든다. 반대로 한 위젯 안에서 저장과 계산과 표시를 함께 하면 기능 하나를 고칠 때마다 예상하지 못한 곳이 흔들린다.
실제 적용할 때는 아래 세 가지를 꼭 남겨두면 좋다.
- 어떤 입력에서 상태가 바뀌는지
- 그 상태를 앱 종료 뒤에도 보존해야 하는지
- 실패했을 때 사용자에게 어떤 선택지를 보여 줄지
나는 테스트가 늘어나는 속도보다, 테스트를 다시 실행할 수 있는 속도를 더 신경 썼다. 빠른 단위 테스트로 규칙을 확인하고, 위젯 테스트로 버튼과 문구를 확인하고, 실제 기기 통합 테스트는 첫 플레이와 저장 복원처럼 중요한 흐름에만 썼다. 이 구분이 없으면 테스트는 많은데 변경할 때마다 실행하지 않는 상태가 되기 쉽다.
이 기능을 출시 기준으로 바꾸면
개발자에게는 동작하는 코드가 기준이지만, 사용자에게는 멈추지 않고 이해되는 흐름이 기준이다. 그래서 기능을 마칠 때마다 첫 실행부터 종료까지를 직접 한 번 통과했다. 버튼이 보이는지보다 눌렀을 때 다음 행동을 알 수 있는지, 오류가 나더라도 앱을 다시 열 수 있는지를 확인했다.
이 기록을 남길 때는 성공한 화면만 캡처하지 않았다. 테스트 중 어떤 조건을 바꿨는지, 어떤 경우에는 적용하지 않았는지도 적어두면 다음 업데이트에서 같은 선택을 다시 고민할 필요가 없다.
기록을 남긴 이유
이 단계의 판단은 다음 기능을 만들 때 다시 쓰기 위한 기준이기도 하다. 같은 문제를 검색해서 임시 답을 붙이기보다, 어떤 조건에서 선택했고 무엇을 확인했는지 남겨두면 프로젝트가 커져도 흔들리지 않는다. 이 글의 코드와 체크 항목은 그대로 복사하기보다 현재 앱의 상태·패키지 버전·배포 환경에 맞춰 한 번 더 검증해서 적용하는 것을 권한다.