Pular para o conteúdo principal
Uma prévia do Browser é um link privado para uma aplicação web em execução na máquina do Devin. Quando o Devin inicia um servidor de desenvolvimento em uma sessão, ele pode expor a porta e fornecer um link para você abrir no seu navegador. As prévias funcionam com qualquer stack de tecnologia. Se a aplicação serve HTTP em uma porta, o Devin consegue gerar uma prévia dela. O app e seus dados permanecem na máquina do Devin: nada é enviado a um serviço de terceiros.
Esta página trata de prévias em sessões do Devin. Para prévias de um servidor de desenvolvimento local no Devin Desktop, consulte Pré-visualização do Devin Desktop.

Como abrir uma prévia

O Devin abre uma prévia quando inicia um app que você precisa conferir. Você também pode pedir uma, por exemplo: “preview the app”. O Devin publica um cartão Open preview no chat. Clique nele para abrir o app na aba Preview da sessão. Para abrir a prévia em uma nova aba do navegador, use Cmd-clique, Ctrl-clique ou clique com o botão do meio no cartão. Em uma sessão iniciada pelo Slack, a thread recebe um link Open preview.

URLs de prévia

Uma URL de prévia tem este formato:
O nome vem do nome que o Devin atribui à prévia. O id é aleatório, então não é possível adivinhar a URL. A URL pertence à sessão. Ela continua a mesma se o Devin reiniciar o app ou movê-lo para outra porta. Uma prévia em outra sessão recebe uma URL diferente. As URLs de prévia também permitem acessar individualmente as portas que o devin expõe na máquina, usando uma sintaxe alternativa:
Essas portas precisam ser expostas pelo Devin, mas, depois de expostas, ficam acessíveis publicamente.

Quem pode abrir uma prévia

As Pré-visualizações são privadas. Nada fica exposto na internet pública. Qualquer pessoa que abrir a URL de uma prévia precisa estar conectada ao Devin. Além disso, a prévia segue as permissões de acesso da sessão correspondente. Se você pode enviar mensagens para a sessão, também pode abrir a prévia dela. Por padrão, isso inclui todas as pessoas da sua organização que podem usar sessões do Devin, então basta enviar o link para alguém da equipe e tudo funciona. Se a sessão estiver restrita ao proprietário ou a pessoas específicas, somente essas pessoas poderão abrir a prévia. As demais verão uma página informando que a prévia está indisponível.

O que você pode fazer na aba Prévia

A aba Prévia funciona como um pequeno navegador. Ela tem botões para avançar, voltar, recarregar, aplicar zoom e localizar na página, além de um seletor de tamanho de dispositivo com larguras de desktop, tablet e celular. Você também pode fazer anotações na página e dizer ao Devin o que alterar. Ao usar o botão “Selecionando” em uma sessão, basta clicar em um elemento ou arrastar sobre uma área, adicionar uma nota e enviá-la para o chat. O Devin recebe o elemento que você selecionou junto com a sua nota.

Apps com mais de uma porta

Uma prévia pode abranger várias portas, como um frontend em uma porta e uma API de backend em outra. O Devin lista todas elas ao abrir a prévia, que é aberta na primeira porta. Use o menu Ports na aba Preview para alternar entre elas. Seu frontend não precisa conhecer a URL da prévia. Se a página chamar http://localhost:8000, a prévia encaminha essa requisição para a porta 8000 na máquina do Devin. Um service worker instalado pela prévia reescreve essas requisições no seu navegador, e as conexões WebSocket são tratadas da mesma forma. Como a requisição permanece no próprio endereço da prévia, não é necessário alterar as configurações de CORS. Isso funciona apenas com as portas que o Devin expôs para a prévia.

O que seu app vê

