Criando projetos e documentos
Altium Essentials: Project Creation and Storage
This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.
Num relance
- Entenda as opções disponíveis para armazenar projetos e os benefícios do gerenciamento baseado em Workspace.
- Saiba como usar a caixa de diálogo Criar projeto para selecionar modelos e configurar as opções do projeto.
- Veja como os novos projetos aparecem no painel Projetos e em quais situações um projeto contém apenas uma estrutura vazia.
O ponto de partida de todo projeto criado no Altium Designer é um projeto. Um projeto do Altium Designer reúne um conjunto de documentos de projeto cujos arquivos de saída definem, em última análise, uma implementação única daquilo que você pretende criar. Por exemplo, os esquemáticos e a PCB de um projeto de PCB incluem o conjunto de arquivos necessário para fabricar uma placa de circuito impresso. Em contrapartida, o conjunto de arquivos gerado a partir de um projeto de chicote elétrico é usado para comprar e montar um chicote elétrico, e os arquivos de esquemático lógico e de montagem física de um projeto multiplacas geram o conjunto de arquivos necessário para fabricar e montar um produto completo com várias PCBs conectadas.
O conjunto de documentos do projeto pode ser reunido a partir de qualquer fonte acessível, local ou não, com o arquivo de projeto relacionando esses documentos como um projeto unificado. O software usa compilação dinâmica para criar e gerenciar um modelo de dados unificado dos componentes do projeto e de sua conectividade. Esse modelo de dados pode então ser usado para propagar alterações entre os domínios do projeto — por exemplo, realizando a sincronização para resolver diferenças entre documentos dos domínios de Esquemático e PCB.
Os documentos do projeto podem ser criados e armazenados no seu Workspace Altium, no seu sistema de controle de versão ou localmente, como arquivos na rede disponível.
As seções abaixo descrevem como criar um novo projeto e adicionar documentos a um projeto existente.
Criar um novo projeto usando a caixa de diálogo Criar projeto
Um novo projeto pode ser criado no Altium Designer usando a caixa de diálogo Create Project (File » New » Project).
-
Na lista Locations, selecione a entrada do seu Workspace (ela aparecerá com o nome definido para ele) — você precisa estar conectado ao Workspace para ver essa opção na lista. Esse será o servidor de destino no qual seu novo projeto do Workspace será armazenado.
-
Na lista Project Type, escolha o tipo de projeto que deseja criar e selecione um dos modelos aplicáveis disponíveis, conforme necessário. A entrada <Empty> criará um projeto vazio, sem documentos-fonte iniciais.
Saiba mais sobre Criar um modelo de projeto.
-
Insira um Project Name e, opcionalmente, uma Description para o projeto.
A caixa de diálogo Create Project inclui opções adicionais:
-
Marque a opção Version Control (o padrão) para aplicar todos os recursos de VCS ao projeto, como histórico e recursos avançados de compartilhamento. Quando essa opção está desmarcada, o projeto é armazenado no Workspace e sincronizado com a cópia local — um projeto “espelhado” no formato Sincronização simples.
-
Ao criar um projeto do tipo PCB, marque a opção Constraint Management para gerenciar as restrições desse projeto usando o Gerenciador de restrições. Quando a opção está desativada, o sistema de regras de projeto será usado para esse projeto.
-
Quando há conexão com um Workspace do Enterprise Server, o menu suspenso Repository (se presente) listará todos os repositórios de projeto gerenciados pelo Serviço de controle de versão do Workspace e que foram compartilhados com você para uso. Escolha o repositório no qual armazenar o novo projeto e seus arquivos — há um único repositório baseado em Git (
Versioned Storage) disponível por padrão. Se um repositório do tipo SVN for selecionado, uma opção adicional Repository Folder ficará disponível para especificar ou procurar uma pasta de destino alternativa dentro do próprio repositório. -
Clique no controle Advanced para especificar os caminhos das pastas.
-
Use o campo Folder para especificar onde a pasta do projeto será criada na estrutura de pastas do Workspace. O caminho padrão para novos projetos é especificado na página Admin – Settings – Projects da interface do Workspace no navegador (por padrão, será
Projects\<ProjectName>). Clique no botão
para procurar e selecionar outra pasta do Workspace, se necessário.
-
Use o campo Local Storage para especificar onde a versão local do projeto será armazenada no disco rígido. O local padrão é definido na página Sistema – Locais padrão da caixa de diálogo Preferences. Clique no botão
para procurar e selecionar outra pasta, se necessário. Essa é a pasta de trabalho do projeto e do repositório Git local no qual ele é registrado por commit. Por fim, ou no momento do commit, o projeto é enviado para o repositório centralizado de projetos no Workspace (Versioned Storage), que é o repositório Git remote.
-
Use o campo Folder para especificar onde a pasta do projeto será criada na estrutura de pastas do Workspace. O caminho padrão para novos projetos é especificado na página Admin – Settings – Projects da interface do Workspace no navegador (por padrão, será
-
Use a área de lista Parameters para adicionar ou remover pares de parâmetros personalizados de Nome/Valor associados ao projeto e salvos no Workspace. Use o botão
para adicionar um novo par de Nome/Valor de parâmetro à lista ou o botão
para remover um par selecionado. Os campos Nome e Valor permitem no máximo 255 caracteres. Ao criar um projeto do Workspace, esses parâmetros são salvos no Workspace com o novo projeto como parâmetros de nível de projeto do lado do Workspace.
Quando um modelo de projeto é selecionado na lista Project Type da caixa de diálogo, a área de lista Parameters é preenchida com os parâmetros desse modelo. Se necessário, você pode alterar esses parâmetros (nomes e/ou valores) ou removê-los. Ao criar um projeto do Workspace, um parâmetro do modelo selecionado será salvo como um parâmetro de nível de projeto do lado do projeto se o nome do parâmetro não tiver sido alterado. Caso contrário, ele será salvo como um parâmetro de nível de projeto do lado do Workspace.
Com o projeto definido conforme necessário, clique no botão
. A estrutura do novo projeto será criada nas pastas locais e do Workspace especificadas. O projeto será aberto no painel Projetos, que refletirá o estado totalmente sincronizado entre os arquivos do repositório remoto de projetos (no Workspace) e o repositório local (cópia de trabalho), conforme indicado pelos ícones
associados. Se for criado com a opção Version Control desmarcada (disponível apenas em um Workspace do Altium 365), o projeto espelhado será exibido no painel Projects com um ícone
associado.
O projeto recém-criado registrado por commit no repositório de projetos Versioned Storage no Workspace.
Como alternativa, se o novo projeto not tiver recebido um modelo com documentos constituintes, apenas o arquivo do projeto (*.PrjPcb) e, portanto, a estrutura do projeto serão criados. O projeto será então aberto no painel Projetos, que o exibirá como Scheduled for addition, indicado pelo ícone
associado. Nesse momento, você pode adicionar documentos ao projeto ou simplesmente salvar a estrutura no Workspace em seu estado atual, ainda sem conteúdo. Para isso, clique no controle Save to Server associado à entrada do projeto no painel Projects — também disponível no menu de contexto acessado com o botão direito do mouse e no menu principal File. Na caixa de diálogo Salvar no servidor exibida em seguida, selecione/desmarque os arquivos a serem incluídos, adicione um Comment opcional e confirme o processo de salvamento com o botão
. Depois que o projeto for adicionado ao servidor, o painel Projects refletirá o estado totalmente sincronizado entre os arquivos do repositório do servidor e a cópia de trabalho local, conforme indicado pelos ícones
.
Como copiar um projeto
Para copiar um projeto do Workspace a partir do Altium Designer, clique com o botão direito na entrada do projeto no painel Projects e escolha o comando Make a copy no menu de contexto. Use a caixa de diálogo Create Project Copy para definir o Project Name (por padrão, será o nome do projeto original com o sufixo - Copy), a Description (que não é preenchida previamente), o caminho Folder (no Workspace) e o caminho Local Storage (para a cópia de trabalho).

Copie um projeto do Workspace a partir do Altium Designer.
Adicionar e remover um documento de projeto
Depois de criar um projeto, é possível adicionar, editar ou remover documentos do projeto ativo. A maneira mais simples de adicionar novos documentos a um projeto é clicar com o botão direito no nome do projeto no painel Projects e selecionar Add New to Project nas opções do menu de contexto. Como alternativa, escolha o tipo de documento desejado no submenu Project » Add New to Project dos menus principais para adicionar um novo documento ao projeto ativo.

Adicione um tipo específico de documento ou outro tipo de documento a um projeto.
Outros tipos de documentos relevantes para o projeto também podem ser adicionados, como arquivos de texto, PDFs, planilhas etc. Para isso, use a opção Add Existing to Project (ou o comando Project » Add Existing to Project do menu principal do editor do documento ativo) e defina a lista suspensa File Type na caixa de diálogo de navegação Choose Document to Add como All Files (*.*) para que todos os tipos de arquivo possam ser acessados.
Para remover um documento da estrutura do projeto, clique com o botão direito no nome dele no painel Projects e selecione a opção de menu Remove from Project ou escolha o comando Project » Exclude from Project nos menus principais. Será solicitado que você escolha:
- Delete File – para remover permanentemente o próprio arquivo do documento de origem.
-
Exclude from Project – para remover o vínculo do projeto com esse documento (sem excluir o próprio arquivo do documento de origem). Se ele estiver aberto na janela do editor de projeto, será removido do projeto ao qual pertence, mas permanecerá aberto no painel como um documento avulso. No entanto, se não estiver aberto no espaço de projeto, a remoção efetivamente o fechará.
Remover um projeto
Para projetos locais, basta excluir os arquivos do disco rígido. Abra a pasta do projeto no Explorador de Arquivos do Windows e exclua seu conteúdo.
Para projetos do Workspace (e outros conteúdos do Workspace, como componentes e dados liberados), há recursos flexíveis para remoção diretamente no Altium Designer, pelo painel Explorer. Funcionando como uma “exclusão reversível”, o processo de remoção oferece mais opções e informações à medida que você avança, incluindo links relevantes para os itens de origem para revisão. No Workspace, o conteúdo excluído é movido para um local Trash dedicado, onde pode ser recuperado ou removido completamente pela página Trash da interface do Workspace no navegador.
Para excluir logicamente um projeto do Workspace, navegue até a pasta do projeto no painel Explorer, clique com o botão direito do mouse na entrada correspondente e selecione o comando Delete Folder no menu de contexto. Confirme a exclusão na caixa de diálogo Confirm Delete exibida. Se o projeto contiver dados liberados, outra caixa de diálogo de confirmação será aberta, informando que esses dados também serão excluídos. Clique em Delete para continuar.

Exclusão lógica em ação. Aqui, um projeto está sendo excluído, juntamente com sua versão liberada associada (se pacotes de fabricação tivessem sido criados a partir de alguma versão liberada, eles também seriam excluídos).
