Git-based Version Control

I repository di tipo Git vengono creati al di fuori di Altium Designer e si accede al contenuto di un repository Git locale di lavoro aprendo i file dalla relativa cartella host. La gestione sia dei repository Git remoti sia di quelli locali di lavoro avviene in genere tramite i sistemi aziendali e strumenti Git esterni, mentre le operazioni a livello di file (Commit, Push, Update, ecc.) vengono gestite nell'ambiente di modifica di Altium Designer.

Aggiungi al controllo versione Git

Come sistema di controllo versione distribuito, Git utilizza un flusso di lavoro diverso da quello di SVN, sebbene la differenza sia minima quando si lavora con file di progetto consolidati in Altium Designer. In breve, Git applica il trasferimento dei dati tra più repository, anziché concentrarsi sulla dipendenza da una singola destinazione repository.

► Vedere il sito web di Git per ulteriori informazioni e Version Control Essentials per una panoramica dei principi applicabili.

Un sistema Git VCS si basa tipicamente su un server Git remoto centralizzato che può ospitare più repository Git secondo necessità. La natura rapida e leggera di Git si presta alla pratica di creare un repository remoto per ciascun progetto, che può poi essere clonato (copiato) come repository di lavoro da qualsiasi utente che lavori al progetto. I file aggiornati nel repository Git di lavoro di un utente vengono quindi “pushed” al repository remoto sul server Git per ottenere la sincronizzazione.

Il metodo utilizzato per configurare un progetto Altium Designer in un sistema Git dipenderà dall'infrastruttura e dalle pratiche aziendali e coinvolgerà strumenti e processi esterni ad Altium Designer. Tuttavia, una volta che un progetto è nel sistema di controllo versione ed è reso disponibile come repository locale di lavoro, lavorare con un Git VCS in Altium Designer è praticamente uguale a lavorare con un SVN VCS.

Aggiungere un progetto a Git

A titolo di esempio, un progetto Altium Designer esistente può essere aggiunto a un repository Git locale utilizzando i Git command line tools di base. Con questo approccio, la cartella del progetto diventa il repository Git locale (di lavoro), che viene collegato e infine aggiornato a un repository Git remoto disponibile.

Qui, gli strumenti vengono utilizzati per:

1. Creare (inizializzare) il repository Git di lavoro nella cartella del progetto.
2. Aggiungere i file di progetto al controllo versione Git. La specifica file *.* aggiunge i file ma non le cartelle.
3. Specificare il riferimento di collegamento al repository Git remoto condiviso su un server web. PCrepo è un alias locale assegnato all'URL del repository remoto.

Progetto aggiunto a un repository Git locale

Quando il progetto viene aperto in Altium Designer, lo stato dei relativi file nei pannelli Projects e Storage Manager è Scheduled for Addition (). Quando vengono quindi sottoposti a commit nel repository di lavoro, i file passano allo stato Ahead of Server () poiché non sono ancora sotto controllo versione nel repository Git remoto.

File pianificati come Scheduled for Addition e Ahead of Server

Il comando Push aggiornerà i file del repository locale sul server Git remoto, che potrebbe richiedere credenziali valide per il repository di destinazione: un processo una tantum.

I file vengono aggiornati dopo la richiesta di credenziali valide

Il progetto Altium Designer, ora completamente sotto controllo versione Git, diventa disponibile ad altri utenti dal repository Git remoto. Un altro utente può, ad esempio, clonare il repository sul proprio computer locale e infine inviare con push i file modificati al repository remoto in un flusso di lavoro collaborativo.

Clonare un repository Git

Un progetto locale aggiunto al controllo versione Git può essere modificato da Altium Designer dalla cartella locale del progetto (il repository di lavoro), e le modifiche sottoposte a commit vengono quindi aggiornate nel repository Git remoto. Il repository locale e quello remoto sono collegati e infine sincronizzati da un comando VCS Push.

Altri utenti che desiderano collaborare al progetto possono accedere al progetto clonando il repository Git remoto in un repository locale di lavoro. Sebbene l'approccio per accedere ai file da un repository Git remoto vari in base ai sistemi e ai metodi aziendali, un modo di base per clonare il contenuto da un repository remoto a un repository locale di lavoro consiste nell'usare il comando Git; git clone [remote repository URL] [target working repository folder], come mostrato nell'immagine seguente.

Modifiche sottoposte a commit aggiornate nel repository Git remoto

Il processo replicherà il repository remoto condiviso come repository locale di lavoro ed effettuerà automaticamente il checkout dell'ultima revisione (HEAD) dal branch master. I file potranno quindi essere modificati, salvati e sottoposti a commit nel VCS in Altium Designer, e infine inviati nuovamente con push al repository Git remoto.

Connessione a un repository Git esistente

Altium Designer non offre controlli per creare un nuovo repository Git o connettersi a uno esistente. Tuttavia, è possibile connettersi di fatto a un repository esistente di questo tipo con altri mezzi (che rappresentano la tecnica tradizionale preferita dagli utenti Git). Per farlo:

1. Creare il proprio repository Git remoto oppure accedere al repository esterno della propria azienda, in cui sono archiviati i progetti Altium Designer.
2. Clonare il repository per creare il proprio repository Git locale di lavoro.
3. Aprire un progetto Altium Designer dal repository locale.

Altium Designer riconoscerà che il progetto è sotto controllo versione in un repository basato su Git e fornirà stati relativi al VCS, oltre a comandi/funzioni per lavorare con i file (inclusi Commit (nel repository Git locale di lavoro) e Push (dal repository Git locale al repository Git remoto)).