Criando projetos e documentos

Altium Training

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

Todo projeto no Altium Designer começa com a criação de um projeto que reúne seus documentos de design. Este artigo explica como criar um projeto no Altium Designer, escolher um tipo de projeto e um modelo, além de configurar o armazenamento em um Workspace conectado, em um repositório externo de controle de versão ou em uma pasta local. Também aborda opções de configuração, como controle de versão, gerenciamento de restrições, caminhos de pastas e parâmetros do projeto. Continue lendo para estabelecer uma base sólida para seu próximo projeto.

- 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.
Aprofunde-se com a IA:

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).

A caixa de diálogo Create Project permite criar um novo projeto no Workspace ao qual você está conectado, adicionar um novo projeto a um repositório externo de controle de versão existente (com uma cópia de trabalho no local de sua preferência) e criar um novo projeto em uma pasta específica no seu disco rígido local.

  1. 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.

    Em resumo, o gerenciamento de projetos se concentra em armazenar com segurança e rastrear alterações ao longo do processo de desenvolvimento e, por fim, encaminhar o projeto resultante para a criação de um item físico — como uma PCB montada a ser usada no produto final. Para atender a essas necessidades, o Altium Designer oferece diversas abordagens de gerenciamento de projetos com níveis crescentes de sofisticação e recursos, mas que simplificam o processo do ponto de vista do projetista. Essas abordagens vão do armazenamento e gerenciamento local baseado em arquivos às formas de armazenamento em sistemas de controle de versão (VCS) locais/remotos, até chegar à sua forma avançada e recomendada, na qual o gerenciamento dos dados de projeto se concentra nos recursos de um Workspace.

    Um Workspace conectado e seu serviço interno de VCS hospedam e gerenciam projetos do Altium Designer, além de fornecer operações simplificadas de VCS, recursos integrados de colaboração em projetos, compartilhamento avançado de dados de projeto, rastreamento do histórico, gerenciamento do ciclo de vida e muito mais. Os projetos integrados a um Workspace são acessados diretamente pelo Altium Designer, por exemplo, pelo painel Projects, ou pelo próprio Workspace por meio de sua interface no navegador.

    Graças à inteligência incorporada aos serviços fornecidos por um Workspace, tarefas como operações de VCS são simplificadas e automatizadas, e recursos adicionais de colaboração em projetos, como controle de acesso de usuários (compartilhamento), comentários e histórico, ficam disponíveis diretamente no Altium Designer. O resultado é um formato e um local de armazenamento de projetos robustos e seguros, que podem se tornar o ponto central do desenvolvimento colaborativo de projetos.

    Quando há conexão com um Workspace com uma ou mais definições de processo ativas para o tema de processo Criação de projetos, a capacidade de criar um novo projeto por meio da caixa de diálogo Create Project fica restrita apenas a projetos dos tipos Local e VCS. Nesse caso, a criação de projetos baseados no Workspace passa a ser controlada pelas definições de processo ativas. Saiba mais sobre Criação de projetos baseada em processos.

  2. 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.

  3. Insira um Project Name e, opcionalmente, uma Description para o projeto.

    O nome do projeto deve começar com e pode conter A-Z, a-z ou 0-9. Sublinhados, hífens e espaços são permitidos, mas os espaços só podem ser usados no meio do nome (espaços no início e no fim serão ignorados). Você não pode usar as seguintes palavras: AUX, COM1-COM9, LPT1-LPT9, CON, NUL e PRN. Além disso, o nome não pode conter os seguintes caracteres: \ . / ? % * : | " < >.

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.

    A opção Version Control só está disponível quando há conexão com um Workspace do Altium 365. Quando há conexão com um Workspace do Enterprise Server, essa opção é considerada marcada.
  • 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.

    A opção Constraint Management fica ativada por padrão na caixa de diálogo Create Project quando a opção System.ConstraintManager está ativada na caixa de diálogo Configurações avançadas.

  • 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.

    O menu suspenso Repository só aparece se você tiver atualizado seu Enterprise Server a partir de uma versão ou de um produto de servidor em que o uso de repositórios SVN estava ativado. Caso contrário, o Enterprise Server fornece um único repositório de projetos baseado em Git para acomodar todos os projetos do seu Workspace, e o menu suspenso Repository não aparecerá nesse caso.

    O SVN não é compatível com o Altium On-Prem Enterprise Server a partir da versão 7.2. Para evitar limitações no gerenciamento de um projeto SVN, recomenda-se migrar os projetos SVN para o repositório Git integrado do Workspace do Enterprise Server. Isso pode ser feito antes de atualizar o servidor, conforme descrito aqui.

    Para obter mais informações sobre a descontinuação do SVN no Altium On-Prem Enterprise Server, consulte o artigo da Base de Conhecimento Descontinuação do SVN no Altium On-Prem Enterprise Server 7.2.1.

  • 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.

      Se o usuário que criar um projeto no Workspace conectado não tiver permissões de gravação na pasta padrão de projetos, o sistema criará automaticamente uma estrutura Personal Folder específica do usuário para armazenar o novo projeto. Ela aparece como uma pasta de nível superior baseada no endereço de e-mail do membro (para um Workspace do Altium 365) ou no nome de usuário (para um Workspace do Enterprise Server), com uma subpasta My Projects que armazena os projetos desse usuário. A estrutura/hierarquia de pastas está disponível apenas para o usuário conectado e os administradores — ela não é visível para outros usuários. Saiba mais sobre Managing Project Creation Permissions (Workspace do Altium 365, Workspace do Enterprise Server).

    • 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 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.

    Os parâmetros de nível de projeto do lado do Workspace podem ser editados no Workspace. Por outro lado, os parâmetros do lado do projeto são salvos no arquivo do projeto (*.PrjPcb) e podem ser editados no Altium Designer. Os parâmetros de nível de projeto de ambos os tipos podem ser visualizados na aba Parâmetros da caixa de diálogo Project Options (Project » Project Options) e podem ser usados como Strings especiais no Altium Designer.

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.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 .

  • O projeto aparecerá no painel Projects sob uma entrada do Workspace de destino, com o nome desse Workspace.

  • Além disso, uma entrada do projeto aparecerá na página Projects da interface do Workspace no navegador.

  • Inicialmente, o projeto será compartilhado com acesso de leitura/gravação com o projetista que o criou (Proprietário) e com todos os administradores do Workspace.

    Consulte Compartilhamento de um projeto para obter mais informações sobre como configurar as permissões de acesso ao projeto.

  • Um novo projeto também pode ser criado diretamente em um Workspace pela interface no navegador, na página de projetos (selecione Projects), e posteriormente aberto no Altium Designer para edição e adição de conteúdo.

  • Junto com o arquivo do projeto (*.PrjPcb), é criado o arquivo de estrutura do projeto (*.PrjPCBStructure). Esse arquivo contém informações sobre a hierarquia do projeto, seja ela plana ou hierárquica. Esse arquivo é gerado novamente durante a compilação dinâmica do projeto (quando um documento do projeto é aberto).

  • A caixa de diálogo Create Project também pode ser acessada clicando com o botão direito do mouse na entrada do Workspace no painel Projects  e escolhendo o comando Create Project no menu.

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).

