Risoluzione dei problemi di build e anteprima

Quando una build non riesce o l'anteprima non si carica, inizia dal primo errore visibile e segui il percorso di ripristino per quel sintomo. Questa pagina copre il Visualizzatore App, l'Anteprima, gli errori di build e i passaggi da seguire prima di segnalare un problema.

Inizia da qui

Dopo che un Agente completa un'attività, il Visualizzatore App carica la tua app. Il Terminale mostra l'attività delle attività e gli errori, mentre la barra degli strumenti del Visualizzatore App ti offre un controllo Reload App Viewer, un selettore della vista del 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 termini.
2. Seleziona Reload App Viewer una volta se l'anteprima sembra non aggiornata o resta sulla schermata di caricamento.
3. Apri l'anteprima in una nuova scheda se il Visualizzatore App incorporato è bloccato o non risponde.
4. Apri la Console e copia il primo errore visibile. Conserva il link del progetto e l'ora dell'errore.

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 eseguire un'altra azione.

1. Seleziona Resolve e attendi che il tentativo corrente termini.
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 la Console e copia il messaggio di errore completo visibile lì.
2. Se Resolve è disponibile, usalo una volta e attendi che il tentativo termini.
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 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 il Supporto.

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 termini. 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 rete senza condividere cookie, token o valori segreti. Se il problema continua, includi nel 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 sembra 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 fallisce, registra l'azione esatta in cui il risultato atteso si interrompe e testa 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 previsto e ciò che non deve cambiare.
4. Applica una modifica, quindi verifica le viste desktop e mobile oltre agli 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 intenzionalmente.
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 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 sola 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 rilevante 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 ne esiste già una.

Per il flusso completo della Segnalazione problemi, vedi Report an Issue.

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. Elenca le azioni esatte nell'ordine corretto.
• 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 il browser, il sistema operativo e il 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