Instale o Nexus Studio e execute seu primeiro teste

Sete passos levam um novo trial até uma execução agendada. As seções seguintes trazem os detalhes: baixar o instalador, verificá-lo, ativar esta máquina, executar um teste. Os testes são executados na sua máquina; a única coisa que sai dela é a verificação de licença.

Seus primeiros 7 minutos

De um novo trial a uma execução agendada, na ordem que o Studio espera. A primeira configuração baixa os navegadores, várias centenas de MB, então o tempo necessário depende da sua conexão.

1. Inicie o trial e instale. Entre na sua conta, aceite os Termos e inicie o trial de 30 dias, sem cartão. Baixe o instalador, verifique o SHA-256, execute-o e ative esta máquina com a sua chave de licença. Depois abra ou crie uma pasta de workspace e escolha Install all no guia de Setup (detalhes).
2. Grave seu primeiro teste (Nexus Recorder). Em Patrol, abra a aba Nexus Recorder, informe a URL a gravar e um nome para o teste, e escolha Start recording. Clique pelo seu fluxo na janela do navegador que se abrir e depois feche a janela ou escolha Stop & save. O Studio grava o arquivo do teste no seu workspace. O AI writer e o Test Adapter também criam testes, se você preferir descrever um ou trazer um que já tenha.
3. Ensaie no sandbox (3 execuções). Quando a gravação for salva, escolha Run in sandbox, headed. Uma execução no sandbox não grava nada em evidências nem no History, e cada um dos três ensaios usa um navegador diferente. O card Waiting to leave the sandbox do Patrol os conta de 0/3 a 3/3, e o teste passa então para Ready for their first real run. Testes de API não têm sandbox: eles são executados de verdade na primeira vez.
4. Primeira execução real. Na aba Run patrol, escolha o teste, deixe sandbox desmarcado e escolha Run patrol for real. Uma execução real grava em evidências e no History. Os testes Playwright são executados em Chromium, Firefox e WebKit, e os testes Selenium em Chromium e Firefox.
5. Leia o veredicto. O Patrol colore cada teste pelo seu estado em cada navegador, e a faixa de execução sobre o editor diz em palavras o que cada navegador está fazendo. O estado é um dos 14 veredictos: SECURE passou por conta própria, FLAKY passou apenas em uma nova tentativa, BREACHED é uma descoberta real, e TIMEOUT nunca respondeu a tempo, o que não é prova de que esteja quebrado.
6. Abra a evidência. Na barra de menus, escolha View e depois Evidence Locker. Cada registro abre em Report, Metadata, Telemetry e Raw Log. Marque uma falha como Real bug ou False alarm, com um motivo: o primeiro veredicto inicia a cadeia de custódia, e o Verify aponta o primeiro registro que mudou.
7. Agende (Watch ou CI/CD). O Watch, na aba Run patrol, reexecuta uma seleção por temporizador, sem supervisão: de 5 minutos a 24 horas, ou uma vez em uma data. Ele exige que a máquina do Studio esteja ligada e envia alertas no Telegram ou no Slack, se você os conectar, somente quando um estado muda. Para um pipeline, escolha Run e depois Environments & CI/CD: a tela escreve o arquivo do GitHub Actions ou do GitLab CI (Execute seus testes a partir do CI/CD). Uma máquina que executa o engine no CI é uma máquina ativada e conta para o seu plano.

Requisitos do sistema

No Windows 11 x64 com 16 GB de RAM, o instalador é tudo de que esta máquina precisa para rodar testes Playwright. Cada linha marcada como Opcional só é necessária para o recurso que ela nomeia, e a tela Setup do Studio a verifica.

Baixe o instalador

1. Abra Download e escolha Download for Windows. A página mostra a versão, a data de lançamento, o tamanho e o SHA-256. O mesmo instalador está em Downloads na sua conta.
2. Ainda não tem licença? Entre na sua conta, com seu e-mail ou com o Google, e em Overview aceite os Termos e inicie o teste de 30 dias. Os 30 dias só começam quando você ativa o Studio.

