프로젝트 소개

Mercury Device Farm은 사용자가 단일 웹 워크스페이스에서 Android, iOS 및 Tizen 기기를 관리할 수 있게 해 주는 브라우저 기반 실제 기기 입니다. 이 프로젝트는 iOS 자동화에 호스트의 Xcode 도구가 필요하기 때문에 macOS에 최적화되어 있습니다. Docker 기반 백엔드, 컴파일된 웹 UI, 호스트 측 iOS provider를 단일 GHCR 이미지로 묶어 제공합니다. 제공된 설치 스크립트로 macOS 처를 설치한 후 사용자는 `~/.mercury‑farm/mercury up`으로 서비스를 시작합니다. iOS 기기의 경우 Xcode에서 일회성 WebDriverAgent 서명 단계가 필요하며, 이후 provider가 페어링된 iPhone 또는 iPad에 에이전트를 자동으로 설치하고 업데이트합니다. UI는 동적 도메인(MERCURY_DOMAIN)을 통해 접속하며 기기 목록, 원격 제어, 설정 및 로깅 페이지를 포함합니다. 모의 인증 시스템은 초기 admin 계정을 제공합니다. 이 도구는 구성과 MongoDB 데이터를 보존하면서 최신 릴리스로 업데이트하는 것을 지원하며, 특정 버전으로 롤백할 수도 있습니다. 문서는 하드웨어 권장 사항(Mac mini 모델, 전원 공급 USB 허브, 네트워크 설정), 기기 준비, 화면 스트리밍 기술(Android용 Minicap/Scrcpy, iOS용 WebDriverAgent MJPEG), 대역폭 튜닝, 병렬 실행, Appium 통합, 자동화 API, 아키텍처 및 문제 해결을 다룹니다. 백엔드와 CLI는 Apache‑2.0 라이선스이며, 웹 UI는 공개적으로 제공되지 않는 독점 비공개 서브모듈입니다.