· Flutter 개발 · 7 min read
대각선으로 쓱 했는데 왜 움직여? 스와이프 오작동 잡기
GestureDetector로 2048 스와이프 방향을 안정적으로 판정한 과정.
짧은 탭과 대각선 드래그가 섞이면 의도하지 않은 이동이 자주 생긴다. 시작점과 종료점의 가로·세로 차이를 비교하고, 일정 거리보다 작은 제스처는 무시하도록 했다.
입력은 up, down, left, right 네 방향으로만 엔진에 전달했다. UI가 보드 내부 배열을 직접 만지지 않으니 제스처 임계값을 바꿔도 병합 테스트는 그대로 유지됐다.
스와이프 임계값은 실제 화면 밀도와 관계없이 체감이 일정해야 했다. 대각선 이동은 더 큰 축만 채택하고, 임계값 아래의 움직임은 무효 처리해 스크롤과 오조작을 줄였다.
내가 손가락을 비스듬히 긋는 습관이 있다는 것도 이때 알았다. 의도하지 않은 이동이 한 번 나오면 게임을 믿기 어려워져서 작은 입력도 그냥 넘길 수 없었다.
이 단계를 실제 Flutter 프로젝트에 적용하는 순서
이 글의 내용은 예제 코드를 한 번 실행해 보는 데서 끝내면 효과가 작다. 나는 기능을 붙이기 전에 “어떤 입력을 주면, 어떤 상태가 남아야 하는가”를 한 문장으로 적어 두었다. 이 문장이 있으면 구현 중에 화면이 조금 바뀌어도 무엇을 지켜야 하는지 놓치지 않는다. Mergrove에서는 한 번의 스와이프, 병합 결과, 점수 변화, 저장 시점처럼 눈에 보이는 결과와 내부 상태를 함께 확인했다.
작업 순서는 작게 잡는 편이 좋다. 먼저 순수 Dart 로직이나 데이터 모델에서 기대 결과를 만들고, 그 다음 Flutter 위젯에 연결한다. 마지막으로 실제 기기에서 손가락으로 조작해 본다. 이 순서가 필요한 이유는 오류가 났을 때 규칙 문제인지, 화면 문제인지, 기기 입력 문제인지 빠르게 나눌 수 있기 때문이다. 화면부터 만들고 나중에 규칙을 고치면 같은 버그를 여러 곳에서 수정하게 된다.
| 확인 단계 | 실제로 던진 질문 |
|---|---|
| 구현 전 | 이 기능이 없으면 사용자가 어느 순간에 멈추는가 |
| 구현 중 | 입력과 결과를 자동 테스트로 재현할 수 있는가 |
| 실제 기기 | 작은 화면·앱 재시작·느린 상황에서도 같은 흐름인가 |
| 출시 전 | 저장, 설명 문구, 스크린샷, 정책 중 함께 바뀌는 것은 무엇인가 |
기능을 완성했다는 판단도 화면이 보일 때가 아니라, 실패한 뒤 다시 들어왔을 때로 잡는 편이 낫다. 앱을 닫았다 다시 열고, 다른 보드나 다른 설정으로 바꾸고, 잘못된 입력도 줘 본다. 이 과정을 한 번 통과한 기능만 다음 단계로 넘기면 30일처럼 짧은 일정에서도 마지막 주의 불안을 크게 줄일 수 있다.
막혔을 때 다시 보는 기준
기대와 다른 결과가 나오면 코드를 더 붙이기 전에 조건을 줄인다. 가장 작은 보드나 가장 짧은 입력으로 문제를 재현하고, 그 상태를 테스트 이름으로 남긴다. “가끔 이상하다”는 기록은 다음 날에는 거의 도움이 되지 않지만, “빈칸이 하나 있는 행에서 왼쪽 이동 뒤 두 번째 병합이 사라진다”는 기록은 바로 수정으로 이어진다.
수정 뒤에는 원래 정상인 흐름도 한 번 더 돌린다. 버그 하나를 고치며 저장·점수·오버레이 순서가 바뀌는 일이 많았기 때문이다. 작아 보이는 기능일수록 이 확인을 건너뛰지 않는 편이 결과적으로 빠르다.
기록을 남긴 이유
이 단계의 판단은 다음 기능을 만들 때 다시 쓰기 위한 기준이기도 하다. 같은 문제를 검색해서 임시 답을 붙이기보다, 어떤 조건에서 선택했고 무엇을 확인했는지 남겨두면 프로젝트가 커져도 흔들리지 않는다. 이 글의 코드와 체크 항목은 그대로 복사하기보다 현재 앱의 상태·패키지 버전·배포 환경에 맞춰 한 번 더 검증해서 적용하는 것을 권한다.