Não são necessárias permissões especiais para copiar um projeto. O projeto copiado é uma cópia exata do projeto original do Workspace e tem as mesmas propriedades de edição, sem restrições, ou seja, não é possível criar um projeto “somente leitura”. Observe também que o projeto copiado será criado no mesmo repositório de projetos do original, ou seja, não é possível alterar isso durante o processo de cópia.

O Folder do Workspace será, por padrão, a mesma pasta em que o projeto original está armazenado. Clique em para abrir a caixa de diálogo Choose Folder (uma versão simplificada do painel Explorer) e alterar a pasta conforme necessário. Por padrão, o Local Storage será configurado para usar o local definido na página Sistema - Locais padrão da caixa de diálogo Preferences. Clique em para abrir uma caixa de diálogo padrão do Windows e alterar esse local conforme necessário.

Copie um projeto do Workspace a partir do Altium Designer.
Copie um projeto do Workspace a partir do Altium Designer.

Cada vez que você copiar o projeto, um bloco de evento Project Copied será adicionado à linha do tempo do histórico do projeto copiado. Além disso, o bloco Project Created da cópia do projeto incluirá um link para o projeto original. Saiba mais sobre Histórico do projeto.
Você pode copiar um projeto existente do Workspace pela caixa de diálogo Abrir projeto. Selecione o projeto no Workspace ao qual você está conectado e clique no controle Open Project As Copy na parte inferior do painel Information à direita. Além disso, ao navegar pelo projeto no painel Explorer do Altium Designer — configurado no modo padrão Project View, em vez de Classic View —, é possível copiar o projeto clicando no botão Copy  no canto superior direito do painel.
Você só pode copiar um projeto do Workspace que tenha sido aberto a partir do Altium Workspace ao qual está conectado no momento. Se o Altium Designer não estiver conectado ao Workspace do projeto, ou se o projeto não for um projeto do Workspace, o comando Make a copy não estará disponível no menu exibido ao clicar com o botão direito.

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.

  • Se for possível especificar padrões para o tipo de documento escolhido na página Gerenciamento de dados - Modelos da caixa de diálogo Preferences, o documento será criado usando esse padrão como modelo.
  • Inicialmente, o documento não está salvo.

