대각선으로 쓱 했는데 왜 움직여? 스와이프 오작동 잡기

개발 과정 참고 이미지

이미지 출처: Unsplash · Penfer

짧은 탭과 대각선 드래그가 섞이면 의도하지 않은 이동이 자주 생긴다. 시작점과 종료점의 가로·세로 차이를 비교하고, 일정 거리보다 작은 제스처는 무시하도록 했다.

입력은 up, down, left, right 네 방향으로만 엔진에 전달했다. UI가 보드 내부 배열을 직접 만지지 않으니 제스처 임계값을 바꿔도 병합 테스트는 그대로 유지됐다.

스와이프 임계값은 실제 화면 밀도와 관계없이 체감이 일정해야 했다. 대각선 이동은 더 큰 축만 채택하고, 임계값 아래의 움직임은 무효 처리해 스크롤과 오조작을 줄였다.

내가 손가락을 비스듬히 긋는 습관이 있다는 것도 이때 알았다. 의도하지 않은 이동이 한 번 나오면 게임을 믿기 어려워져서 작은 입력도 그냥 넘길 수 없었다.

이 단계를 실제 Flutter 프로젝트에 적용하는 순서

이 글의 내용은 예제 코드를 한 번 실행해 보는 데서 끝내면 효과가 작다. 나는 기능을 붙이기 전에 “어떤 입력을 주면, 어떤 상태가 남아야 하는가”를 한 문장으로 적어 두었다. 이 문장이 있으면 구현 중에 화면이 조금 바뀌어도 무엇을 지켜야 하는지 놓치지 않는다. Mergrove에서는 한 번의 스와이프, 병합 결과, 점수 변화, 저장 시점처럼 눈에 보이는 결과와 내부 상태를 함께 확인했다.

작업 순서는 작게 잡는 편이 좋다. 먼저 순수 Dart 로직이나 데이터 모델에서 기대 결과를 만들고, 그 다음 Flutter 위젯에 연결한다. 마지막으로 실제 기기에서 손가락으로 조작해 본다. 이 순서가 필요한 이유는 오류가 났을 때 규칙 문제인지, 화면 문제인지, 기기 입력 문제인지 빠르게 나눌 수 있기 때문이다. 화면부터 만들고 나중에 규칙을 고치면 같은 버그를 여러 곳에서 수정하게 된다.

확인 단계 실제로 던진 질문
구현 전 이 기능이 없으면 사용자가 어느 순간에 멈추는가
구현 중 입력과 결과를 자동 테스트로 재현할 수 있는가
실제 기기 작은 화면·앱 재시작·느린 상황에서도 같은 흐름인가
출시 전 저장, 설명 문구, 스크린샷, 정책 중 함께 바뀌는 것은 무엇인가

기능을 완성했다는 판단도 화면이 보일 때가 아니라, 실패한 뒤 다시 들어왔을 때로 잡는 편이 낫다. 앱을 닫았다 다시 열고, 다른 보드나 다른 설정으로 바꾸고, 잘못된 입력도 줘 본다. 이 과정을 한 번 통과한 기능만 다음 단계로 넘기면 30일처럼 짧은 일정에서도 마지막 주의 불안을 크게 줄일 수 있다.

막혔을 때 다시 보는 기준

기대와 다른 결과가 나오면 코드를 더 붙이기 전에 조건을 줄인다. 가장 작은 보드나 가장 짧은 입력으로 문제를 재현하고, 그 상태를 테스트 이름으로 남긴다. “가끔 이상하다”는 기록은 다음 날에는 거의 도움이 되지 않지만, “빈칸이 하나 있는 행에서 왼쪽 이동 뒤 두 번째 병합이 사라진다”는 기록은 바로 수정으로 이어진다.

수정 뒤에는 원래 정상인 흐름도 한 번 더 돌린다. 버그 하나를 고치며 저장·점수·오버레이 순서가 바뀌는 일이 많았기 때문이다. 작아 보이는 기능일수록 이 확인을 건너뛰지 않는 편이 결과적으로 빠르다.

기록을 남긴 이유

이 단계의 판단은 다음 기능을 만들 때 다시 쓰기 위한 기준이기도 하다. 같은 문제를 검색해서 임시 답을 붙이기보다, 어떤 조건에서 선택했고 무엇을 확인했는지 남겨두면 프로젝트가 커져도 흔들리지 않는다. 이 글의 코드와 체크 항목은 그대로 복사하기보다 현재 앱의 상태·패키지 버전·배포 환경에 맞춰 한 번 더 검증해서 적용하는 것을 권한다.

참고 자료

Flutter 테스트 개요 · Flutter 통합 테스트 안내

Google Play에서 Mergrove 설치하기