Rendere disponibile un progetto esistente nell'area di lavoro

Updated: October 06, 2026

Il metodo consigliato e più efficace per lavorare con i progetti consiste nel creare un nuovo progetto direttamente nel Workspace connesso. Se hai un progetto esistente, puoi importarlo nel tuo Workspace rendendolo disponibile online e scegliendo di abilitare il controllo di versione formale. In entrambi i casi, il progetto verrà archiviato e gestito tramite il sistema di controllo di versione (VCS) nativo del Workspace. In questo modo potrai usufruire di tutte le funzionalità del progetto quando lavori in Altium Designer. Affidare la gestione completa del progetto al VCS del Workspace è l'unico modo per condividere il progetto con più persone affinché possano modificarlo tramite Altium Designer (purché siano membri del Workspace) e beneficiare delle funzionalità aggiuntive della piattaforma, come il monitoraggio della cronologia e la condivisione avanzata dei progetti.

Un progetto locale che non è sottoposto al controllo di versione o che utilizza un controllo di versione esterno può essere registrato nel tuo Workspace utilizzando una metodologia chiamata Simple Sync. Nel Workspace viene creata e sincronizzata una copia speculare del progetto. Una volta salvate le modifiche ai file locali (oppure salvate e sottoposte a commit nel repository di progettazione esterno), queste vengono sincronizzate automaticamente con i file corrispondenti della copia speculare nel Workspace. Simple Sync ti consente di usufruire delle funzionalità di collaborazione disponibili tramite la piattaforma Altium 365 mantenendo il progetto originale esattamente dove si trova. Tuttavia, tieni presente che un progetto di progettazione locale (non gestito da un VCS esterno) può essere modificato da una sola persona (il proprietario del progetto, ossia chi lo ha reso disponibile online nel Workspace).

Per rendere disponibile nel Workspace un progetto esistente (un progetto locale o un progetto attualmente sottoposto a controllo di versione esterno), come progetto con copia speculare (Simple Sync) in un Workspace Altium 365 oppure come progetto gestito dal controllo di versione Git nativo del Workspace, apri il progetto come di consueto in Altium Designer, quindi fai clic con il pulsante destro del mouse sulla relativa voce nel pannello Projects e seleziona Make Project Available Online dal menu contestuale per accedere alla finestra di dialogo Make Available Online. Quando utilizzi un Workspace Enterprise Server, il comando Make Project Available on Server apre la finestra di dialogo Make Available On Server.

Quando sei connesso a un Workspace con una o più definizioni di processo attive per la categoria di processi Project Creations, per rendere disponibile un progetto esistente nel Workspace, fai clic con il pulsante destro del mouse sulla voce del progetto nel pannello Projects e seleziona un comando dal sottomenu Convert to Managed Project – scopri di più sulla conversione dei progetti basata sui processi.

Rendi disponibile nel Workspace un progetto locale esistente, di fatto registrandolo nel Workspace e creandone una copia speculare.

Opzioni e controlli della finestra di dialogo Make Available Online

Project Name – il nome del progetto nel Workspace. Per impostazione predefinita, il nome sarà quello del progetto originale.
Description – inserisci la descrizione desiderata per il progetto.
Version Control – seleziona questa opzione per aggiungere un progetto locale al VCS integrato del Workspace (Git). Se questa opzione non è selezionata, i file del progetto verranno semplicemente archiviati nel Workspace per consentire l'accesso di base e la condivisione con altri utenti esclusivamente per la visualizzazione e l'aggiunta di commenti: una sorta di Simple Sync meno formale. Si consiglia di abilitare il controllo di versione formale, poiché in questo modo avrai accesso al massimo delle funzionalità offerte dal Workspace e dalla piattaforma Altium 365. Questa opzione è disponibile solo se il progetto non è attualmente sottoposto a controllo di versione.
Migrate to Altium 365 Versioned Storage – abilita questa opzione per migrare un progetto che utilizza un VCS esterno a un progetto completamente gestito dal VCS del Workspace. Tale progetto potrà quindi beneficiare delle funzionalità VCS native del Workspace. Questa opzione è disponibile solo se il progetto è attualmente gestito da un VCS esterno.
Advanced – fai clic per accedere a un'ulteriore opzione.
- Folder – questo campo consente di specificare dove creare la cartella del progetto da migrare all'interno della struttura delle cartelle del Workspace. Il percorso predefinito per i nuovi progetti è specificato nella pagina Admin – Settings – Projects dell'interfaccia browser del Workspace (per impostazione predefinita, sarà Projects\<ProjectName>). Fai clic su per aprire la finestra di dialogo Choose Folder, una versione semplificata del pannello Explorer, da cui puoi esplorare e selezionare una cartella del server diversa, se necessario.

