Falhas de importação¶
Meta¶
Ajuda você a decidir rapidamente se a falha atual é uma entrada não suportada, uma incompatibilidade de caminho de importação ou uma parada proativa de proteção de tempo de execução.
Plataformas Suportadas¶
iOSmacOS
Público-alvo¶
- Usuários cujo caminho de importação não se comportou conforme o esperado
- Testadores fazendo triagem de falhas de importação, importações ignoradas ou resultados de importação degradados
Pré-requisitos¶
- Você tem um caso de importação, mensagem ou caminho de reprodução específico para inspecionar
- Se possível, mantenha o arquivo de origem e o caminho exato de importação que desencadeou o problema
Etapas¶
- Identifique se a falha ocorreu antes da seleção do arquivo, após a seleção do arquivo ou após entrar no espaço de trabalho.
- Verifique qual caminho de importação foi utilizado e se a fonte deve ser suportada nele.
- Compare o comportamento observado com os padrões de falha abaixo, incluindo reimportações inalteradas e avisos de degradação parcial DSN.
- Registre a mensagem exata e o contexto de origem antes de tentar novamente.
Resultado¶
- Você pode restringir o problema a entrada não suportada, incompatibilidade de caminho, parada protetora, reimportação inalterada ou caso de degradação local.
Veja essas três coisas primeiro¶
- A falha ocorreu antes da seleção do arquivo, após a seleção do arquivo ou após entrar no espaço de trabalho?
- O aplicativo mostrou uma mensagem de erro clara?
- A ação foi uma nova importação, anexação de revisão ou SES?
Tipos de falha mais comuns no momento¶
1. Tipo de entrada não suportado¶
Sinais típicos:
- o aplicativo diz diretamente que a extensão não é suportada
- o fluxo para depois que você escolhe o arquivo
Ações sugeridas:
- primeiro confirme se você usou o caminho de design ou fabricação
- então confirme se a entrada pertence ao conjunto atualmente suportado
2. Intenção de importação IPC-2581 errada¶
Sinais típicos:
- o arquivo pode ser selecionado, mas o comportamento de importação resultante não é o que você esperava
Ações sugeridas:
- importe novamente
- selecionar novamente se devem ser tratados como dados do lado do projeto ou do lado da fabricação
3. Uso incorreto de SES¶
Sinais típicos:
- tentando importar
SEScomo se fosse um novo documento normal - ou o documento atual não possui revisão base utilizável
Ações sugeridas:
- abra o menu do documento de destino
- comece em
Import SES - selecione primeiro uma revisão base válida
4. IPC-2581 grande abre lentamente ou falha durante a importação real¶
A implementação atual não interrompe mais entradas IPC-2581 XML muito grandes com uma simulação de memória conservadora.
Se este tipo de fonte ainda falhar, a falha agora acontece no caminho real de importação em vez de ser rejeitada antes da abertura.
Ações sugeridas:
- registre o texto exato do erro ou o último estágio de carregamento visível
- registre o tamanho do arquivo, plataforma e modelo do dispositivo
- observe se o aplicativo permaneceu responsivo, travou ou foi encerrado pelo sistema operacional
5. Outra tarefa de importação já está em execução¶
Apenas uma tarefa de importação de PCB é permitida por vez na implementação atual. Se uma importação anterior ainda não tiver sido concluída, a próxima solicitação de importação será rejeitada com uma mensagem de status.
6. A entrada com o mesmo nome e formato é considerada inalterada¶
A implementação atual compara os bytes de origem originais quando você reimporta uma origem com o mesmo nome de documento e o mesmo formato:
- se a fonte original recém-importada for idêntica à revisão atual, o aplicativo informa que a importação foi ignorada porque nada mudou
- isto não é tratado como um fracasso; é assim que revisões duplicadas são evitadas
- se você esperava uma nova revisão, confirme se o conteúdo do arquivo realmente mudou
7. Degradação da geometria local DSN após uma importação bem-sucedida¶
Sinais típicos:
- a importação é bem-sucedida e o documento é aberto
- mas o log do desenvolvedor ou console mostra avisos como
skipping display object variant ... no valid shapes could be extracted
O que significa:
- o importador não conseguiu extrair um contorno válido para um pequeno número de variantes de exibição, então essas variantes locais foram ignoradas e o restante do cartão continuou a importar
- esse comportamento tem como objetivo evitar falhas ou travamentos na importação da placa inteira e geralmente afeta apenas a renderização local, e não o documento inteiro
Ações sugeridas:
- primeiro confirme se a área afetada ainda é utilizável para a tarefa que lhe interessa
- se a geometria faltante for importante, registre o texto de advertência, o
DSNoriginal e as etapas de reprodução para investigação de acompanhamento
Nota específica KiCad¶
Mesmo que uma placa KiCad seja importada com sucesso nos termos 2D, ativos 3D locais do projeto ausentes ou ilegíveis ainda poderão surgir como problemas posteriormente em 3D ou resumos de problemas. Isso nem sempre bloqueia a abertura do 2D, mas pode reduzir a integridade do 3D.
O que gravar¶
- plataforma e dispositivo
- tipo de caminho de importação: design/fabricação/SES
- tipo e tamanho do arquivo original
- o texto do erro original
- se reproduz consistentemente
- se outra tarefa de importação já estava em execução
Perguntas comuns¶
Por que alguns insumos industriais podem ser importados mesmo sendo pastas?¶
Porque o caminho de fabricação aceita entradas no estilo de diretório. O sucesso da importação depende se o importador consegue reconhecer o diretório como um pacote de fabricação suportado.
Por que não há nenhum cartão novo na biblioteca após uma falha na importação?¶
Isso geralmente significa que a falha ocorreu antes da criação do documento, como entrada não suportada, rejeição de comprovação ou falha na detecção do importador.
Por que não recebi uma nova revisão depois de importar o mesmo nome de arquivo pela segunda vez?¶
Se o aplicativo disser que a importação foi ignorada porque nada mudou, isso significa que a fonte original recém-importada é idêntica à revisão atual. A implementação atual ignora isso em vez de criar uma revisão duplicada.
Funcionou na segunda tentativa. Ainda devo gravá-lo?¶
Sim. Falhas intermitentes ainda são importantes para a avaliação da estabilidade.