Controle de versão baseado em Git

Os repositórios do tipo Git são criados fora do Altium Designer, e o conteúdo de um repositório Git local de trabalho é acedido abrindo ficheiros a partir da respetiva pasta anfitriã. A gestão de repositórios Git remotos e locais de trabalho é normalmente feita através de sistemas da empresa e de ferramentas Git externas, enquanto as operações ao nível do ficheiro (Commit, Push, Update, etc.) são tratadas no ambiente de edição do Altium Designer.

Adicionar ao Controlo de Versões Git

Como sistema de controlo de versões distribuído, o Git utiliza um fluxo de trabalho diferente do SVN, embora a diferença seja mínima quando se trabalha com ficheiros de projeto já estabelecidos no Altium Designer. Em suma, o Git aplica a transferência de dados entre vários repositórios, em vez de se centrar na dependência de um único repositório de destino.

► Consulte o website do Git para mais informações e Noções Essenciais de Controlo de Versões para uma visão geral dos princípios aplicáveis.

Um sistema Git VCS baseia-se normalmente num servidor Git remoto centralizado, capaz de alojar múltiplos repositórios Git conforme necessário. A natureza rápida e leve do Git favorece a prática de criar um repositório remoto para cada projeto, que pode depois ser clonado (copiado) como repositório de trabalho para qualquer utilizador que esteja a trabalhar no projeto. Os ficheiros atualizados no repositório Git de trabalho de um utilizador são então enviados por ‘push’ para o repositório remoto no servidor Git para se obter sincronização.

O método utilizado para estabelecer um projeto do Altium Designer num sistema Git dependerá da infraestrutura e das práticas da empresa e envolverá ferramentas e processos externos ao Altium Designer. No entanto, depois de um projeto estar no sistema de controlo de versões e disponível como repositório local de trabalho, trabalhar com um Git VCS no Altium Designer é praticamente o mesmo que trabalhar com um SVN VCS.

Adicionar um Projeto ao Git

A título de exemplo, um projeto existente do Altium Designer pode ser adicionado a um repositório Git local utilizando as ferramentas básicas de linha de comandos do Git. Com esta abordagem, a pasta do projeto torna-se o repositório Git local (de trabalho), e este é ligado e, em última análise, atualizado para um repositório Git remoto disponível.

Aqui, as ferramentas são utilizadas para:

1. Criar (inicializar) o repositório Git de trabalho na pasta do projeto.
2. Adicionar os ficheiros do projeto ao controlo de versões Git. A especificação de ficheiro *.* adiciona ficheiros, mas não pastas.
3. Especificar a referência de ligação ao repositório Git remoto partilhado num servidor web. PCrepo é um alias local atribuído ao URL do repositório remoto.

Projeto a ser adicionado a um repositório Git local

Quando o projeto é aberto no Altium Designer, o estado dos seus ficheiros nos painéis Projects e Storage Manager é Scheduled for Addition (). Quando são então submetidos ao repositório de trabalho, os ficheiros passam para o estado Ahead of Server (), uma vez que ainda não estão sob controlo de versões no repositório Git remoto.

Ficheiros agendados como Scheduled for Addition e Ahead of Server

O comando Push irá atualizar os ficheiros do repositório local para o servidor Git remoto, que poderá solicitar credenciais válidas para o repositório de destino – um processo único.

Os ficheiros são atualizados após o pedido de credenciais válidas

O projeto Altium Designer, que agora está totalmente sob controlo de versões Git, fica disponível para outros utilizadores a partir do repositório Git remoto. Outro utilizador pode, por exemplo, clonar o repositório para a sua máquina local e, em última análise, fazer push dos seus ficheiros editados de volta para o repositório remoto num fluxo de trabalho colaborativo.

Clonar um Repositório Git

Um projeto local que tenha sido adicionado ao Controlo de Versões Git pode ser editado pelo Altium Designer a partir da pasta local do projeto (o repositório de trabalho), e as alterações submetidas são depois atualizadas para o repositório Git remoto. O repositório local e o repositório remoto estão ligados e acabam por ser sincronizados por um comando Push do VCS.

Outros utilizadores que pretendam colaborar no design podem aceder ao projeto clonando o repositório Git remoto para um repositório local de trabalho. Embora a abordagem para aceder a ficheiros a partir de um repositório Git remoto varie consoante os sistemas e métodos da empresa, uma forma básica de clonar o conteúdo de um repositório remoto para um repositório local de trabalho é utilizar o comando Git; git clone [remote repository URL] [target working repository folder], como mostrado na imagem abaixo.

Alterações submetidas atualizadas para o repositório Git remoto

O processo irá replicar o repositório remoto partilhado como um repositório local de trabalho e fará automaticamente checkout da revisão mais recente (HEAD) a partir do ramo mestre. Os ficheiros podem então ser editados, guardados e submetidos ao VCS no Altium Designer e, por fim, enviados novamente para o repositório Git remoto.

Ligar a um Repositório Git Existente

O Altium Designer não oferece controlos para criar um novo repositório Git ou ligar a um já existente. No entanto, pode ligar-se efetivamente a um repositório existente deste tipo por outros meios (que são a técnica tradicional preferida pelos utilizadores de Git). Para o fazer:

1. Crie o seu repositório Git remoto, ou aceda ao repositório externo da sua empresa – no qual os seus projetos Altium Designer estão armazenados.
2. Clone o repositório para criar o seu repositório Git local de trabalho.
3. Abra um projeto Altium Designer a partir do repositório local.

O Altium Designer reconhecerá que o projeto está sob controlo de versões num repositório baseado em Git, e disponibilizará estados relacionados com VCS, bem como comandos/funções para trabalhar com os ficheiros (incluindo Commit (para o repositório Git local de trabalho) e Push (do repositório Git local para o repositório Git remoto)).