Risoluzione dei problemi di build e anteprima

Inizia da qui

Dopo che un Agente completa un'attività, il Visualizzatore App carica la tua app. Il Terminale mostra l'attività dell'attività e gli errori, mentre la barra degli strumenti del Visualizzatore App ti offre un controllo Reload App Viewer, un selettore della vista dispositivo, un'opzione per aprire l'anteprima in una nuova scheda e la Console.

1. Salva l'ultima modifica e attendi che l'attività o la build corrente finisca.
2. Seleziona Reload App Viewer una volta se l'anteprima sembra non aggiornata o resta su una schermata di caricamento.
3. Apri l'anteprima in una nuova scheda se il Visualizzatore App incorporato è bloccato o non risponde.
4. Apri Console e copia il primo errore visibile. Conserva il link del progetto e l'ora del problema.

Quando la build non riesce

Prova prima Resolve

Quando Atoms rileva un problema di build, nell'angolo in basso a sinistra appare una notifica di Segnalazione problemi. Se la notifica include Resolve, avvia un tentativo di riparazione prima di intraprendere un'altra azione.

1. Seleziona Resolve e attendi che il tentativo corrente finisca.
2. Non selezionare di nuovo Resolve mentre è in esecuzione.
3. Se il tentativo non termina, registra lo stato visibile e continua con i passaggi di segnalazione qui sotto. Non avviare un altro tentativo di Resolve.
4. Quando il tentativo termina, controlla l'anteprima aggiornata. Se non si aggiorna, aggiorna il browser una volta.
5. Ripeti l'azione che ha causato il problema. Se il problema persiste, espandi la Segnalazione problemi e continua con i passaggi di segnalazione qui sotto.

Errore di build o dipendenza mancante

Se il pannello Anteprima mostra un errore di build, un banner di errore rosso o un messaggio relativo a un pacchetto mancante, usa il messaggio esatto per restringere il passaggio successivo.

1. Apri Console e copia il messaggio di errore completo visibile lì.
2. Se Resolve è disponibile, usalo una volta e attendi che il tentativo finisca.
3. Se non c'è alcun pulsante Resolve, incolla l'errore esatto nella chat del progetto e chiedi all'Agente di correggere quell'errore di build.
4. Se l'errore è iniziato dopo una modifica specifica, apri History e confronta la versione corrente con l'ultima versione funzionante.
5. Se l'errore è difficile da isolare, esegui un Remix dall'ultima versione stabile e riapplica le modifiche in modo incrementale.

Gli errori che menzionano il Visualizzatore App, lo script di avvio, Publish, un record di deploy o i file interni di un pacchetto di terze parti possono indicare un problema della piattaforma. Includi il messaggio di errore completo quando contatti l'Assistenza.

La build resta in corso

Controlla il Terminale per verificare l'attività corrente prima di riprovare. Se l'attività o la build è ancora in esecuzione, attendi che finisca. Se resta in corso dopo la fine del tentativo corrente, registra lo stato, il timestamp, il link del progetto e qualsiasi dettaglio di errore visibile, quindi segnala il problema.

Quando l'Anteprima o il Visualizzatore App non si caricano

Schermata di caricamento o anteprima che non risponde

Per prima cosa controlla se è interessato solo il Visualizzatore App incorporato oppure anche l'URL dell'Anteprima e il sito pubblicato.

1. Conferma se l'attività o la build corrente è ancora in esecuzione.
2. Seleziona Reload App Viewer una volta.
3. Apri l'Anteprima in una nuova scheda del browser.
4. Prova lo stesso URL in una finestra in incognito.
5. Se l'ultima versione funzionante conosciuta si carica, confrontala con la modifica recente che ha introdotto il problema.

Se il prodotto segnala esplicitamente un saldo Cloud & AI insufficiente o un'app sospesa, apri Settings → Cloud & AI e controlla quello stato. Non effettuare una ricarica basandoti solo su una schermata vuota.

Anteprima vuota o incompleta

Controlla se la schermata vuota interessa l'intera app o solo una pagina o un componente. Se è interessata solo un'area, usa il selettore di pagina per aprire direttamente quella pagina e ripeti il percorso utente più piccolo che la raggiunge. Se l'intera anteprima è vuota, torna al risultato della build e risolvi il primo errore di build o di runtime prima di testare di nuovo.

Registra qualsiasi errore della Console o della Network senza condividere cookie, token o valori segreti. Se il problema continua, includi nel tuo report i dettagli dell'errore ripuliti da dati sensibili.

L'Anteprima mostra una versione precedente

L'Anteprima e il sito pubblicato sono canali separati. Assicurati che le ultime modifiche siano state salvate e che l'ultima build sia stata completata prima di aggiornare l'anteprima. Riapri l'Anteprima dopo il completamento della build. Se continua a mostrare contenuti precedenti, confronta la versione corrente con l'ultima versione funzionante conosciuta in History.

