Solução de problemas de build e visualização

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 Reload App Viewer, um alternador de visualização de dispositivo, uma opção para abrir a visualização 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 visualização parecer desatualizada ou permanecer em uma tela de carregamento.
3. Abra a visualização 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 realizar 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 visualização 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 de Visualização 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 um 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 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 permanecer 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 Visualização ou o Visualizador de App não carrega

Tela de carregamento ou visualização sem resposta

Primeiro, verifique se apenas o Visualizador de App incorporado foi afetado ou se a URL da Visualização 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 Visualização 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 créditos com base apenas em uma tela em branco.

Visualização 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 toda a visualização estiver em branco, volte ao resultado da build e resolva o primeiro erro de build ou de tempo 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 relato.

A Visualização mostra uma versão antiga

A Visualização 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 visualização. Reabra a Visualização 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 visualização 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 principais e siga a jornada principal 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 com problema 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 um 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 persistir após uma tentativa concluída de Resolve, a Visualização não responder mas o chat do Projeto ainda funcionar, ou um comportamento inesperado continuar após a investigação do Agente.

Abra o 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, em seguida, selecione Feedback.
3. No mensageiro de suporte, selecione Send us a message e envie o relato na conversa existente quando já houver uma.

Para o fluxo completo de Relatório de Problemas, consulte Relatar um Problema.

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 no lugar.
• O que você já tentou. Diga se o Resolve apareceu, o que aconteceu após ele terminar e se atualizar ou fazer Remix mudou o resultado.
• Navegador e dispositivo. Inclua o navegador, o sistema operacional e o tipo de dispositivo.
• Evidência. 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 jornada principal do usuário do início ao fim. Verifique a Visualização 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.

FAQ

Por que o Visualizador de App está mostrando uma tela branca em branco?

1. Confirme se o problema afeta apenas o Visualizador de App, a URL da Visualização ou também o site publicado.
2. Selecione Reload App Viewer uma vez, abra a Visualização em uma nova aba e teste em uma janela anônima.
3. Verifique se a tarefa ou build atual ainda está em execução. Aguarde terminar antes de tentar novamente.
4. Se uma mensagem explícita disser que o saldo de Cloud & AI é insuficiente ou que o app está suspenso, abra Settings → Cloud & AI e revise esse saldo. Não recarregue créditos com base apenas em uma tela em branco.
5. Registre qualquer erro do Console ou da Network sem compartilhar cookies, tokens ou valores secretos.

Se a tela continuar em branco, entre em contato com o Suporte com o Link do Chat, a URL completa do Viewer, a hora e o fuso horário, os ambientes afetados, a captura de tela e os detalhes do erro sanitizados.