Tornando um projeto existente disponível no Workspace
Num relance
- Saiba como usar a caixa de diálogo Disponibilizar online (Make Available Online) ou Disponibilizar no servidor (Make Available On Server) para configurar os detalhes do projeto e sua pasta no Workspace.
- Entenda as diferenças entre a sincronização simples (Simple Sync) e o controle de versão nativo do Workspace, incluindo visualização, comentários e edição por vários usuários.
- Explore a opção de migrar um projeto com controle de versão externo para o armazenamento com controle de versão nativo do Workspace.
O método recomendado e mais poderoso para trabalhar com projetos é criar um novo projeto diretamente no Workspace conectado. Se você já tiver um projeto, poderá trazê-lo para o seu Workspace disponibilizando-o online e optando por habilitar o controle de versão formal. Em ambos os casos, o projeto será armazenado e gerenciado pelo Sistema de Controle de Versão (VCS) nativo do Workspace. Isso oferece todas as funcionalidades de um projeto ao trabalhar com ele pelo Altium Designer. Ter seu projeto totalmente gerenciado pelo VCS do Workspace é a única maneira de compartilhá-lo com várias pessoas para edição pelo Altium Designer (desde que sejam membros do Workspace) e aproveitar os recursos adicionais da plataforma, como o acompanhamento do histórico e o compartilhamento avançado de projetos.
Para disponibilizar um projeto existente (um projeto local ou um projeto atualmente sob controle de versão externo) no Workspace — seja como um projeto espelhado (Simple Sync) em um Workspace do Altium 365 ou como um projeto sob o controle de versão Git nativo de um Workspace —, abra o projeto normalmente no Altium Designer, clique com o botão direito na entrada dele no painel Projects e selecione Make Project Available Online no menu de contexto para acessar a caixa de diálogo Make Available Online. Ao usar um Workspace do Enterprise Server, o comando Make Project Available on Server abre a caixa de diálogo Make Available On Server.