Verifique o arquivo baixado

O SHA-256 na página Download é a impressão digital do instalador que publicamos. Compare-o com o arquivo que você baixou antes de executá-lo. No PowerShell, na pasta que contém o arquivo:

(Get-FileHash -Algorithm SHA256 ".\<installer file name>").Hash -eq "<SHA-256 from the Download page>"

True significa que o arquivo é o que publicamos; não há distinção entre maiúsculas e minúsculas. False significa que não é: exclua o arquivo, baixe-o novamente e não o execute.

O Windows SmartScreen pode bloquear um novo instalador com a mensagem “O Windows protegeu o computador”. Prossiga somente se a verificação indicar True: escolha Mais informações e depois Executar assim mesmo.

Ative esta máquina

1. Execute o instalador e depois abra o Nexus Studio.
2. Copie sua chave de licença. Sua conta a exibe uma única vez: logo após você iniciar o período de avaliação ou quando escolher Obter chave de licença em Licença & máquinas em um plano pago. Armazenamos apenas um hash da chave, então, se você a perder, gere uma nova.
3. Até ser ativado, o Studio abre na tela Licença. Cole a chave no campo de chave de licença e escolha Ativar. A chave começa com nxs_live_ e tem 61 caracteres; espaços e quebras de linha incluídos ao copiar são ignorados.
4. O status mostra Active. Em um teste, os 30 dias começam agora.

A chave é enviada uma única vez para ativar esta máquina, e o Studio não a armazena. A partir daí, o Studio confirma sua licença automaticamente. A mesma tela mostra, em O que sai desta máquina, a solicitação exata que a próxima verificação enviará (o que ela contém).

Se a ativação for recusada, a mensagem diz o motivo: a chave não é válida, todas as máquinas do plano estão em uso, esta máquina já teve um teste, a licença não está em dia ou o servidor de licenças não pode ser alcançado.

Abra um workspace e execute o Setup

Esta parte acontece na sua máquina, e nunca temos acesso a ela: nem ao teste, nem ao resultado.

1. Abra uma pasta. Seus testes e evidências ficam em uma única pasta de espaço de trabalho. Escolha Nova pasta e Criar aqui, ou Abrir existente para uma pasta que já seja um espaço de trabalho.
2. Setup. O workspace instala seus pacotes e navegadores uma única vez, com npm install e playwright install. No guia de Setup, Install all executa o que ainda falta, um passo após o outro, e Continue é liberado quando todas as linhas obrigatórias estão prontas. Isso precisa de rede; depois, o workspace funciona offline, exceto pela verificação de licença. O adb só é necessário para celulares Android reais.
3. Depois, o teste em si. Crie-o, ensaie-o, execute-o de verdade e leia o veredicto: passos 2 a 6 de Seus primeiros 7 minutos.

A Visita guiada pelo Studio mostra todas as telas.

Atualizações

As atualizações nunca são automáticas: nada é baixado ou instalado até você escolher Update now. Depois, basta um clique.

1. Quando uma versão mais nova é publicada, o Studio mostra uma linha abaixo da barra de menus: Nexus Studio e a versão, is available, com Update now e Later. O aviso chega assinado, junto com a verificação da licença; o Studio não mostra nada para uma atualização que não consegue verificar.
2. Nada é baixado até você escolher Update now. O Studio então baixa o instalador por HTTPS de downloads.sentinel-nexusstudio.com e confere o SHA-256 com o aviso assinado. O aviso não custa nenhuma conexão própria, e o download é a única conexão fora da verificação de licença.
3. Quando a verificação passa, o Studio fecha, a nova versão é instalada sem perguntas a responder, apenas uma barra de progresso, e o Studio abre novamente. Quando a verificação falha, o arquivo é excluído, nada é instalado, e a linha explica o motivo e oferece Try again.
4. Após a atualização, a cópia do engine dentro de cada workspace se atualiza sozinha para a nova versão. Seus testes, evidências e configurações não são alterados.

