Solução de problemas de build e preview

Quando uma build falha ou sua preview não carrega, comece pelo primeiro erro visível e siga o caminho de recuperação para esse sintoma. Esta página cobre o Visualizador de App, a Preview, erros de build e as etapas a seguir antes de relatar um problema.

Comece aqui

Depois que um Agente conclui uma tarefa, o Visualizador de App carrega seu app. O Terminal mostra a atividade da tarefa e os erros, enquanto a barra de ferramentas do Visualizador de App oferece um controle Recarregar Visualizador de App, um alternador de visualização de dispositivo, uma opção para abrir a preview em uma nova aba e o Console.

1. Salve a alteração mais recente e aguarde a tarefa ou build atual terminar.
2. Selecione Reload App Viewer uma vez se a preview parecer desatualizada ou permanecer em uma tela de carregamento.
3. Abra a preview em uma nova aba se o Visualizador de App incorporado estiver travado ou sem resposta.
4. Abra o Console e copie o primeiro erro visível. Guarde o link do projeto e o horário da falha.

Quando a build falha

Tente Resolve primeiro

Quando o Atoms detecta um problema de build, uma notificação de Relatório de Problemas aparece no canto inferior esquerdo. Se a notificação incluir Resolve, inicie uma tentativa de reparo antes de tomar qualquer outra ação.

1. Selecione Resolve e aguarde a tentativa atual terminar.
2. Não selecione Resolve novamente enquanto ele estiver em execução.
3. Se a tentativa não terminar, registre o status visível e continue com as etapas de relato abaixo. Não inicie outra tentativa de Resolve.
4. Quando a tentativa terminar, verifique a preview atualizada. Se ela não atualizar, atualize o navegador uma vez.
5. Repita a ação que causou o problema. Se o problema persistir, expanda o Relatório de Problemas e continue com as etapas de relato abaixo.

Erro de build ou dependência ausente

Se o painel Preview mostrar um erro de build, um banner de erro vermelho ou uma mensagem sobre um pacote ausente, use a mensagem exata para definir a próxima etapa.

1. Abra o Console e copie a mensagem de erro completa que estiver visível ali.
2. Se Resolve estiver disponível, use-o uma vez e aguarde a tentativa terminar.
3. Se não houver botão Resolve, cole o erro exato no chat do Projeto e peça ao Agente para corrigir esse erro de build.
4. Se o erro começou após uma alteração específica, abra History e compare a versão atual com a última versão funcional.
5. Se o erro for difícil de isolar, faça Remix a partir da última versão estável e reaplique as alterações de forma incremental.

Erros que mencionam o Visualizador de App, o script de inicialização, Publish, um registro de deploy ou os arquivos internos de um pacote de terceiros podem indicar um problema de plataforma. Inclua a mensagem de erro completa ao entrar em contato com o Suporte.

A build permanece em andamento

Verifique o Terminal para ver a atividade atual da tarefa antes de tentar novamente. Se a tarefa ou build ainda estiver em execução, aguarde terminar. Se ela continuar em andamento após o fim da tentativa atual, registre o status, o horário, o link do projeto e quaisquer detalhes de erro visíveis e, em seguida, relate o problema.

Quando a Preview ou o Visualizador de App não carrega

Tela de carregamento ou preview sem resposta

Primeiro, verifique se apenas o Visualizador de App incorporado foi afetado ou se a URL da Preview e o site publicado também foram afetados.

1. Confirme se a tarefa ou build atual ainda está em execução.
2. Selecione Reload App Viewer uma vez.
3. Abra a Preview em uma nova aba do navegador.
4. Teste a mesma URL em uma janela anônima.
5. Se a última versão funcional conhecida carregar, compare-a com a alteração recente que introduziu o problema.

Se o produto informar explicitamente um saldo insuficiente de Cloud & AI ou um app suspenso, abra Settings → Cloud & AI e revise esse status. Não recarregue saldo com base apenas em uma tela em branco.

Preview em branco ou incompleta

Verifique se a tela em branco afeta o app inteiro ou apenas uma página ou componente. Se apenas uma área for afetada, use o seletor de páginas para abrir essa página diretamente e repita a menor jornada do usuário que leva até ela. Se a preview inteira estiver em branco, volte ao resultado da build e resolva o primeiro erro de build ou de execução antes de testar novamente.