Disponibilize um projeto local existente no Workspace, essencialmente “registrando-o” no Workspace e criando uma “cópia espelhada” dele.
Opções e controles da caixa de diálogo Make Available Online
-
Project Name – o nome do projeto no Workspace. Por padrão, será usado o nome do projeto original.
-
Description – insira a descrição desejada para o projeto.
-
Version Control – marque esta opção para adicionar um projeto local ao VCS integrado do próprio Workspace (Git). Se esta opção estiver desmarcada, os arquivos do projeto serão apenas armazenados no Workspace para acesso básico e para permitir o compartilhamento com outras pessoas apenas para visualização e comentários — uma espécie de Simple Sync menos formal. É recomendável habilitar o controle de versão formal, pois isso permite acessar o máximo de funcionalidades oferecidas pelo Workspace e pela plataforma Altium 365. Esta opção está disponível apenas se o projeto não estiver atualmente sob controle de versão.
-
Migrate to Altium 365 Versioned Storage – habilite esta opção para migrar um projeto que usa um VCS externo para um projeto totalmente gerenciado pelo VCS do Workspace. Esse projeto poderá então aproveitar os recursos do VCS nativo do Workspace. Esta opção está disponível apenas se o projeto estiver atualmente sob um VCS externo.
-
Advanced – clique para acessar uma opção adicional.
-
Folder – este campo é usado para especificar onde a pasta do projeto que está sendo migrado será criada dentro da 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 em
para abrir a caixa de diálogo Choose Folder, que é uma versão simplificada do painel Explorer, na qual você pode navegar e selecionar outra pasta do servidor, se necessário.
-
Opções e controles da caixa de diálogo Make Available On Server
- Project Name – o nome do projeto no Workspace. Por padrão, será usado o nome do projeto original.
- Description – insira a descrição desejada para o projeto.
- Migrate to Altium Versioned Storage – habilite esta opção para migrar um projeto que usa um VCS externo para um projeto totalmente gerenciado pelo VCS do Workspace. Esse projeto poderá então aproveitar os recursos do VCS nativo do Workspace. Esta opção está disponível apenas se o projeto estiver atualmente sob um VCS externo.
-
Advanced – clique para acessar opções adicionais.
-
Repository – este menu suspenso (se presente) listará todos os repositórios de projetos gerenciados pelo Serviço de Controle de Versão do Workspace 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.Um campo Repository Folder adicional está disponível 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, na qual você pode navegar até a estrutura de pastas necessária dentro do repositório e criá-la.
-
Folder – este campo é usado para especificar onde será criada a pasta do projeto que está sendo migrado, dentro da 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 em
para abrir a caixa de diálogo Choose Folder, que é uma versão simplificada do painel Explorer, na qual você pode navegar e selecionar outra pasta do Workspace, se necessário.
-
Use a caixa de diálogo Make Available Online para alterar o Name do projeto e adicionar uma Description. Por padrão, o nome será o mesmo do projeto original.
Marque a opção Version Control para adicionar o projeto ao VCS integrado (Git) do próprio Workspace. Quando essa opção está desmarcada (opção disponível apenas em um Workspace do Altium 365), os arquivos do projeto serão simplesmente armazenados no Workspace para acesso básico e para permitir o compartilhamento com outras pessoas apenas para visualização e comentários — a configuração Simple Sync. Recomenda-se habilitar o controle de versão, pois isso permite acessar o máximo de funcionalidades oferecidas por meio do Workspace e da plataforma Altium 365. Observe que a capacidade de espelhar um projeto em um Workspace (Simple Sync) está disponível apenas quando há conexão com um Workspace do Altium 365.
Clique no link Advanced da caixa de diálogo para exibir o campo Folder. Este campo é usado para especificar onde será criada a pasta do projeto espelhado, dentro da 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 navegar e selecionar outra pasta do Workspace, se necessário.
Depois de definir as propriedades de transição do projeto conforme necessário na caixa de diálogo Make Available Online , clique em OK. Para um projeto que não esteja sob controle de versão externo, ao disponibilizá-lo on-line (em um Workspace do Altium 365, com a opção Version Control marcada), será feito o commit e o push do projeto e de seus arquivos para o repositório de projetos Versioned Storage do Workspace. O painel Projects passará a refletir o estado de sincronização completa entre o repositório de projetos do Workspace e o repositório local (cópia de trabalho), conforme indicado pelos ícones
associados. O projeto se torna um verdadeiro projeto do Workspace — não apenas “registrado” no Workspace, mas efetivamente incorporado ao repositório e sob o controle de versão do Workspace. Quaisquer alterações feitas no projeto devem ser salvas (por commit/push) de volta no repositório do Workspace.
Limitações ao usar um repositório externo de controle de versão existente
Como mencionado anteriormente, seus projetos locais podem já estar sendo acompanhados por um sistema externo de controle de versão existente (Git, SVN, EPDM etc.). Ao usar um Workspace do Altium 365, você pode continuar usando essa configuração como antes e simplesmente disponibilizar os projetos no Workspace, registrando-os nele por meio do recurso Make Project Available Online.
Nesse modo, sempre que você fizer alterações em um projeto e fizer o commit dessas alterações no repositório VCS externo, os dados desse projeto serão espelhados no Workspace em segundo plano, e todo o processamento necessário será realizado normalmente — pré-visualização, locais de utilização etc. No entanto, há algumas limitações que devem ser consideradas:
- A criação de um novo projeto ainda precisa seguir o fluxo anterior, ou seja, ele deve ser criado manualmente no sistema VCS externo. Em seguida, o projeto é registrado e espelhado no Workspace usando o recurso Make Project Available Online.
-
Se forem feitas alterações no projeto, mas o commit/push for realizado por ferramentas externas em vez de pelo Altium Designer, essas alterações não aparecerão no projeto espelhado no Workspace. Isso será corrigido na próxima vez que o projeto for reaberto 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 usuário, os arquivos do projeto reaberto serão exibidos como
Out Of Date, e essa condição poderá ser corrigida usando o comando de controle de versão Update. - A abertura do projeto por uma segunda pessoa exigirá acesso a esse repositório VCS externo.
- O gerenciamento de permissões precisará ser configurado e mantido em dois lugares — no Workspace e na fonte principal (o repositório VCS externo Git/SVN/etc.).
- Alguns recursos oferecidos pela plataforma Altium 365 funcionam apenas quando o projeto está sob o sistema de controle de versão nativo do Workspace. Ao manter seu projeto em um sistema externo de controle de versão, esses recursos não estarão disponíveis para você à medida que forem disponibilizados na plataforma. Você pode migrar do VCS externo para o VCS nativo do Workspace — consulte a seção a seguir para obter o procedimento.
Trabalhar com o GitHub
Usar a plataforma GitHub como sistema de controle de versão (VCS) externo é uma forma popular de hospedar e compartilhar projetos, e os repositórios Git são compatíveis com o Altium Designer. Conforme descrito acima para um Workspace do Altium 365, a estrutura de VCS externo existente pode ser sincronizada com o Workspace (espelhada nele), permitindo aproveitar seus recursos avançados de gerenciamento de dados e colaboração.
A maneira como você normalmente trabalha com o próprio GitHub varia de acordo com as práticas da empresa ou simplesmente com as ferramentas Git que você tem à disposição. Em geral, porém, um projeto é criado em um repositório Git local e depois enviado (push) para um repositório GitHub (remoto), ou um projeto existente é clonado do GitHub para um repositório local. Uma vez no repositório Git local, o projeto pode ser aberto no Altium Designer para edição — o software reconhecerá e usará os repositórios GitHub local e remoto.
Se o projeto baseado em Git for espelhado em um Workspace do Altium 365 (Make Project Available Online), ele poderá ser gerenciado e editado no Altium Designer como qualquer outro projeto armazenado no Workspace. Nessa configuração, o Workspace continua oferecendo todas as vantagens de seu sistema de gerenciamento de projetos e também se comunica de forma transparente com o GitHub para executar as principais ações de VCS — commit, push, pull etc. O Altium Designer solicitará suas credenciais de login do GitHub e as armazenará para interações posteriores com o GitHub.
Protocolos do GitHub
Embora o VCS Git ofereça vários protocolos de transferência de dados, atualmente o Altium Designer oferece suporte apenas ao protocolo HTTP/HTTPS para conexões entre um repositório Git local e seu repositório principal remoto. Na prática, o protocolo utilizado é definido pelo prefixo da URL especificada para a conexão com o repositório remoto — https://<remote repository>, ssh://<remote repository>, git://<remote repository> e assim por diante.
O GitHub oferece suporte aos protocolos SSH e HTTPS e recomenda o uso de URLs HTTPS para conexões.
► Consulte Qual URL remota devo usar? no GitHub para obter mais informações.
Se o seu sistema VCS externo estiver vinculado a um protocolo diferente de HTTPS, como uma conexão SSH do GitHub, esse protocolo estará predefinido em um repositório clonado do remoto. Como esse protocolo é incompatível com o Altium Designer, um erro será exibido ao tentar integrar o projeto a um Workspace do Altium. No caso da conexão SSH, será oferecida a opção de tentar atualizar esse repositório para usar o protocolo de conexão HTTPS compatível (desde que o próprio repositório ofereça suporte a esse protocolo). Se você não tiver certeza de qual protocolo de URL remota é usado em um repositório Git local, poderá verificá-lo usando o comando git remote – v.
Use a interface de linha de comando do Git Bash para verificar a configuração de URL remota de um repositório.
O repositório pode ser reconfigurado para uma URL diferente, como uma que use o protocolo HTTPS para permitir a compatibilidade com o Altium Designer, usando o comando git remote set-url <name> <URL>, no qual o prefixo da URL especifica o tipo de protocolo.
Alteração do protocolo da URL de conexão com o repositório remoto e posterior confirmação com o comando remote.
Migração de um VCS externo para o VCS nativo do Workspace
Quando conectado a um Workspace do Altium 365, o Altium Designer também permite migrate fielmente projetos que usam um sistema VCS externo para um projeto totalmente gerenciado pelo Workspace, que hospeda os arquivos de projeto em seu próprio repositório Git. O projeto convertido, que manterá o histórico anterior de commits do VCS, poderá então aproveitar os recursos habilitados pelo VCS nativo do Workspace, como o compartilhamento avançado de projetos, a autenticação única e a linha do tempo do histórico baseada em eventos.
O recurso de migração de VCS de projetos oferece suporte aos sistemas externos de controle de versão Git e SVN e está disponível ao disponibilizar on-line um projeto local baseado em arquivos ou ao promover um projeto espelhado (apenas sincronizado) a um projeto sob o VCS Git do próprio Workspace.
Para migrar um projeto armazenado sob controle de versão externo, clique com o botão direito do mouse 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 exibida em seguida, marque a opção Migrate to Altium 365 Versioned Storage e confirme a operação (OK).
A opção Migrate to Altium 365 Versioned Storage habilitada faz com que o repositório VCS externo seja substituído pelo repositório Git do Workspace, converte o projeto em um projeto armazenado e gerenciado no Workspace do Altium 365 e, quando possível, transfere o histórico de commits de versão do VCS externo. Observe que, se a opção de migração permanecer desmarcada, o projeto será espelhado no Workspace (configuração Sincronização simples), mantendo o repositório externo como seu armazenamento de VCS.
Para transferir um projeto com VCS local para um projeto com VCS totalmente gerenciado no seu Workspace do Altium 365, marque a opção de migração de VCS ao disponibilizá-lo on-line.
A caixa de diálogo Migrate Project será aberta e avisará que o projeto será migrado para o gerenciamento completo do VCS do Workspace. Clique no botão Browse para selecionar uma pasta no disco rígido na qual 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
Após seguir as instruções, que incluem a realização de um commit final no VCS, o projeto estará sob controle de versão no repositório Git do Workspace. O histórico de commits do VCS externo e seus comentários/mensagens são transferidos para o novo projeto com VCS do Workspace, que pode ser acessado na visualização History do Altium Designer — clique com o botão direito do mouse no nome do projeto no painel Projects e selecione o comando History & Version Control » Show Project History.
Na migração, o histórico de commits do VCS externo do projeto (mostrado à esquerda) é transferido para a visualização History do Altium Designer (à direita).
Se o projeto em um VCS externo já for gerenciado no Workspace do Altium 365 como um projeto espelhado (arquivos locais e do servidor sincronizados), seus arquivos VCS poderão ser migrados para o repositório Git nativo do servidor usando o comando Migrate to Altium Versioned Storage, disponível na visualização Project History, na caixa de diálogo Project Options ou no menu de contexto acessado com o botão direito do mouse no painel Projects History & Version Control.
Um projeto VCS que foi sincronizado com seu Workspace (espelhado nele) é migrado usando a opção Migrate Project to Altium Version Control.
Colaboração após a migração
-
Quando um membro da equipe do Workspace migra um projeto para o Altium Versioned Storage, ele precisa garantir que os demais colaboradores do projeto se conectem ao Workspace da equipe e, em seguida, atualizem suas cópias locais (de trabalho) do projeto. A necessidade dessa atualização é indicada no painel Projects pelo ícone
(Desatualizado) associado ao arquivo do projeto, e a atualização é realizada pelo comando Project » History & Version Control » Update Whole Project.
- Depois que o projeto migrado for atualizado, o Altium Designer oferecerá a opção de atualizar os vínculos com o novo repositório reconstruindo a 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 do projeto local.
- Observe que, se um colaborador do projeto not se conectar ao Workspace da equipe e depois fizer commits de alterações de projeto no VCS, essas alterações continuarão sendo registradas no repositório externo e, portanto, ficarão fora de sincronia com o projeto VCS migrado para o Workspace.
- Durante a migração, o Altium Designer executa um commit no repositório original para definir uma marca de notificação que permita que as instâncias do Altium Designer dos outros membros da equipe reconheçam que ele foi migrado.
Migração manual de um projeto de um VCS externo para o VCS do Workspace
Em alguns casos, pode ser desejável migrar manualmente um projeto que usa um repositório VCS externo para um projeto totalmente gerenciado em um Workspace da Altium e em seu repositório VCS Git nativo. Isso pode ser feito criando um instantâneo do projeto, o que o desconecta do VCS externo e do Workspace (caso já tenha sido disponibilizado nele), e então disponibilizando-o novamente no Workspace, mas sob o VCS do Workspace — como se estivesse começando do zero. Para isso, siga o procedimento abaixo:
- Desconecte (remova) seu projeto do sistema de controle de versão externo. Isso pode ser feito pela ferramenta de interface externa do seu VCS atual ou pelo Altium Designer. Neste último caso, embora existam comandos para remover o projeto do controle de versão tanto no painel Projects quanto no painel Storage Manager, a maneira mais limpa é usar o Project Packager. O uso do Project Packager criará um instantâneo do seu projeto sem os dados de controle de versão e, se você já tiver disponibilizado o projeto no Workspace, removerá os vínculos com o projeto no Workspace.
- Extraia seu projeto “limpo” do arquivo ZIP criado pelo Project Packager.
- Abra o projeto no Altium Designer — observe que ele não é gerenciado (caso fosse anteriormente) nem está sob controle de versão. Portanto, trata-se de um projeto limpo e não gerenciado.
-
Esta próxima etapa só se aplica se você já tiver disponibilizado o projeto no Workspace. O processo de empacotamento desvinculou o projeto, mas o projeto espelhado no Workspace permanece intacto. Você deve primeiro excluir o projeto do servidor. Acesse a interface do Workspace no navegador (pela interface da plataforma Altium 365). Na página Projects , clique para selecionar o projeto a ser excluído, depois clique no controle
e escolha o comando Delete no menu de contexto.
- Agora disponibilize o projeto online novamente no Workspace. Para isso, clique com o botão direito do mouse na entrada dele no painel Projects e selecione Make Project Available Online no menu de contexto para acessar a caixa de diálogo Make Available Online. Certifique-se de habilitar a opção Habilitar controle de versão formal, pois é ela que adiciona o projeto ao VCS integrado do próprio Workspace (Git).
Migração do SVN do Workspace para o Git do Workspace
Quando o Altium Designer está conectado a um Workspace do Enterprise Server e um projeto é armazenado em um repositório SVN gerenciado pelo Serviço de Controle de Versão do Workspace, você pode migrar esse projeto do repositório SVN para o repositório Git integrado ao Workspace (Versioned Storage). Para fazer isso, clique com o botão direito do mouse na entrada do projeto no painel Projects e selecione o comando History & Version Control » Migrate Project to Altium Versioned Storage no menu de contexto. Como alternativa, clique no botão Migrate to Server Versioned Storage na caixa de diálogo Project Options.
Após seguir as instruções, que incluem realizar um commit final no VCS, o projeto será migrado para o controle de versão do repositório Git do Workspace.
Controle da sincronização do projeto
Depois que um projeto local é disponibilizado em um Workspace, os controles de disponibilidade online e sincronização ficam disponíveis na guia Geral da caixa de diálogo Project Options.

