Versão do documento v2026.08.31.0

Baixar PDF

Primeiro lançamento e importação

Objetivo

Ajuda você a completar um loop completo de primeiro uso: comece na biblioteca, importe algo, abra-o e retorne à biblioteca novamente.

Plataformas Suportadas

• iOS
• macOS

Público-alvo

• Novos usuários que desejam completar seu primeiro ciclo de importação
• Testadores validando o comportamento de importação da biblioteca para o espaço de trabalho

Pré-requisitos

• PCBAtlas já pode ser iniciado na biblioteca
• Você tem uma das amostras integradas ou seus próprios arquivos de origem de design/fabricação prontos

Etapas

1. Comece na biblioteca e escolha Import File ou Import Folder conforme a origem.
2. Se a origem for IPC-2581 XML, escolha a intenção de importação quando solicitado.
3. Aguarde a conclusão do banner de progresso da biblioteca e abra o documento resultante.
4. Confirme se origens PCB independentes abrem no PCB Viewer; se origens de esquema e projetos KiCad com um esquema abrem no Schematic Workbench; e se as revisões são atualizadas conforme esperado.

Resultado

• A origem é importada para a biblioteca como novo documento ou revisão, e o espaço de trabalho abre o PCB Viewer ou Schematic Workbench correspondente.

Conteúdo padrão no primeiro lançamento a frio

Quando a biblioteca está vazia, o aplicativo a propaga automaticamente com três documentos de amostra que podem ser abertos imediatamente:

• h730duino (dados de fabricação ODB++)
• BluePhil (placa de design KiCad)
• WooKey Mainboard (projeto KiCad com PCB e esquemas hierárquicos)

Se você quiser apenas aprender o fluxo de interação, abra primeiro um desses exemplos. Se quiser validar seus próprios dados, continue com o fluxo de importação abaixo.

Caminhos de importação atuais

Import File

• um DSN, KiCad .kicad_pcb, KiCad .kicad_sch ou IPC-2581 XML independente
• um .zip KiCad comum ou um arquivo de fabricação ODB++ / Gerber / Drill reconhecido pelo aplicativo
• um pacote de documento .epcbdoc.zip compatível

Não importe .kicad_pro como arquivo isolado. Um projeto precisa dos esquemas, bibliotecas e configurações do mesmo diretório; use Import Folder. Uma .kicad_sch independente só pode ser importada diretamente se não referenciar child sheets. Um esquema multi-sheet também deve ser importado pela pasta do projeto; o aplicativo não apresenta um segundo seletor de arquivos para complementar a permissão de diretório.

Import Folder

• um diretório de projeto KiCad com .kicad_pro válido, inclusive projetos somente de esquema

Seleção da origem em pastas e arquivos

Import Folder aceita apenas projetos KiCad: o PCBAtlas deve encontrar um .kicad_pro válido. Se não houver arquivo de projeto ou se o projeto não puder ser reaberto, a importação falha diretamente em vez de fazer fallback para .kicad_pcb ou .kicad_sch. Se vários projetos forem encontrados, a escolha é explícita, sem seleção silenciosa. Após uma importação bem-sucedida, todos os arquivos normais do diretório selecionado são preservados na mesma revisão, com seus caminhos relativos originais, incluindo notas ou saídas de fabricação fora do fechamento do projeto. Um arquivo ilegível, link simbólico ou outra entrada não suportada faz toda a importação falhar, sem salvar apenas uma parte.

Ao escolher um diretório de projeto em Files, iCloud Drive ou provedor de arquivos de terceiros, o aplicativo primeiro prepara o diretório completo como snapshot temporário local e só então verifica a entrada do projeto. Diretórios históricos como .history continuam na revisão em seus caminhos originais, mas PCB ou esquema dentro deles é material de suporte histórico e não disputa a entrada de abertura com o design atual ao lado de .kicad_pro.

Para projeto que ainda conserva esquemas KiCad 5 .sch, se o .kicad_pro apontar para .kicad_sch de mesmo nome que não existe, mas houver .sch exatamente de mesmo nome no diretório, o PCBAtlas reconhece esse .sch e seus child sheets como esquema do projeto e permite canvas duplo PCB/esquema. Ele não escolhe .sch não relacionado. Diretórios antigos com apenas .pro e sem .kicad_pro continuam fora do escopo de Import Folder.

Ao abrir um projeto KiCad, o aplicativo abre primeiro o esquema com o mesmo nome do projeto; sem ele, escolhe um esquema disponível pela ordem do caminho. Um projeto que contém PCB e esquema prepara dois canvas na mesma fase de progresso e mostra canvas duplo por padrão ao finalizar. Com apenas uma fonte de design, mostra canvas único e o botão de troca de canvas fica indisponível.

Comportamento especial para IPC-2581

Quando você seleciona um IPC-2581 XML, o aplicativo não assume se ele deve ser tratado como dados do lado do design ou do lado da fabricação. Em vez disso, mostra uma caixa de diálogo de confirmação para que você possa escolher:

• importar como dados de projeto
• importar como dados de fabricação

Etapas recomendadas

1. Clique em Import File ou Import Folder na página inicial da biblioteca.
2. Use Import File para arquivos independentes e arquivos compactados; use Import Folder para um diretório completo de projeto KiCad que contenha .kicad_pro.
3. Após selecionar um arquivo, caso seja um IPC-2581 XML, escolha a intenção de importação.
4. Aguarde o banner de progresso da importação na parte superior da biblioteca avançar.
5. Quando a importação termina, um novo cartão de documento aparece ou a contagem de revisões do documento de destino aumenta.
6. Abra o documento e confirme que um projeto com PCB e esquema mostra canvas duplo por padrão; um documento com apenas uma fonte de design mostra canvas único. Confirme também que o conteúdo de Project / Data está completo.

