Biblioteca e revisões¶
Meta¶
Ajuda você a transformar arquivos de origem soltos em espaços de trabalho de quadro que podem ser reabertos, estendidos com novas revisões e compartilhados.
Plataformas Suportadas¶
iOSmacOS
Público-alvo¶
- Usuários organizando painéis importados em uma biblioteca reutilizável
- Testadores validando documentos, revisões e comportamento de compartilhamento
Pré-requisitos¶
- O aplicativo já está aberto na página inicial da biblioteca
- Pelo menos um documento está disponível ou os arquivos de origem estão prontos para importação
Etapas¶
- Revise a lista de documentos no modo de grade ou de lista e abra o menu de ação de um documento de destino.
- Use as ações no nível do documento para inspecionar metadados, anexar revisões, duplicar, fixar ou compartilhar conforme necessário.
- Reabra o documento após as alterações e confirme se as atualizações de revisão e metadados são refletidas na biblioteca.
Resultado¶
- Os documentos permanecem organizados como entradas de projeto reutilizáveis e as revisões podem ser mantidas sem criar duplicatas desnecessárias de nível superior.
O que a página inicial da biblioteca pode fazer¶
- alternar entre layouts de grade e lista
- importar novos documentos de design ou fabricação
- inserir seleção de lote e exclusão de lote
- visualize a miniatura, o formato, a hora da última abertura e a contagem de revisões de cada documento
- renomear, duplicar, fixar, excluir, compartilhar ou inspecionar um único documento




Relação entre documentos e revisões¶
- Documento: uma entrada de projeto na biblioteca
- Revisão: uma versão histórica desse documento
- Revisão atual: a revisão atualmente aberta, exibida e exportada
Quando você anexa uma revisão, o aplicativo não cria um cartão de nível superior separado. Em vez disso, o revisionCount do cartão aumenta e você pode mudar a revisão atual dentro do documento.
Árvores de fonte para documentos KiCad Project¶
Quando um documento vem de KiCad .kicad_pro, a biblioteca salva mais do que um único arquivo de entrada: ela mantém o conjunto de fontes do projeto associado àquela revisão. Depois de aberto, a página Project do espaço de trabalho agrupa o conteúdo em:
Source Documents: arquivos PCB, schematic sheets e outros documentos de design que podem ser abertos.Libraries: arquivos de bibliotecas de symbol / footprint e outros recursos incluídos ou referenciados pelo projeto.Settings:.kicad_proe arquivos de configuração do projeto.
Isso mantém o PCB e os esquemas de um projeto dentro do mesmo documento de biblioteca e contexto de revisão. Ao anexar revisões, prefira importar o projeto completo ou o conjunto de fontes relacionado para não perder sheets, bibliotecas ou configurações depois.
Principais ações no menu do documento¶
No menu de cada cartão de documento, você pode:
- anexar uma revisão de design
- anexar uma revisão de fabricação
- importar SES
- renomear
- duplicado
- ver informações
- compartilhar
- fixar/desfixar
- excluir
Regras especiais para SES¶
SES não é um caminho de importação de novos documentos de uso geral. A implementação atual exige que você:
- abra o menu de ação do documento de destino
- escolha
Import SES - escolha uma revisão base utilizável na lista
Se esse documento não tiver nenhuma revisão base elegível, o aplicativo mostrará uma mensagem de status em vez de falhar silenciosamente.
O que a ficha informativa mostra¶
Ao clicar em Information, você pode inspecionar:
- nome do documento
- tipo de arquivo
- tempo de importação
- hora da última abertura
- ID da revisão atual
- contagem total de revisões
- lista completa de revisões
Tudo isso pode ser copiado para notas de teste e reprodução de problemas.
Recomendações¶
- Para evolução contínua do mesmo projeto, prefira anexar revisão.
- Se você quiser preservar um branch experimental, use duplicate para criar um documento separado.
- Fixe documentos importantes para reduzir o risco de exclusão acidental ou seleção incorreta.
- Após a conclusão da importação, abra a revisão atual uma vez para confirmar se o conteúdo, a miniatura e a hora da última abertura foram atualizados corretamente.
Perguntas comuns¶
Por que um documento contém múltiplas revisões?¶
Porque o modelo de biblioteca atual é projetado em torno da evolução contínua do projeto. Várias revisões permitem rastrear o histórico de alterações em um único contexto de projeto.
Se eu abrir outro documento enquanto a importação ainda estiver em execução, o documento recém-importado roubará o foco mais tarde?¶
Não. A importação continua e é concluída, mas não força a UI de volta ao documento recém-importado.
O compartilhamento envia todo o pacote de documentos?¶
A ação de compartilhamento da biblioteca prepara um item de compartilhamento a partir do caminho raiz compartilhável do documento atual. Para fontes agrupadas ou baseadas em diretório, o resultado compartilhado é baseado nessa raiz de origem, e não apenas em um resumo de texto.