Adicione um tipo específico de documento ou outro tipo de documento a um projeto.
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.

Os projetos não estão limitados a conter apenas arquivos criados pelo Altium Designer — praticamente qualquer documento pode ser incluído em um projeto. Quando o documento é acessado a partir do Altium Designer, o sistema tenta determinar a ferramenta de criação/visualização correspondente com base na extensão do arquivo e nas configurações do Registro do Windows. Se uma correspondência for encontrada, o Altium Designer iniciará o editor associado, em seu próprio ambiente de edição ou como um aplicativo separado. Isso significa que você pode incluir todos os tipos de documentos de teste, documentação, informações de referência e especificações em seus projetos, com a confiança de que, aonde quer que o projeto vá, toda a documentação de apoio o acompanhará.
Ao adicionar documentos existentes a um projeto do Workspace do Altium 365, observe que há uma limitação para arquivos zip, 7z e rar maiores que 256 MB. Projetos que contenham esses arquivos não podem ser salvos no Workspace — você receberá um erro do Git. Consulte o artigo Como corrigir os dados do projeto após um erro do Git com o código de status 471 na Base de conhecimento para saber como resolver esse problema.

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á.

Você também pode remover do projeto ao qual pertencem todos os documentos da categoria em foco (subpasta), clicando com o botão direito na entrada da categoria desejada e escolhendo o comando Remove All no menu de contexto.

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 abrir rapidamente uma janela do Explorador de Arquivos do Windows no local em que o projeto está armazenado, clique com o botão direito na entrada do projeto no painel Projects e selecione o comando Explore.

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.

No caso de um projeto, somente o proprietário ou um administrador pode excluí-lo permanentemente ou restaurá-lo a partir da Trash.

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.

Para abrir rapidamente o painel Explorer com a pasta do projeto selecionada, clique com o botão direito do mouse na entrada do projeto no painel Projects e selecione o comando Show in Explorer.

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).
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).

AI-LocalizedLocalizado por IA
Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.
Nav
Contents
Disponibilidade de Recursos

Os recursos disponíveis para você dependem de qual solução Altium você possui – Altium Develop, Altium Agile Teams, Altium Agile Enterprise ou Altium Designer (com assinatura ativa).

Se você não vir um recurso documentado no software que está usando no momento, entre em contato com a equipe de vendas da Altium para saber mais.

Documentação Legada

A documentação do Altium Designer já não é versionada. Se precisar de aceder à documentação de versões anteriores do Altium Designer, visite a secção Documentação Legada da página de Outros Instaladores.

Contents