mobile-next/mobilewright

해결하는 문제

Mobilewright는 iOS 및 Android 모바일 기기 자동화를 간소화합니다. Appium이나 네이티브 프레임워크와 같이 복잡하고 장황한 도구를 대체하며, 깔끔하고 자동 대기(auto-waiting) 기능을 갖춘 API를 제공합니다. 이를 통해 수동 대기나 복잡한 로케이터(XPath 등)의 필요성을 줄여, 신뢰성 높은 테스트를 작성하고 모바일 기기를 제어할 수 있는 AI 에이전트를 더 쉽게 구축할 수 있습니다.

작동 방식

mobilecli를 기반으로 구축된 Mobilewright는 실제 기기, 시뮬레이터, 에뮬레이터와 상호 작용하기 위한 통합 인터페이스를 제공합니다. 기기의 접근성 트리를 노출하여 사용자가 좌표 대신 의미론적 역할(semantic roles), 레이블, 텍스트를 통해 요소를 찾을 수 있게 합니다. 하이브리드 앱의 경우 DOM으로 브릿지하여 웹 콘텐츠를 위한 Playwright 호환 Page 객체를 제공합니다. 또한 Xcode 및 Android SDK와 같은 환경 종속성을 확인하기 위한 doctor CLI 도구도 포함되어 있습니다.

대상 사용자

• QA 엔지니어 및 개발자: 모바일 테스트에서 Playwright와 유사한 개발자 경험을 원하는 분.
• AI 에이전트 개발자: 비전 모델에 의존하지 않고 결정론적이며 토큰 효율적인 방식으로 에이전트가 모바일 화면을 인식하고 상호 작용해야 하는 분.
• 크로스 플랫폼 팀: iOS와 Android 모두를 타겟팅하는 단일 API가 필요한 팀.

주요 특징

• Playwright 스타일 API: getByRole, getByText, expect 단언문 등 익숙한 패턴 사용.
• AI 준비 완료: 결정론적인 에이전트 제어를 위해 접근성 트리에 직접 액세스 제공.
• 자동 대기: 요소가 표시되고 활성화되며 안정될 때까지 자동으로 대기.
• 하이브리드 앱 지원: 표준 Playwright API를 사용하여 네이티브 뷰와 WebView 간을 원활하게 전환.
• 크로스 플랫폼: iOS 및 Android 기기와 에뮬레이터를 위한 통합 인터페이스.
• 제로 설정: 실행 중인 시뮬레이터를 자동으로 검색.