Opzioni e controlli della finestra di dialogo Make Available On Server

Project Name – il nome del progetto nel Workspace. Per impostazione predefinita, il nome sarà quello del progetto originale.
Description – inserisci la descrizione desiderata per il progetto.
Migrate to Altium Versioned Storage – abilita questa opzione per migrare un progetto che utilizza un VCS esterno a un progetto completamente gestito dal VCS del Workspace. Tale progetto potrà quindi beneficiare delle funzionalità VCS native del Workspace. Questa opzione è disponibile solo se il progetto è attualmente gestito da un VCS esterno.
Advanced – fai clic per accedere a ulteriori opzioni.
- Repository – questo menu a discesa (se presente) elenca tutti i repository di progettazione gestiti tramite il servizio di controllo di versione del Workspace e condivisi con te per l'utilizzo. Scegli il repository in cui archiviare il nuovo progetto e i relativi file: per impostazione predefinita è disponibile un solo repository basato su Git (Versioned Storage).
  
  È disponibile un ulteriore campo Repository Folder per specificare o individuare una cartella di destinazione alternativa all'interno del repository stesso. Fai clic su per aprire la finestra di dialogo Add to Version Control, da cui puoi esplorare il repository e creare la struttura di cartelle richiesta al suo interno.
  
  Il menu a discesa Repository e il campo Repository Folder sono presenti solo se hai aggiornato Enterprise Server da una versione o da un prodotto server in cui era abilitato l'utilizzo dei repository SVN. In alternativa, Enterprise Server fornisce un unico repository di progettazione basato su Git per ospitare tutti i progetti di progettazione del Workspace e, in questo caso, il menu a discesa Repository non sarà presente.
  
  SVN non è supportato in Altium On-Prem Enterprise Server a partire dalla versione 7.2. Per evitare le limitazioni nella gestione di un progetto SVN, si consiglia di migrare i progetti SVN al repository Git integrato nel Workspace Enterprise Server. Questa operazione può essere eseguita prima di aggiornare il server, come descritto qui.
  
  Per ulteriori informazioni sulla dismissione di SVN in Altium On-Prem Enterprise Server, consulta Articolo della Knowledge Base sulla dismissione di SVN con Altium On-Prem Enterprise Server 7.2.1 .
- Folder – questo campo consente di specificare dove creare la cartella del progetto da migrare all'interno della struttura delle cartelle del Workspace. Il percorso predefinito per i nuovi progetti è specificato nella pagina Admin – Settings – Projects dell'interfaccia browser del Workspace (per impostazione predefinita, sarà Projects\<ProjectName>). Fare clic su per aprire la finestra di dialogo Choose Folder, una versione ridotta del pannello Explorer, da cui è possibile sfogliare e selezionare una cartella diversa del Workspace, se necessario.

Utilizzare la finestra di dialogo Make Available Online per modificare il Name del progetto e aggiungere una Description. Per impostazione predefinita, il nome sarà quello del progetto originale.

Selezionare l'opzione Version Control per aggiungere il progetto al VCS integrato del Workspace (Git). Quando questa opzione è deselezionata (opzione disponibile solo per i Workspace Altium 365), i file del progetto vengono semplicemente archiviati nel Workspace per consentire l'accesso di base e la condivisione con altri utenti esclusivamente per la visualizzazione e i commenti: la modalità Simple Sync. Si consiglia di abilitare il controllo versione, poiché in questo modo si avrà accesso a tutte le funzionalità offerte dal Workspace e dalla piattaforma Altium 365. Si noti che la possibilità di creare una copia speculare di un progetto in un Workspace (Simple Sync) è disponibile solo quando si è connessi a un Workspace Altium 365.

Se il progetto locale è già sotto controllo versione (in un repository di progettazione esterno), l'opzione Migrate to Altium 365 Versioned Storage sarà disponibile nella finestra di dialogo Make Available Online. Per ulteriori informazioni, consultare Passaggio da un VCS esterno al VCS nativo del Workspace.

