Vai al contenuto principale
Un’anteprima nel browser è un collegamento privato a un’applicazione web in esecuzione sulla macchina di Devin. Quando Devin avvia un server di sviluppo in una sessione, può esporre la porta e fornirti un collegamento da aprire nel tuo browser. Le anteprime funzionano con qualsiasi stack tecnologico: se un’applicazione espone HTTP su una porta, Devin può generarne l’anteprima. L’app e i suoi dati restano sulla macchina di Devin: nulla viene caricato su servizi di terze parti.
Questa pagina riguarda le anteprime nelle sessioni Devin. Per le anteprime di un server di sviluppo locale in Devin Desktop, consulta Anteprime di Devin Desktop.

Aprire un’anteprima

Devin apre un’anteprima quando avvia un’app che dovresti esaminare. Puoi anche richiederla tu, ad esempio con “mostra un’anteprima dell’app”. Devin pubblica nella chat una scheda Open preview. Fai clic sulla scheda per aprire l’app nella scheda anteprima della sessione. In alternativa, fai Cmd-clic, Ctrl-clic o clic con il pulsante centrale sulla scheda per aprire l’anteprima in una nuova scheda del browser. Nelle sessioni avviate da Slack, nel thread viene pubblicato un collegamento Open preview.

URL di anteprima

Ecco un esempio di URL di anteprima:
Il nome deriva da quello che Devin assegna all’anteprima. L’id è casuale, quindi l’URL non può essere indovinato. L’URL è legato alla sessione e rimane invariato anche se Devin riavvia l’app o la sposta su un’altra porta. Un’anteprima in un’altra sessione riceve un URL diverso. Gli URL di anteprima consentono anche di indirizzare singolarmente le porte che Devin espone sulla macchina, usando una sintassi alternativa:
Queste porte devono essere esposte da Devin, ma una volta esposte diventano accessibili pubblicamente.

Chi può aprire un’anteprima

Le Anteprime sono private. Nulla viene esposto sulla rete Internet pubblica. Chiunque apra l’URL di un’anteprima deve aver effettuato l’accesso a Devin. Oltre a questo, l’accesso a un’anteprima dipende da quello della sessione a cui appartiene: se puoi inviare messaggi alla sessione, puoi aprirne l’anteprima. Per impostazione predefinita, l’accesso è consentito a tutti i membri della tua organizzazione che possono usare le sessioni Devin, quindi puoi inviare il collegamento a un collega e funzionerà subito. Se la sessione è limitata al proprietario o a persone specifiche, solo queste persone possono aprire l’anteprima. Tutti gli altri vedranno una pagina che segnala che l’anteprima non è disponibile.

Cosa puoi fare nella scheda anteprima

La scheda anteprima funziona come un piccolo browser. Include pulsanti per andare avanti, tornare indietro, ricaricare la pagina, regolare lo zoom e cercare nella pagina, oltre a un selettore per passare dalla larghezza desktop a quella tablet o mobile. Puoi anche annotare elementi della pagina e indicare a Devin cosa modificare. Quando usi il pulsante “Selecting” in una sessione, ti basta fare clic su un elemento o trascinare il cursore su un’area, aggiungere una nota e inviarla alla chat. Devin riceve l’elemento selezionato insieme alla tua nota.

App con più di una porta

Un’anteprima può includere più porte, ad esempio un frontend su una porta e un’API di backend su un’altra. Quando apre l’anteprima, Devin le elenca tutte e l’anteprima si apre sulla prima. Per passare dall’una all’altra, usa il menu Ports nella scheda anteprima. Il tuo frontend non ha bisogno di conoscere l’URL dell’anteprima. Se la pagina chiama http://localhost:8000, l’anteprima inoltra la richiesta alla porta 8000 sulla macchina di Devin. Un service worker installato dall’anteprima riscrive queste richieste nel tuo browser, e le connessioni WebSocket vengono gestite allo stesso modo. Poiché la richiesta resta sull’indirizzo dell’anteprima, non è necessario modificare le impostazioni CORS. Questo meccanismo raggiunge solo le porte che Devin ha esposto per l’anteprima.

Cosa vede la tua app

