O método recomendado e mais poderoso para trabalhar com projetos é criar um novo projeto diretamente no Workspace ligado. Se tiver um projeto existente, pode trazê-lo para o seu Workspace tornando-o disponível online e optando por ativar o controlo de versões formal. Em cada caso, o projeto será armazenado e gerido através do Sistema de Controlo de Versões (VCS) nativo do Workspace. Isto dá-lhe toda a funcionalidade de um projeto ao trabalhar com ele através do Altium Designer. Ter o seu projeto sob gestão completa do VCS do Workspace é a única forma de partilhar esse projeto com várias pessoas para edição através do Altium Designer (desde que sejam membros do Workspace) e beneficiar das funcionalidades adicionais da plataforma, tais como o rastreio de histórico e a partilha avançada de projetos.
Um projeto local que não esteja sob controlo de versões ou que esteja sob controlo de versões externo pode ser registado no seu Workspace utilizando uma metodologia chamada
Simple Sync. É criada uma cópia espelho do seu projeto no Workspace e sincronizada. Assim que as alterações aos ficheiros locais são guardadas (ou guardadas e submetidas ao repositório de design externo), essas alterações são automaticamente sincronizadas com as respetivas contrapartes do projeto espelhado no Workspace. O Simple Sync permite-lhe usufruir das funcionalidades de colaboração disponíveis através da plataforma Altium 365, mantendo o seu projeto original exatamente onde está. No entanto, tenha em mente que, para um projeto de design local (não sob VCS externo), esse projeto só pode ser editado por uma única pessoa (o proprietário desse projeto – quem o disponibilizou online no Workspace).
Para disponibilizar um projeto existente (um projeto local ou um projeto atualmente sob controlo de versões externo) ao Workspace – quer como projeto espelhado (Simple Sync) num Altium 365 Workspace quer sob o Controlo de Versões Git nativo de um Workspace – abra o projeto normalmente no Altium Designer, depois clique com o botão direito na respetiva entrada no Projects panel e selecione Make Project Available Online no menu de contexto, obtendo acesso à caixa de diálogo Make Available Online. Ao utilizar um Enterprise Server Workspace, o comando Make Project Available on Server abre a caixa de diálogo Make Available On Server.
Quando está ligado a um Workspace com uma ou mais definições de processo ativas para o tema de processo Project Creations, a disponibilização de um projeto existente ao Workspace é efetuada clicando com o botão direito na entrada do projeto no painel
Projects e selecionando um comando no submenu
Convert to Managed Project – saiba mais sobre
Process-based Project Converting.

