Robot Runner

통합 기기 제어

USB 및 Wi-Fi를 통한 기기 자동 감지, Android 11 이상의 페어링 코드를 활용한 무선 연결, ngrok 터널링을 통한 원격 기기 테스트 지원, 그리고 scrcpy 기반의 저지연 화면 미러링을 제공합니다.

UI 검사 및 로케이터 전략

화면 미러링에서 직접 요소를 선택해 최적화된 XPath와 UiSelector 체인 로케이터를 즉시 생성합니다. resource-id, content-desc, text 우선순위에 따른 자동 후보 추천과 AI 로직을 활용한 안정적인 UI 로케이터 자동 평가 및 추출 기능을 갖추고 있습니다.

실시간 진단 및 성능 모니터링

패키지 기반 필터링과 검색이 가능한 실시간 Logcat, CPU 사용량, RAM 소비량, 배터리 상태의 실시간 추적, 그리고 테스트 대상 앱의 리소스 사용량 모니터링을 수행합니다.

AI 기반 매핑과 테스트 설계

앱 화면, 모달, 드로어를 자동으로 탐색하여 디지털 트윈을 생성하는 매퍼와, 자연어 설명이나 녹화된 동작을 Robot Framework BDD 스크립트로 변환하는 AI 생성기를 제공합니다. Gemini, Claude, OpenAI 등 다양한 모델 연결을 지원합니다.

전문적인 테스트 실행

개별 .robot 파일, 디렉터리, .args 구성에 대한 실행 모드를 지원하며, 애플리케이션 내부에서 실행 결과를 실시간으로 확인할 수 있는 콘솔을 제공합니다. 프로젝트 설정을 빠르게 전환하는 구성 프로필과 상세 실행 이력도 포함됩니다.

설치·시작·기본 사용

Robot Runner는 winget을 통해 설치할 수 있습니다.

winget install --id lucasdeeiroz.RobotRunner --exact

애플리케이션을 실행한 후 USB 또는 Wi-Fi로 안드로이드 기기를 연결합니다. 인스펙터를 통해 화면 미러링과 UI 요소 선택, 로케이터 생성을 진행합니다. 테스트 탭에서 개별 .robot 파일, 디렉터리, .args 구성을 선택해 실행합니다.

활용 예시

• Robot Framework와 Appium 기반의 안드로이드 UI 테스트를 GUI에서 한 번에 구성하고 실행합니다.
• 실제 기기나 원격 기기에서 화면을 미러링하며 요소를 선택해 로케이터를 빠르게 작성합니다.
• Logcat과 CPU/RAM/배터리 지표를 동시에 확인하면서 성능 회귀를 추적합니다.
• AI 생성기를 활용해 자연어 시나리오를 BDD 스크립트로 변환해 회귀 테스트 자산을 생산합니다.

제한·라이선스·확인사항

이 프로젝트는 비상업적/재판매 금지 조건의 라이선스로 배포됩니다. 무료 사용, 수정, 재배포가 가능하지만 원본 저장소에 대한 크레딧과 링크를 유지해야 합니다. 영리 목적의 판매나 라이선싱은 서면 허가가 필요합니다.