patrol_log은 Flutter 네이티브 UI 테스팅 프레임워크인 Patrol을 위한 로깅 패키지입니다. 자동화된 UI 테스트 중에 상세하고 구조화된 로깅을 가능하게 하여 개발자가 테스트 실패를 디버그하고 앱의 동작을 실시간으로 모니터링하는 데 도움을 줍니다. Patrol 전용으로 설계되어 Android, iOS, Linux, macOS, Web, Windows 등 여러 플랫폼에서 테스트 워크플로우에 원활하게 통합됩니다. 타임스탬프, 테스트 컨텍스트 및 실행 가능한 인사이트를 포함한 풍부한 로그 출력을 지원하여 테스트의 신뢰성과 유지보수성을 향상시킵니다. Flutter 애플리케이션에서 견고한 엔드투엔드 테스팅을 실천하는 팀에게 이상적입니다.
사용 사례
UI 테스트 실패 디버깅
테스트 실행 흐름 모니터링
테스트 중 런타임 앱 상태 캡처
로그를 통한 테스트 보고서 개선
CI/CD 파이프라인과의 통합
주요 기능
UI 테스트를 위한 구조화된 로깅
실시간 로그 스트리밍
크로스 플랫폼 지원
컨텍스트 인식 메시지 테스트
Patrol 프레임워크와의 원활한 통합
적합한 대상
UI 테스트에 Patrol을 사용하는 Flutter 팀
세부 테스트 진단이 필요한 개발자
추적 가능한 테스트 로그가 필요한 CI/CD 환경
신뢰할 수 있는 엔드 투 엔드 테스트에 집중하는 팀
고려 사항
패트롤 프레임워크가 설치되어 있어야 합니다
패트롤 기반 테스트 세트 외부에서의 제한된 사용
테스트 실행의 자세함을 증가시킬 수 있습니다
개발 및 스테이징 환경에서 가장 잘 사용됩니다
원본 README
연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.
Patrol
A powerful, multiplatform E2E UI testing framework for Flutter apps that overcomes the limitations of integration_test by handling native interactions. Developed by LeanCode since 2022, battle-tested and shaped by production-grade experience.
Patrol is an open-source framework created and maintained by LeanCode.
However, if your company wants to scale fast and accelerate Patrol’s
adoption, we offer a set of value-added services on top of the core framework.
[!NOTE]
Patrol 4.7.0 adds Swift Package Manager support for iOS and macOS!
If you migrate your project to SPM, a few small setup changes are needed — see the iOS setup guide for details.
Patrol custom finders
Flutter's finders are powerful, but not very intuitive to use.
We took them and made something awesome.
Thanks to Patrol's custom finders, you'll take your tests from this:
Flutter's default integration_test package can't interact with the OS your
Flutter app is running on. This makes it impossible to test many critical
business features, such as:
granting runtime permissions
signing into the app which through WebView or Google Services
The CLI is needed to enable Patrol's native automation feature in integration
tests. It also makes development of integration tests much faster thanks to [Hot
Restart].
To run widget tests, you can continue to use flutter test.
See .github/WORKFLOWS.md for detailed documentation about all GitHub Actions workflows, including test schedules, Flutter versions, and deployment pipelines.