Project Sharing in an Altium 365 Workspace:

Se l'opzione Version Control è disabilitata, e si utilizza quindi la funzionalità informale Simple Sync per un progetto locale (che non è gestito da un VCS esterno), il progetto può essere modificato da una sola persona: il proprietario del progetto, ovvero colui che lo ha reso disponibile nel Workspace. Il punto di forza di Simple Sync emerge quando non si desidera che altri modifichino il progetto, ma si vuole sfruttare il paradigma di condivisione globale di Altium 365 per condividere il progetto con più persone, consentendo loro di visualizzarlo e aggiungere commenti.

Quando l'opzione Version Control è abilitata, tramite l'utilizzo del repository di progettazione Versioned Storage del Workspace basato su Git, il progetto può essere condiviso con più persone per la modifica oppure per la visualizzazione e l'aggiunta di commenti.

Fare clic sul collegamento Advanced nella finestra di dialogo per visualizzare il campo Folder. Questo campo consente di specificare dove creare la cartella del progetto replicato all'interno della struttura delle cartelle del Workspace. Il percorso predefinito per i nuovi progetti è specificato nella pagina Admin – Settings – Projects dell'interfaccia browser del Workspace (per impostazione predefinita, sarà Projects\<ProjectName>). Fare clic sul pulsante per sfogliare e selezionare una cartella diversa del Workspace, se necessario.