As opções e os controles relacionados à disponibilização do projeto online são apresentados na guia General da caixa de diálogo Project Options.
Use a opção disponível na região General da guia para alterar a descrição do projeto. Isso afeta apenas o projeto no Workspace.
Na região Online Availability and Synchronization da guia, a opção Version Control reflete o modo atual de disponibilidade online:
-
Option Enabled – o projeto (e seus arquivos-fonte) é armazenado no VCS nativo do próprio Workspace (Git). Essa é a abordagem recomendada, pois permite acessar o máximo de funcionalidades oferecidas pelo Workspace e pela plataforma Altium 365.
-
Option Disabled – os arquivos do projeto são armazenados no Workspace para acesso básico e para permitir o compartilhamento com outras pessoas apenas para visualização e comentários – a configuração Simple Sync (somente para um Workspace do Altium 365).
Use a opção para alternar entre esses dois modos conforme desejado.
Se desejar interromper a sincronização entre seu projeto local e a versão dele disponibilizada no Workspace, clique no botão
. A janela Turn off project synchronization será exibida. 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.
Isso é refletido no painel Projects após salvar o projeto local: ele passa a ser apresentado no Grupo de Projetos ativo (*.DsnWrk), em vez de aparecer como uma entrada no Workspace ativo. É necessário salvar, pois os vínculos com o projeto no Workspace são removidos do arquivo do projeto.
O projeto no Workspace permanece inalterado – ele não é removido por essa ação.
Você pode desfazer a conexão entre seu projeto local e a versão dele disponibilizada no Workspace.
Você sempre pode disponibilizar o projeto local online novamente, como um projeto espelhado ou com controle de versão completo via VCS (Version Control). Quando conectado a um Workspace do Altium 365, a guia General da caixa de diálogo Project Options apresentará o botão
, que permite acessar a caixa de diálogo Make Available Online.
Um projeto local também pode ser disponibilizado online – no Workspace – pela guia General da caixa de diálogo Project Options.



