Creating Projects and Documents

O ponto de partida para cada projeto criado no Altium Designer é um projeto. Um projeto do Altium Designer reúne um conjunto de documentos de projeto cujo resultado define, em última análise, uma única implementação daquilo que pretende criar. Por exemplo, os esquemáticos e a PCB num projeto PCB incluem o conjunto de ficheiros necessário para fabricar uma placa de circuito impresso. Em contraste, o conjunto de ficheiros gerado a partir de um projeto de arnês é utilizado para comprar e montar um arnês de cablagem, e os ficheiros de esquema lógico e de montagem física num projeto multi-board geram o conjunto de ficheiros para fabricar e montar um produto completo com várias PCBs ligadas entre si.

O conjunto de documentos de projeto do projeto pode ser reunido a partir de qualquer origem acessível, local à máquina ou não, relacionando-os o ficheiro de projeto entre si como um projeto unificado. O software utiliza compilação dinâmica para criar e gerir um modelo de dados unificado dos componentes do projeto e da respetiva conectividade. Este modelo de dados pode depois ser utilizado para propagar alterações de projeto entre os domínios de projeto – por exemplo, sincronizando para resolver diferenças entre documentos nos domínios Schematic e PCB.

Os documentos do projeto podem ser criados e armazenados no seu Workspace Altium, no seu sistema de controlo de versões, ou localmente como ficheiros na rede disponível.

As secções abaixo descrevem como criar um novo projeto e adicionar documentos de projeto a um projeto existente.

Criar um Novo Projeto Utilizando a Caixa de Diálogo Create Project

Um novo projeto pode ser criado no Altium Designer utilizando a caixa de diálogo Create Project (File » New » Project).

1. Na lista Locations, selecione a entrada do seu Workspace (aparecerá com o nome definido para o mesmo) – tem de estar ativamente ligado ao Workspace para ver esta opção na lista. Este será o servidor de destino onde armazenar o seu novo projeto do Workspace.

   Em resumo, a gestão de projetos centra-se no armazenamento seguro e no acompanhamento das alterações ao longo de todo o processo de projeto e, em última análise, em encaminhar o projeto resultante até à criação de um item físico – como, por exemplo, uma PCB montada para ser utilizada no produto final. Para responder a estas necessidades, o Altium Designer disponibiliza um conjunto de abordagens de gestão de projetos que oferecem níveis crescentes de sofisticação e capacidades, simplificando ao mesmo tempo o processo do ponto de vista do projetista. Estas vão desde o armazenamento e gestão locais baseados em ficheiros, passando por abordagens de armazenamento em Sistema de Controlo de Versões (VCS) local/remoto, até à sua forma avançada e recomendada, em que a gestão dos dados de projeto está centrada nas capacidades de um Workspace.

   Um Workspace ligado e o seu serviço VCS interno alojam e gerem projetos do Altium Designer, além de fornecerem operações VCS simplificadas, capacidades inerentes de colaboração no projeto, partilha avançada de dados de projeto, rastreio do histórico, gestão do ciclo de vida e muito mais. Os projetos integrados com um Workspace são acedidos diretamente a partir do Altium Designer, como por exemplo através do painel Projects, ou a partir do próprio Workspace através da sua interface baseada em navegador.

   Graças à inteligência incorporada nos serviços fornecidos por um Workspace, tarefas como operações VCS são simplificadas e automatizadas, e funcionalidades adicionais de colaboração no projeto, como controlo de acesso de utilizadores (partilha), comentários e histórico, estão disponíveis diretamente a partir do Altium Designer. O resultado final é um formato e local de armazenamento de projetos robusto e seguro que pode tornar-se o ponto central para o projeto colaborativo de projetos.

   Quando está ligado a um Workspace com uma ou mais definições de processo ativas para o tema de processo Project Creations, a capacidade de criar um novo projeto através da caixa de diálogo Create Project fica restringida apenas a projetos do tipo Local e VCS. Em vez disso, a criação de projetos baseados em Workspace fica sob o controlo das 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 pretende criar e selecione, conforme necessário, um dos modelos aplicáveis disponíveis. A entrada <Empty> criará um projeto base sem documentos-fonte iniciais.

   Saiba mais sobre Criar um Modelo de Projeto.

3. Introduza um Project Name e, opcionalmente, uma Description do projeto.

   O nome do projeto deve começar com e pode conter A-Z, a-z ou 0-9. São permitidos underscores, hífenes e espaços, mas estes últimos só podem ser utilizados no meio do nome (os espaços iniciais e finais serão ignorados). Não pode utilizar 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:

• Selecione a opção Version Control (predefinida) para impor ao projeto todas as capacidades VCS, como histórico e capacidades avançadas de partilha. Quando desmarcada, o projeto é armazenado no Workspace e sincronizado com a cópia local – um projeto “espelhado” no formato Simple Sync.

  A opção Version Control só está disponível quando ligado a um Altium 365 Workspace. Quando ligado a um Enterprise Server Workspace, esta opção fica efetivamente selecionada.