Il tuo server vede la richiesta come proveniente da localhost. L’anteprima imposta le intestazioni Host e Origin su localhost prima che la richiesta raggiunga la tua app, quindi i server di sviluppo che verificano il nome host funzionano senza ulteriori configurazioni. Anche Devin continua a usare localhost, sia quando esegue l’app sia quando la testa. Alcuni aspetti funzionano diversamente rispetto a quando esegui l’app sul tuo computer:
  • Service worker. L’anteprima usa un proprio service worker, quindi la tua app non può registrarne uno. Se la tua app è una PWA, disattiva il service worker in fase di sviluppo oppure tieni presente che la riscrittura automatica delle porte potrebbe non funzionare.
  • Cookie. I cookie impostati dalla tua app nella scheda anteprima sono separati da quelli impostati quando l’anteprima è aperta in una scheda del browser dedicata. Se accedi alla tua app in uno dei due contesti, potrebbe essere necessario accedere di nuovo nell’altro.
  • Accesso con un provider di identità. Il tuo browser si trova sull’URL dell’anteprima, non su localhost. Un provider come Microsoft Entra ID, Okta o Google rifiuta l’accesso se come URL di reindirizzamento è registrato solo localhost. Consulta Tunneling delle porte.
  • Server di sviluppo HTTPS. Il tuo browser vede il certificato di Devin, non quello del tuo server. Consulta Loopback HTTPS.

Tunneling delle porte

Alcuni servizi funzionano solo quando il tuo browser si trova effettivamente su localhost. Il caso più comune è l’accesso tramite un provider di identità. Il provider accetta solo gli URL di reindirizzamento che hai registrato e nella maggior parte delle configurazioni di sviluppo viene registrato http://localhost:<port>. Un’anteprima ha un proprio URL, quindi il provider la rifiuta. In questi casi, puoi creare un tunnel dalla porta sulla macchina di Devin al tuo computer. L’app si apre così su http://localhost:<port> nel tuo browser, esattamente come se fosse in esecuzione in locale, e il provider la accetta. Esistono due modi per creare il tunnel di una porta:
  • Devin Desktop. Apri la sessione in Devin Desktop e inoltra la porta da lì.
  • SSH. Esegui devin forward <session> 3000, oppure passa -L 3000:localhost:3000 a devin ssh o al semplice ssh. Consulta Inoltrare le porte.
Un tunnel è accessibile solo dal computer su cui viene eseguito, quindi non è un link che puoi inviare a un collega. Usa un’anteprima per la condivisione e un tunnel per i casi che richiedono localhost. Se preferisci continuare a usare l’anteprima, puoi aggiungere l’URL di anteprima della sessione all’elenco degli URL di reindirizzamento del provider, oppure dotare l’app di un accesso di sviluppo che bypassa il provider. Devin può anche effettuare l’accesso su localhost dal proprio browser. Consulta Interactive Browser.

Loopback HTTPS

Un server di sviluppo che espone HTTPS sulla propria porta funziona in un’anteprima senza alcuna configurazione aggiuntiva. Devin rileva che la porta utilizza HTTPS e vi si connette di conseguenza. Il tuo browser non vede il certificato del tuo server: l’URL di anteprima viene servito con il certificato di Devin. La connessione al tuo server di sviluppo avviene sulla macchina di Devin, dove il tuo certificato non viene verificato, quindi i certificati di sviluppo autofirmati funzionano senza avvisi. Questo aspetto conta solo in pochi casi specifici, ad esempio per un’app che si aspetta che il browser veda un determinato certificato.

Sessioni in sospensione

La macchina di Devin entra in sospensione quando la sessione è inattiva. Non è necessario riattivarla manualmente: basta aprire l’anteprima per riattivare la macchina, e l’app torna disponibile allo stesso URL. Il caricamento della prima pagina può richiedere alcuni secondi. La macchina resta attiva finché l’anteprima è in uso e torna in sospensione circa 5 minuti dopo l’ultima richiesta. L’anteprima smette di funzionare quando la sessione viene archiviata o termina.

Anteprime e Devin Apps

Un’anteprima è legata a una singola sessione. Serve per esaminare il lavoro in corso, rivedere una modifica o mostrare a un collega ciò che Devin ha realizzato. Nella maggior parte dei casi, un’anteprima è tutto ciò che ti serve. Le Devin Apps hanno uno scopo diverso: uno strumento interno, un pannello di controllo o un’app simile che il tuo team continua a usare anche dopo la conclusione del lavoro della sessione. Se è questo che stai realizzando, puoi chiedere a Devin di pubblicare l’anteprima come Devin App. Le Devin Apps vengono eseguite come le anteprime, dalla macchina di Devin, ma dispongono di un URL stabile e di impostazioni di condivisione proprie e complete.