Sobre o projeto

Mercury Device Farm é um laboratório de dispositivos reais baseado em navegador que permite aos usuários gerenciar dispositivos Android, iOS e Tizen a partir de um único workspace web. O projeto é otimizado para macOS, pois a automação de iOS requer as ferramentas do Xcode no host. Ele agrupa um backend baseado em Docker, uma interface web compilada e um provedor de iOS do lado do host em uma única imagem GHCR. Após instalar o lançador para macOS com o script de instalação fornecido, os usuários iniciam os serviços com o comando `~/.mercury‐farm/mercury up`. Para dispositivos iOS, é necessária uma etapa única de assinatura do WebDriverAgent no Xcode, após a qual o provedor instala e atualiza automaticamente o agente nos iPhones ou iPads pareados. A interface é acessada por meio de um domínio dinâmico (MERCURY_DOMAIN) e inclui páginas para listagem de dispositivos, controle remoto, configurações e registros de log. Um sistema de autenticação simulado fornece uma conta de administrador inicial. A ferramenta suporta atualizações para versões mais recentes preservando a configuração e os dados do MongoDB, e também permite reverter para uma versão específica. A documentação aborda recomendações de hardware (modelos de Mac mini, hubs USB alimentados, configuração de rede), preparação de dispositivos, tecnologias de transmissão de tela (Minicap/Scrcpy para Android, WebDriverAgent MJPEG para iOS), ajuste de largura de banda, execução paralela, integração com Appium, APIs de automação, arquitetura e solução de problemas. O backend e a CLI são licenciados sob Apache-2.0; a interface web é um submódulo privado proprietário não disponível publicamente.