• Ao criar um projeto do tipo PCB, selecione a opção Constraint Management para gerir as restrições de projeto deste projeto utilizando o Constraint Manager. Quando a opção estiver desativada, será utilizado para este projeto o sistema de regras de projeto.

  A opção Constraint Management é ativada na caixa de diálogo Create Project por predefinição quando a opção System.ConstraintManager está ativada na caixa de diálogo Advanced Settings dialog.

• Quando ligado a um Enterprise Server Workspace, o menu pendente Repository (se presente) irá listar todos os repositórios de projeto geridos através do Version Control Service do Workspace, e que tenham sido partilhados consigo para utilização. Escolha o repositório onde armazenar o novo projeto e os respetivos ficheiros – existe, por predefinição, um único repositório baseado em Git (Versioned Storage) disponível. Se for selecionado um repositório do tipo SVN, fica disponível uma opção adicional Repository Folder para especificar ou procurar uma pasta de destino alternativa dentro do próprio repositório.

  O menu pendente Repository só é apresentado se tiver atualizado o seu Enterprise Server a partir de uma versão ou produto de servidor em que a utilização de repositórios SVN estava ativada. Em alternativa, o Enterprise Server fornece um único repositório de projeto baseado em Git para alojar todos os seus projetos de projeto do Workspace, e o menu pendente Repository não será apresentado nesse caso.

  O SVN não é suportado no Altium On-Prem Enterprise Server a partir da versão 7.2. Para evitar limitações na gestão de um projeto SVN, recomenda-se que os projetos SVN sejam migrados para o repositório Git incorporado do Enterprise Server Workspace. Isto pode ser feito antes da atualização do servidor, conforme descrito aqui.

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

• Clique no controlo Advanced para especificar caminhos de pastas.

  • Utilize o campo Folder para especificar onde será criada a pasta do projeto – dentro da estrutura de pastas do Workspace. O caminho predefinido para novos projetos é especificado na página Admin – Settings – Projects da interface do navegador do Workspace (por predefinição, será Projects\<ProjectName>). Clique no botão para procurar e selecionar uma pasta diferente do Workspace, se necessário.

    Se o utilizador que cria um projeto no Workspace ligado não tiver permissões de escrita para a pasta predefinida do projeto, o sistema criará automaticamente uma estrutura Personal Folder específica do utilizador para armazenar o novo projeto. Esta surge como uma pasta de nível superior baseada no endereço de e-mail do membro (para um Altium 365 Workspace) ou no nome de utilizador (para um Enterprise Server Workspace), com uma subpasta My Projects que armazena os projetos desse utilizador. A estrutura/hierarquia de pastas está disponível apenas para o utilizador autenticado e para os administradores – não é visível para outros utilizadores. Saiba mais sobre Managing Project Creation Permissions (Altium 365 Workspace, Enterprise Server Workspace).

  • Utilize o campo Local Storage para especificar onde será armazenada, no seu disco rígido, a versão local do projeto. A localização predefinida é definida na página System – Default Locations da caixa de diálogo Preferences. Clique no botão para procurar e selecionar uma localização de pasta diferente, se necessário. Esta é a pasta de “trabalho” do projeto e do repositório Git local ao qual é submetido. Em última instância, ou no momento da submissão, o projeto é enviado para o repositório centralizado de projeto no Workspace (Versioned Storage), que é o repositório Git remote.

   

• Use a área de lista Parameters para adicionar ou remover pares personalizados de parâmetros Nome/Valor associados ao projeto e guardados no Workspace. Utilize o botão para adicionar um novo par Nome-Valor à lista ou o botão para remover um par selecionado. Os campos Nome e Valor permitem um máximo de 255 caracteres. Ao criar um projeto do Workspace, estes parâmetros do projeto do Workspace são guardados no Workspace com o novo projeto como parâmetros ao nível do projeto do lado do Workspace.

  Quando é selecionado um modelo de projeto na lista Project Type da caixa de diálogo, a área de lista Parameters será carregada com parâmetros desse modelo. Se necessário, pode alterar estes parâmetros (nomes e/ou valores) ou removê-los. Ao criar um projeto do Workspace, um parâmetro do modelo selecionado será guardado como parâmetro ao nível do projeto do lado do design se o nome do parâmetro não tiver sido alterado. Caso contrário, será guardado como parâmetro ao nível do projeto do lado do Workspace.

  Os parâmetros ao nível do projeto do lado do Workspace podem ser editados no Workspace. Em contrapartida, os parâmetros do lado do design são guardados no ficheiro do projeto (*.PrjPcb) e podem ser editados no Altium Designer. Os parâmetros ao nível do projeto de ambos os tipos podem ser visualizados no separador Parameters da caixa de diálogo Project Options (Project » Project Options) e podem ser utilizados como Special Strings no Altium Designer.