Dopo aver definito le proprietà per il trasferimento del progetto nella finestra di dialogo Make Available Online , fare clic su OK. Per un progetto che non è sotto controllo versione esterno e che viene reso disponibile online (in un Workspace Altium 365, con l'opzione Version Control selezionata), verranno eseguiti il commit e il push del progetto e dei relativi file nel repository di progettazione Versioned Storage del Workspace. Il pannello Projects rifletterà quindi lo stato di completa sincronizzazione tra il repository di progettazione del Workspace e il repository locale (copia di lavoro), come indicato dalle icone associate. Il progetto diventa un vero e proprio progetto del Workspace: non è solo «registrato» nel Workspace, ma ne è stato effettivamente eseguito il commit ed è sotto il controllo versione del Workspace. Qualsiasi modifica apportata al progetto deve essere salvata (tramite commit/push) nel repository del Workspace.

Il progetto reso disponibile nel Workspace sarà inizialmente condiviso con accesso in lettura/scrittura con il progettista che lo ha creato (proprietario) e con tutti gli amministratori del Workspace. Per ulteriori informazioni sulla configurazione delle autorizzazioni di accesso al progetto, consultare Condivisione di un progetto.

Il progetto reso disponibile nel Workspace sarà successivamente accessibile dalla pagina Projects dell'interfaccia browser del Workspace.

Quando si rende disponibile in un Workspace connesso un progetto gestito da un VCS esterno, i collegamenti creati automaticamente ai repository VCS esterni vengono nascosti nella pagina Data Management – Design Repositories della finestra di dialogo Preferences.

Questa funzionalità è in Open Beta ed è disponibile quando l'opzione VCS.HideProjectExternalRepositoriesLinks è abilitata nella finestra di dialogo Advanced Settings.

Limitazioni nell'utilizzo di un repository di controllo versione esterno esistente

Come accennato in precedenza, i progetti locali potrebbero essere già gestiti da un sistema di controllo versione esterno esistente (Git, SVN, EPDM e così via). Quando si utilizza un Workspace Altium 365, è possibile continuare a utilizzare questa configurazione come prima e rendere semplicemente disponibili i progetti nel Workspace registrandoli al suo interno, tramite la funzionalità Make Project Available Online.

In questa modalità, ogni volta che si apportano modifiche a un progetto e se ne esegue il commit nel repository VCS esterno, i dati del progetto vengono replicati nel Workspace in background e tutte le elaborazioni necessarie vengono eseguite come di consueto: anteprima, analisi dei punti di utilizzo e così via. Esistono tuttavia alcune limitazioni da tenere presenti:

La creazione di un nuovo progetto deve comunque seguire il flusso precedente, ovvero il progetto viene creato manualmente nel sistema VCS esterno. Il progetto viene quindi registrato e replicato nel Workspace tramite la funzionalità Make Project Available Online.
Se vengono apportate modifiche al progetto, ma il commit/push viene eseguito con strumenti esterni anziché tramite Altium Designer, tali modifiche non saranno visibili nel progetto replicato nel Workspace. Questo problema viene risolto alla successiva riapertura del progetto in Altium Designer, che sincronizza automaticamente il progetto locale con la versione replicata nel Workspace. Se le modifiche sono state apportate da un altro utente, i file del progetto riaperti risulteranno Out Of Date () e potranno essere aggiornati utilizzando il comando di controllo versione Update.
L'apertura del progetto da parte di una seconda persona richiederà l'accesso al repository VCS esterno.
La gestione dei diritti dovrà essere configurata e mantenuta in due posizioni: nel Workspace e nella fonte principale (il repository VCS esterno Git/SVN/ecc.).
Alcune funzionalità offerte dalla piattaforma Altium 365 funzionano solo se il progetto è gestito dal sistema di controllo versione nativo del Workspace. Mantenendo il progetto sotto un sistema di controllo versione esterno, tali funzionalità non saranno accessibili quando verranno rese disponibili sulla piattaforma. È possibile passare dal VCS esterno al VCS nativo del Workspace: consultare la sezione seguente per la procedura.

Lavorare con GitHub

L'utilizzo della piattaforma GitHub come sistema di controllo versione (VCS) esterno è un metodo diffuso per ospitare e condividere progetti di progettazione; i repository Git sono supportati da Altium Designer. Come descritto sopra per un Workspace Altium 365, la configurazione VCS esterna esistente può essere sincronizzata con il Workspace (mediante mirroring), consentendo di sfruttarne le funzionalità avanzate di gestione dei dati e collaborazione.

Il modo in cui si lavora normalmente con GitHub varia in base alle prassi aziendali o semplicemente agli strumenti Git disponibili. In generale, tuttavia, un progetto viene creato in un repository Git locale e quindi inviato tramite push a un repository GitHub remoto, oppure un progetto esistente viene clonato da GitHub in un repository locale. Una volta presente nel repository Git locale, il progetto può essere aperto in Altium Designer per modificarlo: il software riconoscerà e utilizzerà i repository GitHub locale e remoto.

Se il progetto basato su Git viene replicato in un Workspace Altium 365 (Make Project Available Online), è possibile gestirlo e modificarlo in Altium Designer come qualsiasi altro progetto archiviato nel Workspace. In questa configurazione, il Workspace continua a offrire tutti i vantaggi del proprio sistema di gestione dei progetti e comunica in modo trasparente con GitHub per eseguire le principali operazioni VCS: commit, push, pull e così via. Altium Designer richiederà le credenziali di accesso a GitHub e le conserverà per le interazioni successive.

Si noti che Altium Designer non è in grado di connettersi automaticamente a GitHub se per l'account GitHub è stata configurata l'autenticazione a due fattori.

Protocolli GitHub

Sebbene il VCS Git offra diversi protocolli di trasferimento dati, Altium Designer attualmente supporta solo il protocollo HTTP/HTTPS per le connessioni tra un repository Git locale e il relativo repository principale remoto. In pratica, il protocollo utilizzato è determinato dal prefisso dell'URL specificato per la connessione al repository remoto: https://<remote repository>, ssh://<remote repository>, git://<remote repository> e così via.

GitHub supporta sia il protocollo SSH sia HTTPS e consiglia di utilizzare URL HTTPS per le connessioni.

► Per ulteriori informazioni, consultare Quale URL remoto devo utilizzare? su GitHub.

Il protocollo HTTPS offre il vantaggio di una connessione sicura, semplice da utilizzare e implementare, mentre SSH è più complesso da gestire, per via della necessità di chiavi pubbliche e dei requisiti relativi alle porte di firewall/proxy, è probabilmente meno sicuro e non offre la praticità dell'autenticazione SSO (Single Sign-On).

Analogamente, il protocollo di connessione GIT non è consigliato (né supportato in questo caso) a causa dell'assenza di autenticazione e della complessità di configurazione.

Se il sistema VCS esterno utilizza un protocollo diverso da HTTPS, ad esempio una connessione SSH a GitHub, tale protocollo sarà già impostato in un repository clonato da quello remoto. Poiché questo protocollo è incompatibile con Altium Designer, verrà generato un errore quando si tenta di integrare il progetto con un Workspace Altium. Nel caso di una connessione SSH, verrà proposto di tentare l'aggiornamento del repository affinché utilizzi il protocollo di connessione HTTPS supportato (a condizione che il repository stesso supporti questo protocollo). Se non si è certi del protocollo dell'URL remoto utilizzato per un repository Git locale, è possibile verificarlo con il comando git remote – v.

Utilizzare l'interfaccia a riga di comando Git Bash per verificare l'URL remoto impostato per un repository.

È possibile riconfigurare il repository con un URL diverso, ad esempio con il protocollo HTTPS per renderlo compatibile con Altium Designer, utilizzando il comando git remote set-url <name> <URL>, in cui il prefisso dell'URL specifica il tipo di protocollo.

Modifica del protocollo dell'URL di connessione al repository remoto e successiva verifica con il comando remote.

Passaggio dal VCS esterno al VCS nativo del Workspace

Quando è connesso a un Workspace Altium 365, Altium Designer offre anche la possibilità di migrate fedelmente i progetti che utilizzano un sistema VCS esterno in un progetto del Workspace completamente gestito, che ospita i file di progettazione nel proprio repository Git. Il progetto convertito, che conserva la cronologia precedente dei commit VCS, può quindi beneficiare delle funzionalità native del Workspace basate sul VCS, come la condivisione avanzata dei progetti, l'autenticazione unica e la sequenza temporale della cronologia basata sugli eventi.

La funzionalità di migrazione del VCS dei progetti supporta i sistemi di controllo versione esterni Git e SVN ed è disponibile quando si rende disponibile online un progetto locale basato su file oppure quando si converte un progetto replicato (solo sincronizzato) in un progetto gestito dal VCS Git del Workspace.

Per migrare un progetto archiviato sotto controllo versione esterno, fare clic con il pulsante destro del mouse sul nome del progetto nel pannello Projects e scegliere l'opzione Make Project Available Online dal menu contestuale, oppure selezionare Project » Make Available Online dal menu principale. Nella successiva finestra di dialogo Make Available Online, selezionare l'opzione Migrate to Altium 365 Versioned Storage e confermare l'operazione (OK).

L'attivazione dell'opzione Migrate to Altium 365 Versioned Storage comporta di fatto la sostituzione del repository VCS esterno con il repository Git del Workspace, converte il progetto in un progetto archiviato e gestito nel Workspace Altium 365 e, ove possibile, trasferisce la cronologia dei commit dal VCS esterno. Si noti che, se l'opzione di migrazione non viene selezionata, il progetto viene replicato nel Workspace (configurazione Simple Sync), mantenendo il repository esterno come archivio VCS.

La migrazione del VCS è disponibile anche quando Altium Designer è connesso a un Workspace Enterprise Server. In questo caso, l'opzione Migrate to Altium Versioned Storage è disponibile nella finestra di dialogo Make Available On Server. Si noti che, se l'opzione di migrazione non viene selezionata, il repository esterno del progetto viene mantenuto come archivio VCS (la configurazione Simple Sync non è supportata per un Workspace Enterprise Server).

Per trasferire un progetto VCS locale in un progetto VCS completamente gestito nel Workspace Altium 365, selezionare l'opzione di migrazione VCS quando lo si rende disponibile online.

Si aprirà la finestra di dialogo Migrate Project , che avviserà che il progetto verrà migrato sotto la gestione completa del VCS del Workspace. Fare clic sul pulsante Browse per selezionare una cartella sul disco rigido in cui verrà creato un nuovo repository locale del progetto (basato su Git). Fare clic sul pulsante Migrate per procedere con la migrazione.

La finestra di dialogo Migrate Project

Dopo aver seguito le istruzioni, che includono l'esecuzione di un commit VCS finale, il progetto è ora sotto controllo versione nel repository Git del Workspace. La cronologia dei commit del VCS esterno e i relativi commenti/messaggi vengono trasferiti nel nuovo progetto VCS del Workspace, accessibile nella vista History di Altium Designer: fare clic con il pulsante destro del mouse sul nome del progetto nel pannello Projects e selezionare il comando History & Version Control » Show Project History.

Durante la migrazione, la cronologia dei commit del VCS esterno del progetto (mostrata a sinistra) viene trasferita nella vista History di Altium Designer (a destra).

Si noti che, alla prima apertura della cronologia del progetto dopo la migrazione, potrebbe essere visualizzato un messaggio che indica il calcolo dei dati per tutti i commit inclusi. Il Workspace richiede un po' di tempo per elaborare questi commit e le differenze tra di essi.

Se il progetto VCS esterno è già gestito nel Workspace di Altium 365 come progetto con mirroring (file locali e sul server sincronizzati), i relativi file VCS possono essere migrati al repository Git nativo del server utilizzando il comando Migrate to Altium Versioned Storage, disponibile nella vista Cronologia progetto, nella finestra di dialogo Opzioni progetto o nel menu contestuale del pannello Progetti History & Version Control, accessibile con un clic destro.

Un progetto VCS sincronizzato con il Workspace (tramite mirroring) viene migrato utilizzando l'opzione Migrate Project to Altium Version Control.

La migrazione è più rapida quando il VCS esterno di origine è basato su Git: il processo è più semplice perché anche il VCS del Workspace di Altium 365 è basato su Git. Per SVN, invece, la migrazione può richiedere del tempo, a seconda delle dimensioni del repository e del numero di commit che contiene.

VCS Migration limitations

Git
- I repository Git contenenti più progetti PCB sono supportati quando sono connessi a un Workspace di Altium 365. Dopo aver fatto clic su OK nella finestra di dialogo Make Available Online, verrà chiesto di scegliere i file da migrare.
- Il file di progetto (*.PrjPcb) deve trovarsi nella cartella radice del repository Git.
SVN
- Il protocollo SVN di base File non è supportato.
- Se il repository SVN contiene più progetti, il processo di migrazione creerà nuove cartelle locali oltre alla copia di lavoro SVN esistente. Questo perché lo spazio di archiviazione del Workspace di Altium 365 è basato su Git e un repository Git non può essere memorizzato all'interno della copia di lavoro SVN.
- I commit che includono un file esterno alla cartella del progetto potrebbero non essere visualizzati, poiché il processo di migrazione riconosce solo i commit relativi alla cartella del progetto.

Dopo la corretta migrazione di un progetto VCS esterno al Workspace di Altium 365, il collegamento al repository esterno viene rimosso automaticamente. Questa funzionalità è stata implementata in Altium Designer 23.0. Se il progetto è stato reso disponibile nel Workspace di Altium 365 utilizzando una versione precedente di Altium Designer, nella pagina Gestione dati - Repository di progettazione della finestra di dialogo Preferences potrebbe comparire una voce relativa al repository. Se sei un amministratore del Workspace e il repository non fa riferimento ad alcun progetto del Workspace, puoi rimuoverlo dal Workspace selezionando la relativa voce e facendo clic sul pulsante Remove. Tieni presente che, se un progetto è stato eliminato in modo reversibile (spostato nel Cestino), deve essere eliminato definitivamente per poter rimuovere il repository che vi fa riferimento. Il repository Versioned Storage del Workspace non può essere rimosso.

Collaborazione dopo la migrazione

Quando un membro del team del Workspace ha migrato un progetto ad Altium Versioned Storage, deve assicurarsi che gli altri collaboratori del progetto si connettano al Workspace del team e aggiornino quindi le proprie copie locali (di lavoro) del progetto. La necessità di aggiornamento è indicata nel pannello Projects dall'icona (Non aggiornato) associata al file di progetto; l'aggiornamento viene eseguito tramite il comando Project » History & Version Control » Update Whole Project.
Una volta aggiornato il progetto migrato, Altium Designer proporrà di aggiornare i collegamenti al nuovo repository ricreando la cartella di lavoro locale del progetto. Scegli l'opzione consigliata nella finestra di dialogo Fix version control link per completare l'aggiornamento del progetto locale.

Tieni presente che, se un collaboratore del progetto not si connette al Workspace del team ed esegue poi il commit delle modifiche di progettazione nel VCS, queste continueranno a essere registrate nel repository esterno e risulteranno quindi non sincronizzate con il progetto VCS migrato nel Workspace.
Durante la migrazione, Altium Designer esegue un commit nel repository originale per impostare un contrassegno di notifica, affinché le istanze di Altium Designer degli altri membri del team possano riconoscerlo come migrato.

Migrazione manuale di un progetto da un VCS esterno al VCS del Workspace

In alcuni casi, può essere opportuno migrare manualmente un progetto che utilizza un repository VCS esterno a un progetto completamente gestito in un Workspace Altium e nel relativo repository VCS Git nativo. Per farlo, è possibile creare un'istantanea del progetto, scollegandolo dal VCS esterno e dal Workspace (se già disponibile al suo interno), per poi renderlo nuovamente disponibile nel Workspace, ma sotto il controllo del VCS del Workspace, ripartendo quindi da zero. A tale scopo, segui la procedura riportata di seguito:

Scollega (rimuovi) il progetto dal sistema di controllo versione esterno. Questa operazione può essere eseguita dallo strumento di interfaccia esterno utilizzato per il VCS corrente oppure tramite Altium Designer. In quest'ultimo caso, sebbene siano disponibili comandi per rimuovere il progetto dal controllo versione sia nel pannello Progetti sia nel pannello Gestione archiviazione, il metodo più pulito consiste nell'utilizzare Project Packager. L'utilizzo di Project Packager creerà un'istantanea del progetto senza i dati del controllo versione e, se il progetto è stato precedentemente reso disponibile nel Workspace, rimuoverà i collegamenti al progetto nel Workspace.
Se hai già reso disponibile il progetto nel Workspace, è opportuno scollegarlo durante il processo di creazione del pacchetto. A tale scopo, nell'area Managed Projects della pagina Zip File Options della procedura guidata Project Packager, assicurati di abilitare l'opzione Unlink project from the server during packaging. In questo modo, le informazioni di collegamento al progetto con mirroring nel Workspace, contenute nel file di progetto (*.PrjPcb), verranno rimosse durante la creazione del pacchetto.

Estrai il progetto "ripulito" dall'archivio Zip creato da Project Packager.
Apri il progetto in Altium Designer: noterai che non è né gestito (se lo era in precedenza) né sottoposto al controllo versione. Si tratta quindi di un progetto pulito e non gestito.
Questo passaggio è necessario solo se avevi precedentemente reso disponibile il progetto nel Workspace. Il processo di creazione del pacchetto ha scollegato il progetto, ma il progetto con mirroring nel Workspace è rimasto invariato. È necessario eliminare prima il progetto sul server. Accedi all'interfaccia browser del Workspace (tramite l'interfaccia della piattaforma Altium 365). Dalla pagina Projects , fai clic per selezionare il progetto da eliminare, quindi fai clic sul controllo e scegli il comando Delete dal menu contestuale.
Se desideri mantenere la versione precedente del progetto nel Workspace, puoi rinominarla oppure rinominare la nuova istanza del progetto quando la rendi disponibile online, a seconda delle tue esigenze.