Quando l'anteprima appare errata

Le interazioni o la navigazione non funzionano

Una pagina che viene renderizzata non è la stessa cosa di una pagina che funziona. Apri ogni link di navigazione importante, premi i pulsanti principali, invia i moduli chiave e segui il percorso utente principale dall'inizio alla fine. Quando un'interazione non riesce, registra l'azione esatta in cui il risultato atteso si interrompe e prova di nuovo quel percorso dopo ogni correzione.

Il layout mobile è danneggiato

1. Usa il selettore del dispositivo nella barra degli strumenti del Visualizzatore App per passare alla vista mobile.
2. Seleziona l'elemento danneggiato in modalità Design quando disponibile.
3. Descrivi il layout mobile atteso e cosa non deve cambiare.
4. Applica una modifica, quindi verifica le viste desktop e mobile più gli stati di caricamento, vuoto, hover ed errore.

Mancano immagini o altre risorse

1. Apri la sezione Files e conferma che il file di riferimento esista.
2. Controlla che il percorso, il nome del file e il formato corrispondano al riferimento usato dall'app.
3. Se la risorsa è stata spostata o rinominata di recente, ripristina il riferimento o aggiornalo deliberatamente.
4. Seleziona Reload App Viewer e testa di nuovo la pagina interessata.

L'Agente ha modificato l'elemento sbagliato o ha compromesso un'altra area

1. Apri History ed esegui un Remix dall'ultima versione stabile.
2. Usa la modalità Design per individuare l'elemento esatto quando è disponibile.
3. Indica cosa non deve cambiare ed effettua una modifica per prompt.
4. Verifica il risultato prima di passare alla modifica successiva.

Segnala un problema

Segnala il problema quando Resolve non è disponibile, il problema persiste dopo un tentativo di Resolve completato, l'Anteprima non risponde ma la chat del progetto continua a funzionare, oppure un comportamento imprevisto continua dopo che l'Agente ha indagato.

Apri Feedback dalla chat del progetto

1. Apri la chat del progetto interessata e trova l'ultimo messaggio pertinente dell'Agente.
2. Seleziona ... (altre opzioni), quindi seleziona Feedback.
3. Nel messenger di supporto, seleziona Send us a message e invia la segnalazione nella conversazione esistente se ce n'è già una.

Per il flusso completo di Segnalazione problemi, vedi Segnala un problema.

Includi dettagli sufficienti per riprodurre il problema

• Riepilogo del problema. Descrivi il problema in una o due frasi.
• Link del progetto o della chat. Includi l'URL in cui si è verificato il problema.
• Data e ora. Includi il tuo fuso orario.
• Passaggi per riprodurre il problema. Elenca le azioni esatte in ordine.
• Risultato atteso e risultato effettivo. Indica cosa sarebbe dovuto accadere e cosa è accaduto invece.
• Cosa hai già provato. Indica se Resolve è apparso, cosa è successo dopo il suo completamento e se l'aggiornamento o Remix hanno cambiato il risultato.
• Browser e dispositivo. Includi browser, sistema operativo e tipo di dispositivo.
• Prove. Allega uno screenshot o una registrazione e i dettagli visibili pertinenti della Segnalazione problemi o della Console.

Rimuovi password, chiavi API, token di autenticazione, cookie, dettagli di pagamento e dati personali o riservati non correlati prima di condividere screenshot o log.

Dopo che il problema è stato risolto

Esegui il percorso utente principale dall'inizio alla fine. Controlla l'Anteprima sia nella vista desktop sia in quella mobile, apri ogni pagina dal selettore di pagina e conferma che la Console non mostri messaggi di errore rossi. Se l'app è pronta per la pubblicazione, sostituisci qualsiasi contenuto segnaposto e completa i controlli di pubblicazione nel Visualizzatore App.

FAQ

Perché il Visualizzatore App mostra una schermata bianca vuota?

1. Conferma se il problema interessa solo il Visualizzatore App, anche l'URL dell'Anteprima o anche il sito pubblicato.
2. Seleziona Reload App Viewer una volta, apri l'Anteprima in una nuova scheda e prova una finestra in incognito.
3. Controlla se l'attività o la build corrente è ancora in esecuzione. Attendi che finisca prima di riprovare.
4. Se un messaggio esplicito dice che il saldo Cloud & AI è insufficiente o che l'app è sospesa, apri Settings → Cloud & AI e controlla quel saldo. Non effettuare una ricarica basandoti solo su una schermata vuota.
5. Registra qualsiasi errore della Console o della Network senza condividere cookie, token o valori segreti.

Se la schermata resta vuota, contatta l'Assistenza con il Link della chat, l'URL completo del Viewer, ora e fuso orario, ambienti interessati, screenshot e dettagli dell'errore ripuliti da dati sensibili.