Registre qualquer erro do Console ou da Network sem compartilhar cookies, tokens ou valores secretos. Se o problema continuar, inclua os detalhes do erro sanitizados no seu relatório.

A Preview mostra uma versão antiga

A Preview e o site publicado são canais separados. Certifique-se de que as alterações mais recentes foram salvas e que a build mais recente foi concluída antes de atualizar a preview. Reabra a Preview após a conclusão da build. Se ela ainda mostrar conteúdo antigo, compare a versão atual com a última versão funcional conhecida em History.

Quando a preview parece errada

Interações ou navegação não funcionam

Uma página que renderiza não é o mesmo que uma página que funciona. Abra todos os links de navegação importantes, pressione os botões principais, envie os formulários essenciais e siga a principal jornada do usuário do início ao fim. Quando uma interação falhar, registre a ação exata em que o resultado esperado deixa de acontecer e teste esse caminho novamente após cada correção.

O layout mobile está quebrado

1. Use o alternador de dispositivo na barra de ferramentas do Visualizador de App para mudar para a visualização mobile.
2. Selecione o elemento quebrado no modo Design quando disponível.
3. Descreva o layout mobile esperado e o que não deve mudar.
4. Aplique uma alteração e, em seguida, verifique as visualizações desktop e mobile, além dos estados de carregamento, vazio, hover e erro.

Imagens ou outros recursos estão ausentes

1. Abra a seção Files e confirme que o arquivo referenciado existe.
2. Verifique se o caminho, o nome do arquivo e o formato correspondem à referência usada pelo app.
3. Se o recurso foi movido ou renomeado recentemente, restaure a referência ou atualize-a deliberadamente.
4. Selecione Reload App Viewer e teste a página afetada novamente.

O Agente alterou o elemento errado ou quebrou outra área

1. Abra History e faça Remix a partir da última versão estável.
2. Use o modo Design para direcionar o elemento exato quando ele estiver disponível.
3. Informe o que não deve mudar e faça uma alteração por prompt.
4. Verifique o resultado antes de continuar para a próxima alteração.

Relate um problema

Relate o problema quando Resolve não estiver disponível, o problema permanecer após uma tentativa concluída de Resolve, a Preview não responder mas o chat do Projeto ainda funcionar, ou um comportamento inesperado continuar após a investigação do Agente.

Abra Feedback pelo chat do Projeto

1. Abra o chat do Projeto afetado e encontre a mensagem relevante mais recente do Agente.
2. Selecione ... (mais opções) e depois selecione Feedback.
3. No mensageiro de suporte, selecione Send us a message e envie o relatório na conversa existente quando já houver uma.

Para o fluxo completo de Relatório de Problemas, consulte Report an Issue.

Inclua detalhes suficientes para reproduzir o problema

• Resumo do problema. Descreva o problema em uma ou duas frases.
• Link do Projeto ou do Chat. Inclua a URL onde o problema ocorreu.
• Data e hora. Inclua seu fuso horário.
• Etapas para reproduzir. Liste as ações exatas em ordem.
• Resultado esperado e resultado real. Informe o que deveria ter acontecido e o que aconteceu em vez disso.
• O que você já tentou. Diga se o Resolve apareceu, o que aconteceu depois que ele terminou e se atualizar ou fazer Remix mudou o resultado.
• Navegador e dispositivo. Inclua o navegador, o sistema operacional e o tipo de dispositivo.
• Evidências. Anexe uma captura de tela ou gravação e os detalhes visíveis relevantes do Relatório de Problemas ou do Console.

Remova senhas, chaves de API, tokens de autenticação, cookies, detalhes de pagamento e dados pessoais ou confidenciais não relacionados antes de compartilhar capturas de tela ou logs.

Depois que o problema for corrigido

Execute a principal jornada do usuário do início ao fim. Verifique a Preview nas visualizações desktop e mobile, abra cada página pelo seletor de páginas e confirme que o Console não tem mensagens de erro em vermelho. Se o app estiver pronto para publicar, substitua qualquer conteúdo de placeholder e conclua as verificações de publicação no Visualizador de App.

Perguntas frequentes