Ora rendi nuovamente disponibile online il progetto nel Workspace. A tale scopo, fai clic destro sulla relativa voce nel pannello Progetti e seleziona Make Project Available Online dal menu contestuale per accedere alla finestra di dialogo Make Available Online. Assicurati di abilitare l'opzione Abilita controllo versione formale, poiché è questa che aggiunge il progetto al VCS integrato del Workspace (Git).
In alternativa al passaggio precedente, l'istantanea del progetto estratta (vedi il passaggio 2 sopra) può essere caricata direttamente nel Workspace utilizzando l'opzione Nuovo – Carica progetto disponibile nella vista Projects dell'interfaccia browser del Workspace. Il progetto così creato, che può essere aperto in Altium Designer, è completamente gestito dal Workspace e dal relativo repository VCS nativo.

Si noti che la cronologia del progetto riparte sostanzialmente da zero: non viene conservata alcuna cronologia delle versioni precedenti. Utilizzando Project Packager e acquisendo un'istantanea del progetto in quel momento, anziché rimuovere il progetto dal controllo versione, si conserva la cronologia del precedente progetto collegato al VCS fino a quel momento.

Passaggio da SVN a Git nel Workspace

SVN non è supportato in Altium On-Prem Enterprise Server a partire dalla versione 7.2. Per evitare le limitazioni nella gestione di un progetto SVN, si consiglia di migrare i progetti SVN nel repository Git integrato del Workspace di Enterprise Server. Questa operazione può essere eseguita prima di aggiornare il server, come descritto di seguito.

