· Flutter 개발 · 7 min read
테마 다섯 개? 처음엔 미친 짓인 줄 알았다
Flutter 게임의 과수원·채소·꽃·숲·보석 테마를 확장 가능한 데이터로 정리한 방법.

테마별 화면을 복사하면 이름 하나를 바꿀 때도 다섯 곳을 수정하게 된다. GameTheme과 타일 메타데이터를 기준으로 배경·색·이미지·컬렉션 이름을 선택하게 만들었다.
처음부터 다섯 테마를 완성하려고 한 것은 아니다. 과수원 화면으로 루프를 먼저 확인한 뒤, 같은 규칙을 다른 분위기로 바꾸는 방식이 유지보수 비용을 낮췄다.
다섯 테마의 공통 규칙은 같은데 배경과 타일만 달라야 했다. 테마를 전환해도 저장 형식과 엔진이 바뀌지 않는지 확인하는 것이 새 테마를 추가할 때의 안전망이 됐다.
처음에는 테마가 많을수록 풍성해 보일 거라고만 생각했다. 막상 관리할 데이터가 늘어나니, 공통 규칙을 끝까지 지키는 쪽이 더 중요했다.
이 단계를 실제 Flutter 프로젝트에 적용하는 순서
이 글의 내용은 예제 코드를 한 번 실행해 보는 데서 끝내면 효과가 작다. 나는 기능을 붙이기 전에 “어떤 입력을 주면, 어떤 상태가 남아야 하는가”를 한 문장으로 적어 두었다. 이 문장이 있으면 구현 중에 화면이 조금 바뀌어도 무엇을 지켜야 하는지 놓치지 않는다. Mergrove에서는 한 번의 스와이프, 병합 결과, 점수 변화, 저장 시점처럼 눈에 보이는 결과와 내부 상태를 함께 확인했다.
작업 순서는 작게 잡는 편이 좋다. 먼저 순수 Dart 로직이나 데이터 모델에서 기대 결과를 만들고, 그 다음 Flutter 위젯에 연결한다. 마지막으로 실제 기기에서 손가락으로 조작해 본다. 이 순서가 필요한 이유는 오류가 났을 때 규칙 문제인지, 화면 문제인지, 기기 입력 문제인지 빠르게 나눌 수 있기 때문이다. 화면부터 만들고 나중에 규칙을 고치면 같은 버그를 여러 곳에서 수정하게 된다.
| 확인 단계 | 실제로 던진 질문 |
|---|---|
| 구현 전 | 이 기능이 없으면 사용자가 어느 순간에 멈추는가 |
| 구현 중 | 입력과 결과를 자동 테스트로 재현할 수 있는가 |
| 실제 기기 | 작은 화면·앱 재시작·느린 상황에서도 같은 흐름인가 |
| 출시 전 | 저장, 설명 문구, 스크린샷, 정책 중 함께 바뀌는 것은 무엇인가 |
기능을 완성했다는 판단도 화면이 보일 때가 아니라, 실패한 뒤 다시 들어왔을 때로 잡는 편이 낫다. 앱을 닫았다 다시 열고, 다른 보드나 다른 설정으로 바꾸고, 잘못된 입력도 줘 본다. 이 과정을 한 번 통과한 기능만 다음 단계로 넘기면 30일처럼 짧은 일정에서도 마지막 주의 불안을 크게 줄일 수 있다.
막혔을 때 다시 보는 기준
기대와 다른 결과가 나오면 코드를 더 붙이기 전에 조건을 줄인다. 가장 작은 보드나 가장 짧은 입력으로 문제를 재현하고, 그 상태를 테스트 이름으로 남긴다. “가끔 이상하다”는 기록은 다음 날에는 거의 도움이 되지 않지만, “빈칸이 하나 있는 행에서 왼쪽 이동 뒤 두 번째 병합이 사라진다”는 기록은 바로 수정으로 이어진다.
수정 뒤에는 원래 정상인 흐름도 한 번 더 돌린다. 버그 하나를 고치며 저장·점수·오버레이 순서가 바뀌는 일이 많았기 때문이다. 작아 보이는 기능일수록 이 확인을 건너뛰지 않는 편이 결과적으로 빠르다.
기록을 남긴 이유
이 단계의 판단은 다음 기능을 만들 때 다시 쓰기 위한 기준이기도 하다. 같은 문제를 검색해서 임시 답을 붙이기보다, 어떤 조건에서 선택했고 무엇을 확인했는지 남겨두면 프로젝트가 커져도 흔들리지 않는다. 이 글의 코드와 체크 항목은 그대로 복사하기보다 현재 앱의 상태·패키지 버전·배포 환경에 맞춰 한 번 더 검증해서 적용하는 것을 권한다.