· Flutter 개발 · 6 min read
점수만 보면 지루했다… 도감 화면을 넣은 진짜 이유
발견·미발견 타일을 보여주는 Flutter 게임 컬렉션 화면 구현 판단.

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