이전 목록으로
#Flutter#Testing

Flutter 테스트 전략: Unit·Widget·Patrol·Maestro를 어디에 쓸까

Flutter의 Unit, Widget, Integration 테스트 역할을 구분하고 Patrol과 Maestro를 이용한 E2E 테스트의 장단점 및 현실적인 테스트 피라미드를 정리한다.

모든 흐름을 E2E로 검증하면 느리고 불안정하다. 반대로 Unit Test만 많으면 실제 화면과 플랫폼 권한 문제를 놓친다. 실패 원인을 가장 빠르게 설명할 수 있는 가장 낮은 단계의 테스트를 선택해야 한다.

flowchart BT
    A[많고 빠른 Unit Test] --> B[Widget Test]
    B --> C[Integration Test]
    C --> D[적고 중요한 E2E Smoke Test]
종류 검증 대상 장점 한계
Unit 변환·검증·상태 로직 빠르고 원인 명확 실제 UI 미검증
Widget 화면 상태와 동작 Flutter UI 검증 네이티브 화면 한계
Integration 앱 내부 흐름 여러 화면 연결 실행 비용 증가
E2E 실제 기기 전체 흐름 권한·스캔·외부 UI 검증 느리고 환경 의존적

Unit Test 예제

class BarcodeValidator {
  const BarcodeValidator();

  bool isValidWaybill(String value) {
    return RegExp(r'^\d{12}$').hasMatch(value);
  }
}
import 'package:flutter_test/flutter_test.dart';

void main() {
  const validator = BarcodeValidator();

  test('12자리 숫자 운송장은 유효하다', () {
    expect(validator.isValidWaybill('123456789012'), isTrue);
  });

  test('문자가 포함되면 유효하지 않다', () {
    expect(validator.isValidWaybill('12345678901A'), isFalse);
  });
}

Widget Test는 상태별 화면을 검증한다

testWidgets('로딩 중에는 완료 버튼이 비활성화된다', (tester) async {
  await tester.pumpWidget(
    const MaterialApp(home: CompleteButton(isSubmitting: true)),
  );

  final button = tester.widget<FilledButton>(find.byType(FilledButton));
  expect(button.onPressed, isNull);
});

Patrol과 Maestro

Patrol은 Flutter 테스트 코드와 네이티브 자동화를 연결하기 좋다. 알림, 권한 팝업, WebView처럼 Flutter 바깥의 UI를 다룰 때 유용하다.

Maestro는 YAML 기반 Flow가 간결해 QA 시나리오와 스모크 테스트를 빠르게 작성하기 좋다.

appId: com.example.app.stage
---
- launchApp
- tapOn: "로그인"
- tapOn: "배송목록"
- assertVisible: "오늘의 작업"

무엇을 E2E로 남길까

  • 로그인 → 핵심 목록 진입
  • 바코드 스캔 → 검증 → 완료
  • 사진·서명 입력 → 제출
  • 네트워크 실패 후 재시도
  • 권한 거부와 재허용
  • 앱 재실행 후 상태 복원

나머지 조합은 Unit과 Widget Test로 내리는 것이 유지보수에 유리하다.

테스트 가능성을 높이는 설계

  • API를 Repository 인터페이스 뒤에 둔다.
  • 시간과 UUID 생성을 주입한다.
  • 주요 버튼과 입력 필드에 안정적인 Key 또는 Semantics를 준다.
  • 테스트 데이터 생성기를 둔다.
  • 서버 상태에 의존하는 E2E 계정을 별도로 운영한다.

관련 문서

목록으로 돌아가기

다른 게시글

#Android#Flutter

현장 Flutter 앱 디버깅에 자주 쓴 ADB 명령어

기기 지정, Logcat, APK 설치, 파일 복사, 포트 reverse를 실기기 점검 흐름으로 정리한다.

#Android#Kotlin

Android 입력 장치 목록 조회하기: 키보드·마우스·HID 스캐너 구분

Android `InputManager`와 `InputDevice` API로 연결된 입력 장치를 조회하고, 키보드·포인터·외부 장치 여부를 판별하는 방법을 정리한다. USB·Bluetooth HID 바코드 스캐너를 일반 키보드와 구분할 때의 한계와 연결 변경 감지 방법도 함께 살펴본다.

#Android#Kotlin

Android 위치 권한과 FusedLocationProvider 실전 정리: 현재 위치·지속 추적·GPS 설정

Jetpack Compose 앱에서 Android 위치 권한을 요청하고, Fused Location Provider로 캐시 위치·일회성 현재 위치·지속 위치 업데이트를 처리하는 흐름을 정리한다. Android 12의 대략적·정확한 위치 선택, 백그라운드 위치 정책, GPS 설정 확인과 생명주기 연동까지 예제 코드로 살펴본다.