Onde executar

O Studio roda no seu próprio PC com Windows 11, e nada mais é necessário.

• Seu próprio PC. Instale o Studio, abra um workspace e execute. As execuções agendadas só acontecem enquanto o PC estiver ligado.
• Um mini PC, opcional. Uma máquina Windows 11 dedicada que fica sempre ligada, para regressões noturnas e execuções agendadas sem ocupar uma estação de trabalho. O Watch mantém seu agendamento, e as evidências ficam no disco dela.
• Um runtime por workspace. Cada workspace escolhe onde o engine executa suas suítes, na tela Docker do Studio: esta máquina; Docker nesta máquina, no container do runner, no mesmo disco; ou uma VPS via SSH, rodando a mesma imagem de container. Duas aplicações sob teste em dois workspaces podem usar dois runtimes diferentes. Nenhum dos três é obrigatório, e trocar é uma única configuração. O Studio em si sempre fica no Windows.
• Uma VPS roda Ubuntu 24.04 LTS com Docker Engine e Compose v2, acessada com autenticação por chave SSH. As evidências ficam lá até você buscá-las. Ela verifica a própria licença e conta como uma máquina do seu plano: veja planos e máquinas.
• Celulares Android reais se conectam à própria máquina do Studio por USB, com a depuração USB ativada; Dispositivos & dispositivos móveis tem um guia para conectar o primeiro. As execuções em celulares, as suítes Selenium e Python e os testes de caos de infraestrutura sempre são executados na própria máquina do Studio.

O Watch, o agendador, roda apenas na própria máquina do Studio, com o runtime do workspace em Local. Para agendar execuções em uma VPS, use seu CI: Execute seus testes pelo CI/CD.

Tenha controle da sua infraestrutura ajuda você a escolher entre essas configurações e compara suas próprias máquinas com uma plataforma de garantia de qualidade na nuvem e um servidor alugado: onde ficam as evidências, quem pode acessá-las e quanto custa.

Como o Nexus Studio testa localhost sem um túnel?

Seu próprio appliance de QA. Sem túnel, sem URL de staging exposta, sem dados de teste saindo da sua rede. Roda em Windows 11, Ubuntu 24.04 LTS, Docker ou SSH. BASE_URL aponta a suíte para o seu app em localhost ou em uma URL de staging privada, como ele está.

• Um servidor de desenvolvimento que continua em execução após os testes.

  NEXUS_APP_START inicia seu aplicativo antes de cada execução e o encerra junto com toda a árvore de processos quando a execução termina, falha ou é interrompida, inclusive por Ctrl+C.

• Uma execução aprovada com um aplicativo que nem chegou a iniciar.

  A execução aguarda até que a URL de prontidão responda com qualquer status abaixo de 500, consultando a cada 0.5 s. Se o aplicativo não conseguir iniciar, a execução nem começa: CONFIG_ERROR APP_DID_NOT_START, com as últimas 40 linhas de log.

• Uma segunda cópia de um aplicativo que já está em execução.

  NEXUS_APP_REUSE=true usa um aplicativo que já responde e o mantém em execução; false interrompe a execução se outra coisa responder ali.

• Um resultado que ninguém consegue associar a uma compilação.

  Cada execução registra a versão do package.json do seu aplicativo e o commit do git que foi testado.

• Docker e SSH.

  No Docker, o aplicativo continua rodando nesta máquina, e o contêiner acessa uma BASE_URL de localhost como host.docker.internal. Via SSH, ele inicia no host remoto.

Um programa e seus argumentos, sem shell: npm run dev, pnpm dev ou node server.js. nexus app check, Testar no Studio, inicia o aplicativo, aguarda e o encerra. O log completo fica em evidence/run-context/.