mobile-next/mobilewright

해결하는 문제

Mobilewright는 iOS 및 Android 디바이스를 자동화하기 위한 프레임워크로, Appium이나 Detox과 같은 복잡한 설정을 대체하도록 설계되었습니다. 다양한 모바일 운영체제에서 동작하는 테스트나 자동화 스크립트를 작성할 수 있도록 통합된 크로스플랫폼 API를 제공하며, 각 작업마다 플랫폼별 코드를 따로 작성할 필요가 없습니다.

작동 방식

mobilecli 위에 구축된 Mobilewright는 Playwright를 영감으로 삼은 아키텍처를 사용합니다. 원시 좌표나 비전 모델에 의존하는 대신, UI의 결정론적이고 의미 있는 표현인 접근성 트리와 상호작용합니다. 이로 인해 탭, 텍스트 입력, 스와이프와 같은 작업을 높은 신뢰도로 수행할 수 있습니다.

하이브리드 앱의 경우, WebView의 DOM에 연결하여 네이티브 앱 내에 포함된 웹 콘텐츠에 대해 완전히 Playwright 호환 Page API를 제공할 수 있습니다.

대상 사용자

• QA 엔지니어 및 개발자: 모바일 자동화를 위해 Playwright와 유사한 개발자 경험을 원하는 사람. 내장된 자동 대기 및 의미 기반 로케이터를 제공합니다.
• AI 에이전트 개발자: 모바일 폰을 제어해야 하는 에이전트를 개발하는 사람. 접근성 트리를 노출함으로써, 스크린샷을 처리하는 대신 토큰 효율적이고 읽기 쉬운 의미 기반 동작을 통해 디바이스와 상호작용할 수 있습니다.

주요 특징

• Playwright 스타일 API: getByRole 및 expect와 같은 익숙한 메서드를 사용하여 요소 탐색 및 검증이 가능합니다.
• 자동 대기: 요소가 보이게, 활성화되고 안정될 때까지 자동으로 대기한 후 작업을 수행합니다.
• 크로스플랫폼: iOS 및 Android 디바이스, 시뮬레이터, 에뮬레이터에 대해 동일한 API를 사용합니다.
• AI 준비 완료: 접근성 트리를 통해 AI 에이전트에 대한 최고 수준의 지원을 제공하며, 비전 모델이 필요하지 않습니다.
• 하이브리드 앱 지원: 네이티브 자동화에서 WebViews 내 웹 자동화로 원활하게 전환 가능합니다.
• 제로 구성: 부팅된 시뮬레이터 및 에뮬레이터를 자동으로 탐지합니다.