Para o seu servidor, a requisição vem de localhost. A prévia define os cabeçalhos Host e Origin como localhost antes que a requisição chegue ao seu app, de modo que servidores de desenvolvimento que verificam o nome do host funcionam sem configuração adicional. O Devin também continua usando localhost, tanto ao executar o app quanto ao testá-lo. Algumas coisas funcionam de forma diferente em relação a executar o app no seu próprio computador:
  • Service workers. A prévia usa um service worker próprio, então seu app não consegue registrar outro. Se o seu app for um PWA, desative o service worker em desenvolvimento ou esteja ciente de que a reescrita automática de portas pode não funcionar.
  • Cookies. Os cookies que seu app define dentro da aba Preview ficam separados dos cookies definidos quando a prévia está aberta em uma aba própria do navegador. Se você fizer login no seu app em um desses lugares, talvez precise fazer login novamente no outro.
  • Login com um provedor de identidade. Seu navegador está na URL da prévia, não em localhost. Provedores como Microsoft Entra ID, Okta ou Google rejeitam o login se apenas localhost estiver registrado como URL de redirecionamento. Consulte Tunneling Ports.
  • Servidores de desenvolvimento HTTPS. Seu navegador vê o certificado do Devin, e não o do seu servidor. Consulte HTTPS Loopback.

Tunelamento de portas

Alguns serviços só funcionam quando o seu navegador está de fato em localhost. O caso mais comum é o login por meio de um provedor de identidade. O provedor só aceita as URLs de redirecionamento que você registrou, e a maioria das configurações de desenvolvimento registra http://localhost:<port>. Como uma prévia tem a própria URL, o provedor a rejeita. Nesses casos, você pode criar um túnel da porta da máquina do Devin até o seu computador. O app passa a abrir em http://localhost:<port> no seu navegador, como se estivesse sendo executado localmente, e o provedor o aceita. Há duas formas de criar um túnel para uma porta:
  • Devin Desktop. Abra a sessão no Devin Desktop e encaminhe a porta por lá.
  • SSH. Execute devin forward <session> 3000 ou passe -L 3000:localhost:3000 para o devin ssh ou para o ssh comum. Consulte Encaminhar portas.
Um túnel só fica acessível no computador que o executa, portanto não é um link que você possa enviar a um colega de equipe. Use uma prévia para compartilhar e um túnel para os casos que exigem localhost. Se preferir continuar usando a prévia, você pode adicionar a URL de prévia da sessão à lista de URLs de redirecionamento do provedor ou criar no app um login de desenvolvimento que dispense o provedor. O Devin também pode fazer login em localhost no próprio navegador. Consulte Interactive Browser.

Loopback HTTPS

Um servidor de desenvolvimento que disponibiliza HTTPS na própria porta funciona em uma prévia sem nenhuma configuração adicional. O Devin detecta que a porta usa HTTPS e se conecta a ela por esse protocolo. Seu navegador não vê o certificado do seu servidor. A URL da prévia é servida com o certificado do Devin. A conexão com seu servidor de desenvolvimento é feita na máquina do Devin, onde seu certificado não é verificado; por isso, certificados de desenvolvimento autoassinados funcionam sem avisos. Isso só faz diferença em poucos casos, como um app que espera que o navegador veja um certificado específico.

Sessões em suspensão

A máquina do Devin entra em suspensão quando a sessão fica ociosa. Você não precisa retomá-la manualmente: basta abrir a prévia para retomar a máquina, e o app volta a ficar disponível na mesma URL. O carregamento da primeira página pode levar alguns segundos. A máquina permanece ativa enquanto a prévia estiver em uso e volta a entrar em suspensão cerca de 5 minutos após a última requisição. A prévia deixa de funcionar quando a sessão é arquivada ou encerrada.

Pré-visualizações e Devin Apps

Uma prévia fica vinculada a uma única sessão. Ela serve para acompanhar o trabalho em andamento, revisar uma alteração ou mostrar a um colega de equipe o que o Devin criou. Na maioria dos casos, uma prévia é tudo de que você precisa. Os Devin Apps têm outra finalidade: uma ferramenta interna, um painel ou um app semelhante que sua equipe continua usando depois que o trabalho da sessão termina. Se é isso que você está criando, peça ao Devin para publicar a prévia como um Devin App. Os Devin Apps são executados da mesma forma que as prévias, a partir da máquina do Devin, mas recebem uma URL estável e configurações de compartilhamento próprias e completas.