Per ulteriori informazioni sulla dismissione di SVN in Altium On-Prem Enterprise Server, consultare l'articolo della Knowledge Base Interruzione del supporto SVN con Altium On-Prem Enterprise Server 7.2.1.

Quando Altium Designer è connesso a un Workspace di Enterprise Server e un progetto è archiviato in un repository SVN gestito tramite il servizio di controllo versione del Workspace, è possibile migrare questo progetto dal repository SVN al repository Git integrato del Workspace (Versioned Storage). A tale scopo, fare clic con il pulsante destro del mouse sulla relativa voce nel pannello Projects e selezionare il comando History & Version Control » Migrate Project to Altium Versioned Storage dal menu contestuale. In alternativa, fare clic sul pulsante Migrate to Server Versioned Storage nella finestra di dialogo Project Options.

Dopo aver seguito le istruzioni, che includono l'esecuzione di un commit finale nel VCS, il progetto verrà migrato al controllo versione del repository Git del Workspace.

Controllo della sincronizzazione del progetto

Una volta reso disponibile un progetto locale in un Workspace, i controlli relativi alla sua disponibilità online e alla sincronizzazione sono accessibili tramite la scheda Generale della finestra di dialogo Project Options.

Le opzioni e i controlli relativi alla disponibilità online del progetto sono presenti nella scheda General della finestra di dialogo Project Options.

