> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Prévias do Browser do Devin

> Abra um web app em execução na máquina do Devin por meio de um link privado. Saiba como funcionam as URLs de prévia, o acesso, múltiplas portas, o tunelamento de portas e as sessões em suspensão.

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.

> [!NOTE]
>
> 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](https://docs.devin.ai/pt-BR/desktop/previews.md).

## 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:

```
https://<name>--<id>.preview.devinapps.com
```

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:

```
https://<port>--<devin-id>.preview.devinapps.com
```

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](#tunneling-ports).
* **Servidores de desenvolvimento HTTPS.** Seu navegador vê o certificado do Devin, e não o do seu servidor. Consulte [HTTPS Loopback](#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](https://docs.devin.ai/pt-BR/cli/ssh.md#forward-ports).

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](https://docs.devin.ai/pt-BR/work-with-devin/devin-session-tools.md#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](https://docs.devin.ai/pt-BR/product-guides/devin-apps.md). 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.