PhotoCraft com tela em branco: como resolver
Identifique falhas de carregamento, renderização e arquivos; salve antes de trocar o renderizador.
Identifique em qual etapa ocorre a falha
Um editor em branco pode significar várias coisas diferentes: os ativos do aplicativo não foram carregados, o back-end gráfico falhou ao inicializar, a tela está fora da tela ou um documento específico esgotou os recursos disponíveis. A página ao redor do editor pode carregar normalmente, enquanto o aplicativo WebAssembly não. Comece registrando o que você pode ver em vez de atualizar repetidamente e assumir que cada falha tem a mesma causa.
Este guia se refere à versão web PhotoCraft v0.12.0 não modificada neste site. Descreve uma sequência de diagnóstico, não uma referência de desempenho do navegador. Não publicamos nenhum limite universal de tempo de carregamento, limite de tamanho de arquivo ou promessa de que um renderizador funcione em todos os drivers gráficos. As capturas de tela e as verificações de fluxo de trabalho existentes usam o Chromium; hardware real e outras versões de navegador podem se comportar de maneira diferente.
Salve primeiro se o editor ainda responder
Se o seu documento estiver visível e os menus ainda funcionarem, salve uma cópia do documento e exporte um PNG de referência antes de alterar qualquer coisa. Localize os arquivos em disco. A troca de renderizadores reinicia o aplicativo incorporado e recarregar a página pode descartar alterações não salvas. Um prompt de aviso não é salvamento automático. Leia o fluxo de trabalho de backup guia de salvamento e backup se não tiver certeza de quais arquivos devem existir antes de continuar.
Se o espaço de trabalho já não estiver respondendo, preserve todos os downloads concluídos e anote a última operação. Não há cópia de documento do lado do servidor para recuperar. Evite limpar os dados do site como uma primeira etapa automática: isso pode remover preferências e contexto de diagnóstico sem restaurar um documento não salvo. Diagnostique a inicialização com uma nova amostra pequena depois de contabilizar o trabalho que foi realmente salvo.
Separe o carregamento da página da inicialização do editor
Vá até o editor e verifique se seus próprios menus e telas apareceram. O título externo e o botão Abrir editor são controles do site. Eles não demonstram que o aplicativo incorporado foi inicializado. Em uma tela grande, o aplicativo pode simplesmente estar abaixo da janela de visualização atual; em uma tela estreita, seus painéis podem deixar pouco espaço para a tela.
Abra o editor em uma guia separada usando o controle fornecido se precisar distinguir um problema de incorporação ou layout da inicialização do aplicativo. Acompanhe qual guia contém sua sessão original. Uma nova guia não transfere edições não salvas. Se uma visualização funcionar e outra não, registre a rota e a janela de visualização exatas em vez de relatar apenas que “PhotoCraft está quebrado”.
Confira as requisições dos arquivos do editor
Nas ferramentas de desenvolvedor do navegador, inspecione as solicitações de rede enquanto reproduz o problema. O aplicativo carrega HTML, JavaScript e WebAssembly de /vendor/photocraft/0.12.0/. Registre solicitações com falha, códigos de status e mensagens do console. Uma falha no download do WASM é um problema diferente de um download concluído seguido por um erro de inicialização de gráficos. Mantenha a versão exata do navegador com o relatório.
Extensões, filtros de rede ou problemas temporários de conexão podem interferir no carregamento de ativos. Experimente um perfil de navegador limpo ou uma janela privada como comparação de diagnóstico, lembrando que uma janela privada é uma nova sessão de edição. Não desative o software de segurança globalmente nem ignore erros de certificado para carregar o aplicativo. Em vez disso, relate o recurso bloqueado e o erro observado.
Teste um renderizador de cada vez
Após salvar, use os controles do renderizador do site para selecionar WebGL2, tela da CPU ou o renderizador padrão. Altere uma configuração de cada vez e aguarde o aplicativo recém-iniciado aparecer. Repita com a mesma pequena amostra e a mesma operação. Se você alterar o arquivo, o navegador e o renderizador simultaneamente, perderá a comparação que ajudaria a identificar a causa.
A tela da CPU é uma alternativa de solução de problemas, não uma garantia de melhor desempenho ou compatibilidade. Da mesma forma, selecionar um modo com suporte gráfico não prova que a aceleração de hardware esteja ativa. Nosso ambiente Chromium automatizado pode usar gráficos de software. Registre o modo solicitado e quaisquer informações de back-end que o aplicativo realmente reporte. Não converta esse ambiente em afirmações sobre a velocidade do laptop ou telefone de um usuário.
Use um arquivo pequeno conhecido
Baixe o 320 × 320 sintético PNG. Abra-o, pinte uma marca visível e exporte um PNG usando o fluxo de trabalho passo a passo tutorial de edição de PNG. Uma operação simples e bem-sucedida mostra que esse caminho específico de inicialização e edição funciona. Restringe o problema sem provar suporte ao documento original.
Se a amostra funcionar, mas seu arquivo falhar, registre o tipo, as dimensões, o tamanho do arquivo original e as características relevantes do documento. Use uma duplicata para criar uma reprodução menor com material confidencial removido. Documentos grandes dependem da memória do navegador e do dispositivo. O recurso de formato PSB não torna práticos arquivos arbitrariamente grandes em uma guia, e este site não mediu um tamanho seguro universal.
Diferencie falhas de importação, edição e exportação
| Observação | O que registrar | Próxima comparação |
|---|---|---|
| Nenhuma tela de aplicativo | Falhas de ativos e console de inicialização | Perfil novo e renderizador alternativo |
| A amostra abre, o original falha | Formato do arquivo, dimensões e recursos relevantes | Uma reprodução higienizada menor |
| A imagem abre, mas o pincel não deixa marca | Foco ativo na ferramenta, no documento e na tela | O fluxo de trabalho conhecido do PNG |
| A exportação parece inalterada | Nome do arquivo baixado e referência visível | Uma nova exportação com uma edição óbvia |
| Reaberto PSD difere | Arquivo salvo, referência PNG e estrutura necessária | A lista de verificação de ida e volta |
Verificar um arquivo exportado fora do editor ajuda a separar um problema de exibição de uma saída alterada. Se uma exportação estiver correta, mas a tela parecer errada, guarde ambas as evidências. Se a saída também estiver errada, preserve uma fonte mínima e etapas exatas. O guia PSD explica por que a fidelidade visual e a estrutura editável precisam de observações separadas.
Reúna evidências sem expor dados privados
Um relatório útil inclui o URL da página, versão PhotoCraft, sistema operacional, versão do navegador, seleção do renderizador e sequência exata de ações. Adicione o resultado esperado e o resultado observado. Uma captura de tela deve mostrar o estado relevante do aplicativo, ocultando guias pessoais, detalhes da conta, nomes de arquivos e material do cliente. Utilize um arquivo sintético sempre que o problema puder ser reproduzido sem o original.
Arquivos de rede e logs do console podem conter informações de navegação. Inspecione-os antes de compartilhar e remova credenciais ou solicitações não relacionadas. O site carrega GA4 e Plausible diretamente para medir visitas; essas requisições são distintas do processamento de documentos. Não rotule cada solicitação de rede como upload de imagem. Por outro lado, um editor local não significa que a navegação não tenha metadados de hospedagem comuns.
Decida se vale continuar o diagnóstico
Se uma versão salva guardada reabrir e o pequeno fluxo de trabalho funcionar, retorne à sua tarefa gradualmente e salve em marcos significativos. Se um arquivo ou recurso essencial ainda falhar, mantenha o original e use um fluxo de trabalho já verificado para esse requisito. Forçar repetidamente um documento com falha pelo mesmo caminho não substitui a verificação da saída.
Use o guia da comunidade guia da comunidade para encaminhar relatórios de software upstream e a página de contato Contato para erros do site. Uma reprodução precisa é mais viável do que um diagnóstico adivinhado. Inclua o que você tentou, incluindo alterações malsucedidas no renderizador, e marque claramente qualquer parte que você não pôde testar. Isso torna a próxima investigação útil sem exagerar o que as evidências atuais estabelecem.