Que feedback você verá

• A parte superior da biblioteca mostra um banner em andamento com título, detalhes do estágio e porcentagem.
• Ao abrir um projeto, layouts verticais ou compactos permanecem na página de progresso do Viewer. Conteúdo interativo só aparece diretamente após os canvas ficarem prontos; a interface não muda cedo para Project.
• Se você abrir manualmente outro documento durante a importação, a tarefa ainda será concluída, mas não mudará forçosamente o foco de volta para o documento recém-importado.
• Se você soltar um novo arquivo de placa na área de trabalho enquanto outro documento estiver aberto, o aplicativo primeiro perguntará se deseja substituir o conteúdo atual.

Depois de importar um KiCad Project ou esquema

Depois de importar .kicad_pro por Import Folder ou por um .zip KiCad comum, o PCBAtlas salva os arquivos de projeto KiCad relacionados dentro da revisão da biblioteca e mostra uma página Project no espaço de trabalho. Import Folder também preserva outros arquivos normais do diretório selecionado. Ele agrupa o conteúdo em Source Documents / Libraries / Settings para confirmar quais arquivos de placa, esquemas, bibliotecas e configurações foram capturados. Uma .kicad_sch independente entra diretamente no espaço de trabalho de esquemas por Import File, sem solicitar o diretório pai.

Ao abrir um esquema, o espaço de trabalho ainda usa o canvas 2D, mas o Workbench à direita muda para a estrutura específica de esquemas:

• Sheets: inspeciona hierarquia, breadcrumb e child sheets que podem ser abertas.
• Search: pesquisa Symbols / Nets / Labels / Text / Markers em Current Sheet ou Whole Project.
• Selection / Details: mostra o objeto escolhido por resultados de busca ou pick no canvas.
• Problems: mostra resumos de problemas de importação, itens sem suporte e mensagens claras de problema quando o Workbench de esquemas está indisponível.

O canvas de esquemas permite selecionar symbol / pin / wire / bus / label / text / junction / marker. Seleção, detalhes e destaque permanecem sincronizados, candidatos sobrepostos podem ser alternados e um objeto selecionado que não seja uma net recebe uma moldura localizadora laranja. Quando há uma rota para a PCB, o modo de canvas único oferece Ver na PCB; a ação muda para a PCB, seleciona o footprint ou pad correspondente quando possível, caso contrário destaca a net conectada e ajusta a visualização ao alvo. A visualização dividida mantém o cross-probe vinculado entre os dois canvas. A edição do layout continua em uma ferramenta EDA dedicada.

Ações relacionadas à revisão

No menu de ação de um cartão de documento, você pode:

• anexar uma revisão de design
• anexar uma revisão de fabricação

Isso significa que a importação não serve apenas para criar novos documentos. É também como o histórico de revisões contínuas é mantido para o mesmo projeto.

Regra atual para reimportar o mesmo nome e formato

Quando uma fonte retorna com o mesmo nome de documento e o mesmo formato, a implementação atual trata isso como outra rodada de entrada para o mesmo documento, em vez de criar automaticamente um novo cartão de nível superior:

• se a fonte original recém-importada for idêntica byte a byte à revisão atual, o aplicativo informará que nada mudou e ignorará a importação
• se a fonte original for diferente, o aplicativo a armazena como uma nova revisão nesse documento e muda para a revisão mais recente
• os rótulos de revisão são exibidos dinamicamente como A1 / A2 / ... com base no nome do documento

Recomendações

• Para uma primeira passagem de validação, comece com um único arquivo DSN ou KiCad.
• Para dados de fabricação, confirme se o arquivo ou diretório está completo antes de importar.
• Para atualizações iterativas do mesmo projeto, prefira anexar revisões em vez de criar vários documentos quase idênticos.

Perguntas comuns

Por que o aplicativo pergunta novamente depois que eu escolho IPC-2581?

Porque o mesmo IPC-2581 XML pode ser tratado como dados do lado do design ou do lado da fabricação, e a implementação atual solicita que você escolha explicitamente.

Por que as intenções de design e fabricação do mesmo IPC-2581 às vezes parecem quase idênticas após a importação?

Isso é normal na versão atual. Para IPC-2581, a principal diferença hoje é a intenção de importação do lado da biblioteca e a classificação do documento, e não uma diferença visual imediatamente óbvia no espaço de trabalho.

• Se você escolher a intenção de design, o documento será gerenciado como material do lado do design.
• Se você escolher a intenção de fabricação, o documento será administrado como material de fabricação.
• Essa classificação afeta o comportamento de gerenciamento posterior, como o tipo padrão de revisão anexada.
• Importar o mesmo IPC-2581 com ambas as intenções geralmente cria dois documentos separados em vez de mesclá-los automaticamente.

Ao mesmo tempo, o flow de exibição atual ainda não expressa muito fortemente a distinção entre design e fabricação quando o arquivo é aberto, portanto, o resultado visível ainda pode parecer bastante semelhante.

Por que o seletor de importação não lista todos os sufixos dos pacotes de fabricação?

A importação de fabricação aceita arquivos, diretórios e entradas de dados gerais comuns. O resultado final depende do que o importador consegue realmente reconhecer da fonte selecionada.