Utilizzare l'opzione disponibile nell'area General della scheda per modificare la descrizione del progetto. Questa modifica ha effetto solo sul progetto nel Workspace.

Nell'area Online Availability and Synchronization della scheda, l'opzione Version Control rispecchia la modalità corrente di disponibilità online:

Option Enabled – il progetto e i relativi file sorgente sono archiviati nel VCS nativo del Workspace (Git). Questo è l'approccio consigliato, poiché consente di accedere a tutte le funzionalità offerte dal Workspace e dalla piattaforma Altium 365.
Option Disabled – i file del progetto sono archiviati nel Workspace per consentire l'accesso di base e la condivisione con altri utenti esclusivamente per la visualizzazione e l'inserimento di commenti: la modalità Simple Sync (solo per un Workspace Altium 365).

Utilizzare l'opzione per passare da una modalità all'altra in base alle esigenze.

Questa opzione non è disponibile se il progetto è archiviato in un repository VCS esterno.

Per interrompere la sincronizzazione tra il progetto locale e la sua copia resa disponibile nel Workspace, fare clic sul pulsante . Verrà visualizzata la finestra Turn off project synchronization. Fare clic sull'opzione Unlink , quindi fare clic su OK nella finestra di dialogo Project Options. Il progetto locale non sarà più associato al progetto nel Workspace.