Com o projeto definido conforme necessário, clique no botão . A nova estrutura do projeto será criada nas pastas locais e do Workspace especificadas. O projeto será aberto no painel Projects panel, que refletirá o estado totalmente sincronizado existente entre os ficheiros no repositório de design remoto (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 num Altium 365 Workspace), o projeto espelhado será apresentado no painel Projects com um ícone associado.

O projeto recém-criado foi submetido ao repositório de design Versioned Storage no Workspace.

Em alternativa, se tiver sido atribuído ao novo projeto um modelo com documentos constituintes, apenas serão criados o ficheiro do projeto (*.PrjPcb) e, consequentemente, a estrutura do projeto. O projeto é então aberto no painel Projects panel, que o mostrará como estando Scheduled for addition, assinalado pelo ícone associado. Nesta fase, pode adicionar documentos ao projeto ou simplesmente guardar a estrutura no Workspace no seu estado atual de shell. Para o fazer, clique no controlo Save to Server associado à entrada do projeto no painel Projects – também disponível no menu de contexto do botão direito e no menu principal File. Na caixa de diálogo Save to Server dialog seguinte, selecione/desselecione ficheiros para inclusão, adicione um Comment opcional e confirme depois o processo de gravação com o botão . Assim que o projeto for adicionado ao servidor, o painel Projects refletirá o estado totalmente sincronizado existente entre os ficheiros no repositório do servidor e a cópia de trabalho local, conforme indicado pelos ícones .

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. Utilize a caixa de diálogo Create Project Copy para determinar o Project Name (por predefinição, será o nome do projeto original com o sufixo - Copy), o Description (que não é pré-preenchido), o caminho Folder (dentro do Workspace) e o caminho Local Storage (para a cópia de trabalho).

A Folder do Workspace será, por predefinição, a mesma pasta em que o projeto original está guardado. Clique em para abrir a caixa de diálogo Choose Folder (uma versão reduzida do painel Explorer) para alterar a pasta conforme necessário. O Local Storage será, por predefinição, definido para utilizar a localização definida na página System - Default Locations da caixa de diálogo Preferences. Clique em para abrir uma caixa de diálogo padrão do Windows através da qual pode alterar esta localização conforme necessário.

Copie um projeto do Workspace a partir do Altium Designer.

Adicionar e Remover um Documento de Design

Depois de um projeto estar estabelecido, podem ser adicionados, editados ou removidos documentos de design do projeto ativo. A forma mais simples de adicionar novos documentos de design 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. Em alternativa, escolha o tipo de documento pretendido no submenu Project » Add New to Project dos menus principais para adicionar um novo documento ao projeto ativo.

Adicionar um tipo específico ou outro tipo de documento a um projeto.

Também podem ser adicionados a um projeto outros tipos de documentos relevantes para o projeto, tais como ficheiros de texto, PDFs, folhas de cálculo, etc. Para o fazer, utilize 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 pendente File Type na caixa de diálogo do navegador Choose Document to Add para All Files (*.*), para que todos os tipos de ficheiro possam ser acedidos.

Para remover um documento da estrutura do projeto, clique com o botão direito no respetivo nome 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-lhe-á pedido que escolha:

• Delete File – para remover permanentemente o próprio ficheiro do documento de origem.

• Exclude from Project – para remover a ligação do projeto a esse documento (sem eliminar o próprio ficheiro do documento de origem). Se estiver atualmente aberto na janela do editor de design, será removido do projeto principal, mas permanecerá aberto no painel como um documento livre. No entanto, se não estiver atualmente aberto no espaço de design, a remoção irá efetivamente fechá-lo.

  

Remover um Projeto

Para projetos locais, remover um projeto consiste em eliminar ficheiros do disco rígido. Abra a pasta do projeto no Explorador do Windows e elimine o respetivo conteúdo.

Para projetos Workspace (e outro conteúdo do Workspace, como componentes e dados libertados), está disponível uma funcionalidade flexível para remover diretamente a partir do Altium Designer, no painel Explorer panel. Funcionando como uma “eliminação lógica”, o processo de remoção disponibiliza mais opções e informações à medida que avança, incluindo ligações relevantes para os itens de origem para efeitos de revisão. No Workspace, o conteúdo eliminado é movido para uma localização dedicada Trash , onde pode ser recuperado ou completamente removido na página Trash da interface do navegador do Workspace.

Para eliminar logicamente um projeto Workspace, navegue até à pasta do projeto no painel Explorer, clique com o botão direito na respetiva entrada e selecione o comando Delete Folder no menu de contexto. Confirme a eliminação na caixa de diálogo Confirm Delete apresentada. Se o projeto contiver dados libertados, será aberta outra caixa de diálogo de confirmação, informando-o de que esses dados também serão eliminados. Clique em Delete para continuar.

Exemplo de eliminação lógica em ação. Aqui, está a ser eliminado um projeto, juntamente com a respetiva libertação (se tivessem sido criados pacotes de fabrico a partir de quaisquer libertações, estes também seriam eliminados).