Testing on Headless CI Systems (Travis CI, Jenkins)
Sendo baseado no Chromium, o Electron necessita de um driver de vídeo para rodar. If Chromium can't find a display driver, Electron will fail to launch - and therefore not executing any of your tests, regardless of how you are running them. Testing Electron-based apps on Travis, CircleCI, Jenkins or similar Systems requires therefore a little bit of configuration. Basicamente, precisamos usar um driver de vídeo virtual.
Configurando o Servidor de Vídeo Virtual
Primeiramente instale o Xvfb. É um framebuffer que implementa o protocolo de servidor de vídeo do X11 - ele realiza todas as operações gráficas na memória sem mostrar nenhuma mensagem, o que é exatamente o que precisamos.
Then, create a virtual Xvfb screen and export an environment variable called DISPLAY that points to it. No Electron o Chromium irá procurar automaticamente pela variável $DISPLAY
, sendo assim dispensáveis configurações adicionais em seu aplicativo. Esta etapa pode ser automatizada com o pacote xvfb-maybe: Preceda seus comandos de teste com xvfb-maybe
e a ferramenta fará a configuração automaticamente do Xvfb, se requerido pelo sistema. On Windows or macOS, it will do nothing.
## On Windows or macOS, this invokes electron-mocha
## On Linux, if we are in a headless environment, this will be equivalent
## to xvfb-run electron-mocha ./test/*.js
xvfb-maybe electron-mocha ./test/*.js
Travis CI
For Travis, see its docs on using Xvfb.
Jenkins
Para o Jenkins, um plugin Xvfb está disponível.
CircleCI
CircleCI is awesome and has Xvfb and $DISPLAY
already set up, so no further configuration is required.
AppVeyor
AppVeyor roda no Windows, tendo suporte para Selenium, Chomium, Electron e ferramentas similares de fora - configuração adicional é dispensada.