Disponibilize um projeto local existente ao Workspace, essencialmente 'registando-o' no Workspace e criando uma 'cópia espelho' do mesmo.
Options and Controls of the Make Available Online Dialog
-
Project Name – o nome do projeto no Workspace. Por predefinição, o nome será o do projeto original.
-
Description – introduza a descrição pretendida para o projeto.
-
Version Control – assinale esta opção para adicionar um projeto local ao VCS incorporado do próprio Workspace (Git). Se esta opção não estiver assinalada, os ficheiros do projeto serão simplesmente armazenados no Workspace para acesso básico e para permitir a partilha com outros apenas para visualização e comentários – um Simple Sync menos formal, por assim dizer. Recomenda-se a ativação do controlo de versões formal, pois assim terá acesso à máxima funcionalidade disponibilizada através do Workspace e da plataforma Altium 365. Esta opção só está disponível se o projeto não estiver atualmente sob controlo de versões.
-
Migrate to Altium 365 Versioned Storage – ative esta opção para migrar um projeto que utiliza um VCS externo para um projeto sob gestão completa do VCS do Workspace. Esse projeto pode então beneficiar das funcionalidades do VCS nativo do Workspace. Esta opção só está disponível se o projeto estiver atualmente sob um VCS externo.
-
Advanced – clique para aceder a uma opção adicional.
-
Folder – este campo é utilizado para especificar onde deve ser criada a pasta do projeto a migrar – dentro da estrutura de pastas do Workspace. O caminho predefinido para novos projetos é especificado na página Admin – Settings – Projects da interface de navegador do Workspace (por predefinição, será Projects\<ProjectName>). Clique em
para abrir a caixa de diálogo Choose Folder, que é uma versão simplificada do Explorer panel, a partir da qual pode navegar e selecionar uma pasta diferente no servidor, se necessário.
Options and Controls of the Make Available On Server Dialog
-
Project Name – o nome do projeto no Workspace. Por predefinição, o nome será o do projeto original.
-
Description – introduza a descrição pretendida para o projeto.
-
Migrate to Altium Versioned Storage – ative esta opção para migrar um projeto que utiliza um VCS externo para um projeto sob gestão completa do VCS do Workspace. Esse projeto pode então beneficiar das funcionalidades do VCS nativo do Workspace. Esta opção só está disponível se o projeto estiver atualmente sob um VCS externo.
-
Advanced – clique para aceder a opções adicionais.
-
Repository – este menu pendente (se presente) apresentará todos os repositórios de design geridos através do Serviço de Controlo de Versões do Workspace e que lhe tenham sido partilhados para utilização. Escolha o repositório onde armazenar o novo projeto e os respetivos ficheiros – existe um único repositório baseado em Git (Versioned Storage) disponível por predefinição.
Está disponível um campo adicional Repository Folder para especificar ou procurar uma pasta de destino alternativa dentro do próprio repositório. Clique em
para abrir a caixa de diálogo Add to Version Control, a partir da qual pode navegar até e criar a estrutura de pastas necessária dentro do repositório.
O menu pendente Repository e o campo Repository Folder só estão presentes 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 design baseado em Git para alojar todos os seus projetos de design 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 as limitações da 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.
-
Folder – este campo é utilizado para especificar onde deve ser criada a pasta do projeto a migrar – dentro da estrutura de pastas do Workspace. O caminho predefinido para novos projetos é especificado na página Admin – Settings – Projects da interface de navegador do Workspace (por predefinição, será Projects\<ProjectName>). Clique em
para abrir a caixa de diálogo Choose Folder, que é uma versão simplificada do Explorer panel, a partir da qual pode navegar e selecionar uma pasta diferente do Workspace, se necessário.
Utilize a caixa de diálogo Make Available Online para alterar o Name do projeto e adicionar uma Description. Por predefinição, o nome será o do projeto original.
Assinale a opção Version Control para adicionar o projeto ao VCS incorporado do próprio Workspace (Git). Quando esta opção não está assinalada (uma opção apenas de Altium 365 Workspace), os ficheiros do projeto serão simplesmente armazenados no Workspace para acesso básico e para permitir a partilha com outros apenas para visualização e comentários – a configuração Simple Sync. Recomenda-se ativar o controlo de versões, pois assim terá acesso à máxima funcionalidade disponibilizada através do Workspace e da plataforma Altium 365. Tenha em conta que a capacidade de espelhar um projeto num Workspace (Simple Sync) só está disponível quando ligado a um Altium 365 Workspace.
Se o projeto local já estiver sob controlo de versões (um repositório de design externo), a opção Migrate to Altium 365 Versioned Storage estará disponível na caixa de diálogo Make Available Online. Saiba mais sobre Moving from External VCS to Workspace Native VCS.
Project Sharing in an Altium 365 Workspace:
Se a opção Version Control estiver desativada – utilizando assim a funcionalidade informal Simple Sync para um projeto local (que não esteja sob VCS externo) – o projeto de design só pode ser editado por uma única pessoa (o proprietário desse projeto, que é quem o disponibilizou no Workspace). A força do Simple Sync surge quando não pretende que mais ninguém edite o seu design, mas pretende tirar partido do paradigma de Partilha Global do Altium 365 e poder partilhar esse design com várias outras pessoas para visualização e comentários.
Quando a opção Version Control está ativada – através da utilização do repositório de design baseado em Git Versioned Storage do Workspace – então o projeto pode ser partilhado com várias pessoas para edição, ou para visualização e comentários.
Clique na ligação Advanced da caixa de diálogo para mostrar o campo Folder. Este campo é utilizado para especificar onde deve ser criada a pasta do projeto espelhado – dentro da estrutura de pastas do Workspace. O caminho predefinido para novos projetos é especificado na página Admin – Settings – Projects da interface de 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.
Com as propriedades para a transição do projeto definidas conforme necessário na Make Available Online caixa de diálogo, clique em OK. Para um projeto que não esteja sob controlo de versões externo e, ao ser disponibilizado online (num Altium 365 Workspace, a opção Version Control estava assinalada), o projeto e os ficheiros serão submetidos e enviados para o repositório de design Versioned Storage do Workspace. O painel Projects passará então a refletir o estado totalmente sincronizado entre o repositório de design do Workspace e o repositório local (cópia de trabalho), conforme indicado pelos ícones
associados. O projeto torna-se um verdadeiro projeto do Workspace – não apenas 'registado' no Workspace, mas efetivamente submetido e sob o controlo de versões do Workspace. Quaisquer alterações feitas ao design têm de ser guardadas (commit/push) novamente no repositório no Workspace.
O projeto disponibilizado no Workspace será inicialmente partilhado com acesso de Leitura/Escrita com o designer que o criou (Owner) e com todos os Administrators do Workspace. Para mais informações sobre como configurar permissões de acesso ao projeto, veja Sharing a Design.
O projeto disponibilizado no Workspace ficará subsequentemente disponível na página Projects da interface do Workspace no browser.
Ao disponibilizar para um Workspace ligado um projeto sob VCS externo, as ligações criadas automaticamente para repositórios VCS externos ficam ocultas na página Data Management – Design Repositories da caixa de diálogo Preferences.
Esta funcionalidade está em Open Beta e fica disponível quando a opção VCS.HideProjectExternalRepositoriesLinks é ativada na caixa de diálogo Advanced Settings.
Limitações ao usar um repositório de controlo de versões externo existente
Como referido anteriormente, os seus designs locais podem já estar a ser acompanhados por um sistema de controlo de versões externo existente (Git, SVN, EPDM, etc.). Ao usar um Altium 365 Workspace, pode continuar a usar esta configuração como anteriormente e simplesmente disponibilizar os designs no seu Workspace, registando-os nesse Workspace – usando a funcionalidade Make Project Available Online.
Neste modo, sempre que fizer alterações a um design e submeter essas alterações para o seu repositório VCS externo, esses dados do design serão espelhados para o Workspace em segundo plano, e todo o processamento necessário será executado como habitual – pré-visualização, where used, etc. No entanto, há algumas limitações a ter em conta:
-
A criação de um novo projeto de design continua a ter de seguir o fluxo anterior, ou seja, é criado manualmente no sistema VCS externo. O projeto é depois registado e espelhado para o Workspace usando a funcionalidade Make Project Available Online.
-
Se forem feitas alterações ao design, mas o commit/push for executado por ferramentas externas em vez de através do Altium Designer, essas alterações não aparecerão no projeto espelhado no Workspace. Isto é corrigido quando o projeto for novamente aberto no Altium Designer, que sincroniza automaticamente o projeto local com a versão espelhada no Workspace. Se as alterações tiverem sido feitas por outro utilizador, então o(s) ficheiro(s) do projeto reaberto(s) aparecerá(ão) como
Out Of Date (
) e pode(m) ser corrigido(s) com o comando Update do controlo de versões.
-
A abertura do projeto por uma segunda pessoa exigirá acesso a esse repositório VCS externo.
-
A gestão de permissões terá de ser configurada/mantida em dois locais – no Workspace e na fonte principal (o repositório VCS externo Git/SVN/etc.).
-
Algumas funcionalidades disponibilizadas através da plataforma Altium 365 só funcionam quando o projeto está sob o sistema nativo de controlo de versões do Workspace. Ao manter o seu projeto num sistema de controlo de versões externo, essas funcionalidades, à medida que forem ficando disponíveis na plataforma, não estarão disponíveis para si. Pode passar de usar o seu VCS externo para o VCS nativo do Workspace – veja a secção seguinte para o procedimento para o conseguir.
Trabalhar com o GitHub
Usar a plataforma GitHub como sistema de controlo de versões externo (VCS) é uma forma popular de alojar e partilhar projetos de design, e os repositórios Git são suportados pelo Altium Designer. Como descrito acima para um Altium 365 Workspace, a configuração existente de VCS externo pode ser sincronizada com (espelhada para) o Workspace, o que lhe permite beneficiar das suas funcionalidades avançadas de gestão de dados e colaboração.
A forma como normalmente trabalha com o próprio GitHub varia consoante as práticas da empresa ou simplesmente as ferramentas Git que tem à sua disposição. Em geral, no entanto, um projeto de design é criado num repositório Git local e depois enviado por Push para um repositório GitHub (remoto), ou um projeto existente é clonado para um repositório local a partir do GitHub. Depois de estar no repositório Git local, o projeto pode ser aberto no Altium Designer para edição – o software reconhecerá e utilizará os repositórios GitHub local/remoto.
Se o projeto baseado em Git for espelhado para um Altium 365 Workspace (Make Project Available Online), o projeto pode ser gerido e utilizado no Altium Designer como qualquer outro projeto armazenado no Workspace. Nesta configuração, o Workspace continua a fornecer todas as vantagens do seu sistema de gestão de projetos e também comunica de forma transparente com o GitHub para executar as principais ações de VCS – commit, push, pull, etc. O Altium Designer solicitará as suas credenciais de início de sessão do GitHub e guardá-las-á para interações futuras com o GitHub.
Tenha em atenção que o Altium Designer não consegue ligar-se automaticamente ao GitHub se a conta GitHub tiver sido configurada para
autenticação de dois fatores.
Protocolos do GitHub
Embora exista uma gama de protocolos de transferência de dados oferecidos pelo VCS Git, o Altium Designer suporta atualmente apenas o protocolo HTTP/HTTPS para ligações entre um repositório Git local e o respetivo repositório principal remoto. Na prática, o protocolo aplicado é definido pelo prefixo do URL especificado para a ligação ao repositório remoto – https://<remote repository>, ssh://<remote repository>, git://<remote repository>, e assim por diante.
O GitHub suporta tanto os protocolos SSH como HTTPS e recomenda a utilização de URLs HTTPS para as ligações.
► Veja Which remote URL should I use? no GitHub para mais informações.
O protocolo HTTPS oferece a vantagem de uma ligação segura que é simples de usar e implementar, enquanto o SSH é mais complexo de gerir – devido à necessidade de chaves públicas e aos requisitos de portas de firewall/proxy – é discutivelmente menos seguro e não oferece a conveniência da autenticação SSO (single sign-on).
De forma semelhante, o protocolo de ligação GIT não é recomendado (nem suportado aqui) devido à sua falta de autenticação e à complexidade de configuração.
Se o seu sistema VCS externo estiver associado a um protocolo diferente de HTTPS, como uma ligação SSH ao GitHub, isso ficará predefinido num repositório que tenha sido clonado a partir do remoto. Como este protocolo é incompatível com o Altium Designer, será apresentado um erro ao tentar integrar o projeto com um Altium Workspace. Para a ligação SSH, ser-lhe-á proposta a tentativa de atualizar esse repositório para usar antes o protocolo de ligação HTTPS suportado (desde que o próprio repositório suporte esse protocolo). Se não tiver a certeza do protocolo de URL remoto usado por um repositório Git local, isso pode ser verificado com o comando git remote – v.
Utilize a interface de linha de comandos Git Bash para verificar a definição do URL remoto de um repositório.
O repositório pode ser reconfigurado para um URL diferente, tal como o protocolo HTTPS para ativar a compatibilidade com o Altium Designer, usando o comando git remote set-url <name> <URL>, em que o prefixo do URL especifica o tipo de protocolo.
Alterar o protocolo do URL de ligação ao repositório remoto e depois confirmar com o comando remote.
Passar de VCS Externo para o VCS Nativo do Workspace
Quando ligado a um Altium 365 Workspace, o Altium Designer também oferece a capacidade de migrate projetos que utilizam um sistema VCS externo para um projeto do Workspace totalmente gerido que aloja os ficheiros de design no seu próprio repositório Git. O projeto de design convertido, que manterá o histórico anterior de commits do VCS, pode então beneficiar das funcionalidades ativadas pelo VCS nativo do Workspace, tais como partilha avançada de projetos, autenticação única e a linha temporal de History baseada em eventos.
A funcionalidade de migração de VCS do projeto suporta sistemas de controlo de versões externos Git e SVN e está disponível ao disponibilizar online um projeto local baseado em ficheiros, ou ao promover um projeto espelhado (apenas sincronizado) para um projeto sob o próprio VCS Git do Workspace.
Para migrar simplesmente um projeto armazenado sob controlo de versões externo, clique com o botão direito no nome do projeto no painel Projects e escolha a opção Make Project Available Online no menu de contexto, ou selecione Project » Make Available Online no menu principal. Na caixa de diálogo Make Available Online seguinte, assinale a opção Migrate to Altium 365 Versioned Storage e confirme a operação (OK).
A opção Migrate to Altium 365 Versioned Storage ativada faz efetivamente com que o repositório VCS externo seja substituído pelo repositório Git do Workspace, converte o projeto para um projeto armazenado e gerido no Altium 365 Workspace e, sempre que possível, transfere também o histórico de commits de versão do VCS externo. Note que, se a opção de migração ficar desmarcada, o projeto é espelhado para o Workspace (a configuração Simple Sync) mantendo o repositório externo como armazenamento VCS.
A migração de VCS também está disponível quando o Altium Designer está ligado a um Enterprise Server Workspace. Neste caso, a opção Migrate to Altium Versioned Storage está disponível na caixa de diálogo Make Available On Server. Note que, se a opção de migração ficar desmarcada, o repositório externo do projeto é mantido como armazenamento VCS (a configuração Simple Sync não é suportada para um Enterprise Server Workspace).
Para converter um projeto VCS local num projeto VCS totalmente gerido no seu Altium 365 Workspace, assinale a opção de migração de VCS ao disponibilizá-lo online.
A caixa de diálogo Migrate Project abrir-se-á e irá avisá-lo de que o projeto será migrado para ficar sob gestão total do VCS do Workspace. Clique no botão Browse para selecionar uma pasta no seu disco rígido onde será criado um novo repositório local do projeto (baseado em git). Clique no botão Migrate para prosseguir com a migração.

