Skip to content

v0.3.8 — flutter-driver-e2e skill

Choose a tag to compare

@mstagon mstagon released this 21 Apr 06:31
· 234 commits to main since this release

Added

flutter-driver-e2e 스킬 — 시뮬레이터/디바이스에서 도는 Flutter 앱을 Playwright 스타일 idiom으로 제어하는 패턴집.

새 MCP 래퍼 대신 이미 있는 mcp__dart 프리미티브(launch_app, flutter_driver, get_widget_tree, get_runtime_errors 등) 위에 DSL + 레시피를 얹는 방식.

내용

  • 선택자 매핑 — Playwright locator ↔ Flutter find.byKey / byType / text
  • Wait/Settle idiom — pumpAndSettle vs driver.waitFor 구분
  • mcp__dart 툴 체이닝 — launch_app → widget_tree → flutter_driver → runtime_errors 표준 플로우
  • Canonical E2E 템플릿 — 로그인 → 홈 → 상세 전형 예제
  • Key 네이밍 컨벤션 — {screen}-{role} 규칙
  • 디버깅 플레이북 — 빈 finder, timeout, CI flakiness 대응
  • Anti-patterns — Future.delayed 타이밍 맞추기, find.text만 의존, 과도한 플로우 등

자동 주입

파일 편집 시 skill-injector.sh가 자동 매칭:

  • integration_test/**
  • **_e2e_test.dart
  • **_driver.dart

Impact

  • 신규 워크스페이스: 즉시 반영
  • 기존 워크스페이스: Update Harness 실행