Dopo aver salvato il progetto locale, questa modifica si riflette nel pannello Projects: il progetto viene visualizzato nel gruppo di progetti attivo (*.DsnWrk), anziché come voce nel Workspace attivo. È necessario salvare perché i collegamenti al progetto nel Workspace vengono rimossi dal file di progetto.

Il progetto nel Workspace rimane invariato: questa azione non lo rimuove.

È possibile interrompere il collegamento tra il progetto locale e la sua copia resa disponibile nel Workspace.

È sempre possibile rendere nuovamente disponibile online il progetto locale, come progetto con mirroring o interamente gestito tramite VCS (Version Control). Quando si è connessi a un Workspace Altium 365, nella scheda General della finestra di dialogo Project Options viene visualizzato il pulsante , che consente di accedere alla finestra di dialogo Make Available Online.

Se si rende nuovamente disponibile online un progetto locale dopo aver disattivato la sincronizzazione, potrebbe essere necessario modificare il nome del progetto. Poiché la disattivazione della sincronizzazione non rimuove il progetto nel Workspace, potrebbe essere ancora presente un progetto con lo stesso nome e lo stesso percorso di cartella. Se è necessario mantenere lo stesso nome del progetto, è sempre possibile rimuovere l'istanza precedente del progetto nel Workspace.

Un progetto locale può essere reso disponibile online, nel Workspace, anche dalla scheda General della finestra di dialogo Project Options.

Versione stampabile

Localizzato tramite A

Se trovi un problema, seleziona il testo/l’immagine e premi Ctrl + Enter per inviarci il tuo feedback.

Disponibilità delle funzionalità

Le funzionalità a tua disposizione dipendono dalla soluzione Altium di cui disponi: Altium Develop, Altium Agile Teams, Altium Agile Enterprise oppure Altium Designer (con abbonamento attivo).

Se non vedi una funzionalità documentata nel software che stai effettivamente utilizzando, contatta il reparto vendite di Altium per saperne di più.

Documentazione legacy

La documentazione di Altium Designer non è più suddivisa per versione. Se è necessario accedere alla documentazione delle versioni precedenti di Altium Designer, visitare la sezione Documentazione legacy della pagina Altri programmi di installazione.