A caixa de diálogo Migrate Project
Depois de seguir as instruções, incluindo efetuar um commit final no VCS, o projeto fica agora sob controlo de versões no repositório Git do Workspace. O histórico de commits do VCS externo e os respetivos comentários/mensagens são transferidos para o novo projeto VCS do Workspace, ao qual se pode aceder na vista History do Altium Designer – clique com o botão direito do rato no nome do projeto no painel Projects e selecione o comando History & Version Control » Show Project History.
Quando é migrado, o histórico de commits do VCS externo do projeto (mostrado à esquerda) é transferido para a vista History do Altium Designer (à direita).
Note que, da primeira vez que abrir o Histórico do Projeto após o processo de migração, poderá ver que os dados estão a ser calculados para todos os commits incluídos. O Workspace necessita de algum tempo para processar esses commits e também as diferenças entre eles.
Se o projeto no VCS externo já estiver gerido no Altium 365 Workspace como um projeto espelhado (ficheiros local-servidor sincronizados), os respetivos ficheiros VCS podem ser migrados para o repositório Git nativo do servidor utilizando o comando Migrate to Altium Versioned Storage, que está disponível na vista Project History, na caixa de diálogo Project Options ou no menu de contexto acessível com o botão direito do rato do painel Projects History & Version Control.
Um projeto VCS que foi sincronizado com (espelhado para) o seu Workspace é migrado utilizando a opção Migrate Project to Altium Version Control.
O desempenho da migração é mais rápido quando o VCS externo de origem é baseado em Git – o processo é mais simples porque o VCS do Altium 365 Workspace também é baseado em Git. No caso do SVN, no entanto, a migração pode demorar algum tempo, dependendo do tamanho do repositório e do número de commits que contém.
VCS Migration limitations
-
Git
-
Os repositórios Git que contêm vários projetos PCB são suportados quando ligados a um Altium 365 Workspace. Depois de clicar em OK na caixa de diálogo Make Available Online, ser-lhe-á pedido que escolha os ficheiros a migrar.
-
O ficheiro de projeto (
*.PrjPcb) deve estar localizado na pasta raiz do repositório Git.
-
SVN
-
O protocolo básico SVN
File não é suportado.
-
Se o seu repositório SVN contiver vários projetos, o processo de migração criará novas pastas locais além da cópia de trabalho SVN existente. Isto deve-se ao facto de o armazenamento do Altium 365 Workspace ser baseado em Git, e um repositório Git não poder ser armazenado dentro da cópia de trabalho SVN.
-
Os commits que incluam um ficheiro externo relativo à pasta do projeto podem não ser apresentados, uma vez que o processo de migração reconhece apenas commits na pasta do projeto.
Após a migração bem-sucedida de um projeto VCS externo para o Altium 365 Workspace, a ligação ao repositório externo é removida automaticamente. Esta funcionalidade foi implementada no Altium Designer 23.0. Se o projeto tiver sido disponibilizado no Altium 365 Workspace utilizando uma versão anterior do Altium Designer, poderá aparecer uma entrada para o repositório na página
Data Management - Design Repositories da caixa de diálogo
Preferences. Se for administrador do Workspace, e o repositório não tiver qualquer referência a um projeto do Workspace, o repositório pode ser removido do Workspace selecionando a respetiva entrada e clicando no botão
Remove. Note que, se um projeto tiver sido eliminado de forma lógica (movido para o Lixo), terá de ser eliminado permanentemente para que o repositório que lhe faz referência possa ser removido. O repositório
Versioned Storage do Workspace não pode ser removido.
Colaboração após a Migração
-
Quando um membro da equipa do Workspace migra um projeto para o Altium Versioned Storage, tem de garantir que os outros colaboradores do projeto se ligam ao Workspace da equipa e, em seguida, atualizam as suas cópias locais (de trabalho) do projeto. Isto é indicado no painel Projects pelo ícone
(Out of Date) associado ao ficheiro do projeto e executado através do comando Project » History & Version Control » Update Whole Project.
-
Assim que o projeto migrado tiver sido atualizado, o Altium Designer irá propor a atualização das ligações para o novo repositório através da reconstrução da pasta de trabalho local do projeto. Escolha a opção recomendada na caixa de diálogo Fix version control link para concluir a atualização local do projeto.
-
Note que, se um colaborador do projeto not se ligar ao Workspace da equipa e depois fizer commit de alterações de design no VCS, estas continuarão a ser registadas no repositório externo e, por conseguinte, ficarão dessincronizadas em relação ao projeto VCS migrado no Workspace.
-
Durante a migração, o Altium Designer executa um commit no repositório original para definir uma marca de notificação, de modo a que possa ser reconhecido como tendo sido migrado por outras instâncias do Altium Designer dos membros da equipa.
Manually migrating a project from External VCS to Workspace VCS
Em alguns casos, შეიძლება ser desejável migrar manualmente um projeto que utiliza um repositório VCS externo para um projeto totalmente gerido num Altium Workspace e no seu repositório Git VCS nativo. Isto pode ser feito criando um snapshot do seu projeto, o que o desliga do VCS externo e do Workspace (caso já tenha sido aí disponibilizado), e disponibilizando-o depois novamente no Workspace, mas agora sob o VCS do Workspace – como se estivesse a recomeçar. Para tal, siga o procedimento abaixo:
-
Desligue (remova) o seu projeto do sistema externo de controlo de versões. Isto pode ser feito a partir da ferramenta de interface externa do seu VCS atual, ou através do Altium Designer. Neste último caso, embora existam comandos para remover o projeto do controlo de versões tanto no painel Projects como no painel Storage Manager, a forma mais limpa é utilizar o Project Packager. Utilizar o Project Packager criará um snapshot do seu projeto, sem a carga do controlo de versões e, se tiver disponibilizado anteriormente o projeto no Workspace, removerá as ligações ao projeto no Workspace.
Se já tiver disponibilizado o projeto no Workspace, convém desvinculá-lo como parte do processo de empacotamento. Para isso, na secção Managed Projects da página Zip File Options do assistente Project Packager, certifique-se de que ativa a opção Unlink project from the server during packaging. Isto garantirá que a informação de ligação ao projeto espelhado no Workspace – que se encontra no ficheiro do projeto (*.PrjPcb) – seja removida como parte do processo de empacotamento.
-
Descompacte o seu projeto “limpo” a partir do arquivo Zip criado pelo Project Packager.
-
Abra o projeto no Altium Designer – repare que não está nem gerido (se o estava anteriormente) nem sob controlo de versões. Trata-se, portanto, de um projeto limpo e não gerido.
-
Este passo seguinte só é necessário se já tiver disponibilizado anteriormente o projeto no Workspace. O processo de empacotamento desvinculou o projeto, mas o projeto espelhado no Workspace permanece inalterado. Deve primeiro eliminar o projeto do lado do servidor. Aceda à interface do navegador do Workspace (através da Interface da Plataforma Altium 365). Na página Projects , clique para selecionar o projeto a eliminar, depois clique no controlo
e escolha o comando Delete no menu de contexto.
Se pretender manter a versão mais antiga do projeto no Workspace, deverá mudar-lhe o nome ou mudar o nome da nova instância do projeto ao disponibilizá-la online – conforme melhor se adequar aos seus requisitos.
-
Agora, disponibilize novamente o projeto online no Workspace. Para isso, clique com o botão direito do rato na respetiva entrada no painel Projects e selecione Make Project Available Online no menu de contexto, obtendo acesso à caixa de diálogo Make Available Online. Certifique-se de que ativa a opção Enable Formal Version Control, pois é isso que adiciona o projeto sob o VCS incorporado do próprio Workspace (Git).
Como alternativa ao passo acima, o snapshot do projeto descompactado (ver passo 2, acima) pode ser carregado diretamente para o Workspace utilizando a opção
New – Upload Project disponível na vista
Projects da
interface do navegador do Workspace. O projeto criado dessa forma, disponível para abertura no Altium Designer, fica totalmente gerido pelo Workspace e pelo seu repositório VCS nativo.
Note que o projeto essencialmente reinicia o seu histórico – não é mantido qualquer histórico de versões anterior. Ao utilizar o Project Packager e ao tirar um snapshot do seu design nesse momento, em vez de remover o projeto do controlo de versões, manterá o histórico do projeto anterior ligado ao VCS até esse momento.
Passar do SVN do Workspace para o Git do Workspace
O SVN não é suportado no Altium On-Prem Enterprise Server a partir da versão 7.2. Para evitar as limitações da gestão de um projeto SVN, recomenda-se que os projetos SVN sejam migrados para o repositório Git incorporado do Workspace do Enterprise Server. Isto pode ser feito antes da atualização do servidor, conforme descrito abaixo.
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.
Quando o Altium Designer está ligado a um Workspace Enterprise Server e um projeto de design está armazenado num repositório SVN gerido através do Version Control Service do Workspace, pode migrar este projeto do repositório SVN para o repositório Git incorporado do Workspace (Versioned Storage). Para o fazer, clique com o botão direito do rato na respetiva entrada no painel Projects e selecione o comando History & Version Control » Migrate Project to Altium Versioned Storage no menu de contexto. Em alternativa, clique no botão Migrate to Server Versioned Storage na caixa de diálogo Project Options.
Depois de seguir as instruções, que incluem efetuar um commit final no VCS, o projeto será migrado para o controlo de versões do repositório Git do Workspace.
Controlar a Sincronização do Projeto
Assim que um projeto local é disponibilizado num Altium 365 Workspace, os controlos sobre a sua disponibilidade online e sincronização são fornecidos através do separador General tab da caixa de diálogo Project Options.
Tenha em atenção que o separador General só é apresentado quando o Altium Designer está ligado a um Altium 365 Workspace, e não a um Workspace Enterprise Server.

As opções e os controlos relacionados com a disponibilização online do projeto são apresentados no separador General da caixa de diálogo Project Options.
Utilize a opção disponível na região General do separador para efetuar alterações à descrição do projeto. Isto afeta apenas o projeto espelhado no Workspace.
Na região Online Availability and Synchronization do separador, a opção Version Control reflete o estilo atual de disponibilidade online:
-
Option Enabled – o projeto (e os respetivos ficheiros de origem) é armazenado no VCS nativo do próprio Workspace (Git). Esta é a abordagem recomendada, pois dessa forma terá acesso ao máximo de funcionalidades oferecidas através do Workspace e pela plataforma Altium 365.
-
Option Disabled – os ficheiros do projeto são armazenados no Workspace para acesso básico e para permitir a partilha com outras pessoas apenas para visualização e comentários – a configuração Simple Sync.
Utilize a opção para alternar entre estas duas modalidades conforme pretendido.
Esta opção não está disponível se o projeto estiver armazenado num repositório VCS externo.
Se pretender parar a sincronização entre o seu projeto local e a respetiva versão gerida que foi disponibilizada no Workspace, clique no botão
. A janela Turn off project synchronization será apresentada. Clique na opção Unlink e, em seguida, clique em OK na caixa de diálogo Project Options. O projeto local deixará de estar associado ao projeto no Workspace.
Isto reflete-se no painel Projects panel depois de guardar o projeto local, passando o projeto a ser apresentado no Grupo de Projetos ativo (*.DsnWrk), em vez de surgir como uma entrada no Workspace ativo. É necessário guardar, uma vez que as ligações ao projeto no Workspace são removidas do ficheiro do projeto.
O projeto no Workspace permanece inalterado – não é removido por esta ação.
Pode cortar a ligação entre o seu projeto local e a versão do mesmo disponibilizada no Workspace.
Pode sempre voltar a disponibilizar o projeto local online, como projeto espelhado ou como projeto VCS completo (Version Control). O separador General da caixa de diálogo Project Options apresentará o botão
, através do qual pode aceder à caixa de diálogo Make Available Online.
Se estiver a voltar a disponibilizar online um projeto local depois de ter desativado a sincronização, poderá ter de alterar o nome do projeto. Uma vez que desativar a sincronização não remove o projeto do Workspace, este projeto, com o mesmo nome e localização de pasta, poderá ainda existir. Se precisar de manter o mesmo nome de projeto, a instância anterior do projeto no Workspace pode sempre ser removida.
Um projeto local também pode ser disponibilizado online – no Workspace – a partir do separador General da caixa de diálogo Project Options.