Rilascio locale

Oltre alla modalità di rilascio gestita (Online), Project Releaser consente anche di effettuare rilasci locali non gestiti (Offline). In genere, questa modalità di rilascio viene utilizzata se non si usa un Workspace o se al momento non è possibile connettersi al proprio Workspace. Sebbene Project Releaser possa determinare automaticamente la modalità quando possibile, oppure proporre delle opzioni quando la scelta non è così netta, è sempre possibile forzare l'utilizzo della modalità Offline. Per farlo, impostare Release Target nella scheda Release Options della finestra di dialogo Project Release Options (fare clic sul pulsante durante la fase 1 del processo di rilascio) su una delle seguenti opzioni:

• Unmanaged - Folder: impostare questa opzione per rilasciare i dati generati in una cartella locale. Il percorso della cartella radice è specificato nella scheda Output Path della finestra di dialogo. Per impostazione predefinita, è impostato su [OutputPath] (utilizzando il percorso definito nel campo Output Path nella scheda Options della finestra di dialogo Project Options).

• Unmanaged - Zip: impostare questa opzione per rilasciare i dati generati in una cartella locale. I dati verranno compressi in un unico file Zip. Il percorso e il nome del file Zip sono specificati nella scheda Output Path della finestra di dialogo. Per impostazione predefinita, sono impostati su [OutputPath][ProjectName].zip (utilizzando il percorso definito nel campo Output Path nella scheda Options della finestra di dialogo Project Options).

È possibile riconoscere rapidamente se Project Releaser è configurato in modalità Offline dai seguenti elementi:

• Il titolo della fase 1 è Configure Local Release, anziché Configure Server Release (come avviene in modalità Online).

• Il titolo della fase 5 è Pack Data, anziché Upload Data (come avviene in modalità Online).

Project Releaser configurato in modalità locale non gestita (Offline).

Il processo di rilascio è molto simile a quello descritto per la modalità di rilascio gestita (Online), ma prevede il rilascio dei dati in cartelle locali. Anziché ripetere le informazioni già descritte, di seguito vengono riepilogate le fasi del processo, evidenziando le differenze.

Fase 1 Offline – Configurazione del rilascio locale

In questa fase si configurano i dati da generare a partire dal progetto. Un rilascio include sempre i dati sorgente e può includere anche dati di fabbricazione, assemblaggio (di base e/o delle varianti) ed eventuali dati personalizzati, secondo necessità.

Per ogni set di dati da generare, è necessario specificare una cartella di destinazione in cui verranno archiviati i dati. I nomi predefiniti delle cartelle vengono utilizzati come segue:

• Source Data – verrà generato nella cartella Sources.

• Fabrication Data (solo per un progetto PCB) – verrà generato nella cartella Fabrication.

• Assembly Data for no variant – verrà generato nella cartella Assembly.

• Assembly Data for <VariantName> (solo per un progetto PCB) – verrà generato nella cartella Assembly <VariantName>.

• Custom Data <Custom - n> – verrà generato nella cartella <Custom - n>.

Naturalmente, è possibile modificare questi nomi predefiniti in base alle proprie esigenze. Per farlo, fare clic su una voce Target Folder esistente, immettere il nuovo nome desiderato per la cartella e premere Enter.

Una volta configurati secondo necessità i set di dati da creare per il rilascio, fare clic sul pulsante in basso a destra nella vista per proseguire.

Il pulsante presenta due stati, che differiscono leggermente tra le due opzioni di rilascio non gestito:

• Unmanaged - Folder: facendo clic sul pulsante si avvia il comando standard Prepare. Il rilascio proseguirà fino alla fase Review Data, consentendo di ricontrollare che tutto sia in ordine prima di rilasciare i dati nelle cartelle di destinazione. Se non si desidera interrompere il processo per la revisione, utilizzare il menu a discesa associato al pulsante e scegliere il comando Prepare & Explore.
• Unmanaged - Zip: facendo clic sul pulsante si avvia il comando standard Prepare. Il rilascio proseguirà fino alla fase Review Data, consentendo di ricontrollare che tutto sia in ordine prima di comprimere i dati nel file Zip. Se non si desidera interrompere il processo per la revisione, utilizzare il menu a discesa associato al pulsante e scegliere il comando Prepare & Pack.

Vengono ora eseguiti diversi controlli preliminari al rilascio, tra cui:

• Verificare che il progetto e tutti i file siano stati salvati.

• Verificare che sia stato eseguito il commit nel VCS del progetto e di tutti i file pertinenti, se applicabile.

• Verificare che a ogni elemento dati abilitato sia stata assegnata una cartella di destinazione.

Se vengono rilevati problemi, verranno proposte soluzioni per risolverli (ad esempio, salvare i file modificati localmente ed eseguire il commit nel VCS).

In questa fase viene generato Source Data, con un'istantanea dei file sorgente del progetto rilasciata nella cartella di destinazione.

Fase 2 Offline – Validazione del progetto

Una volta completata senza problemi la fase 1, questa fase successiva del processo di rilascio viene eseguita automaticamente quando vengono rilevati uno o più report di tipo Validation nei file OutJob assegnati. Vengono eseguiti tutti i generatori di output di validazione definiti in un file Output Job assegnato all'elemento dati in fase di rilascio. Questa fase si svolge allo stesso modo di quando si effettua un rilascio in modalità gestita (Online).

Facendo clic su in basso a destra nella vista, il processo di rilascio verrà interrotto.

Fase 3 Offline – Generazione dei dati

Una volta completata senza problemi la fase 2, questa fase successiva del processo di rilascio viene eseguita automaticamente. In questa fase vengono generati tutti gli altri output, definiti nei file OutJob assegnati agli elementi dati inclusi, per produrre i dati da rilasciare nelle rispettive cartelle di destinazione. Questa fase si svolge allo stesso modo di quando si effettua un rilascio in modalità gestita (Online).

Facendo clic su in basso a destra nella vista, il processo di rilascio verrà interrotto.

Fase 4 Offline – Revisione dei dati

Una volta superati tutti i controlli di validazione e generati i dati di output, questa fase del processo di rilascio consente di esaminare i dati generati. Questa fase si svolge in modo molto simile a quanto avviene durante un rilascio in modalità gestita (Online).

Esamina i dati generati, verificando che tutto sia corretto, prima di confermare il rilascio e inviare i dati alle cartelle di destinazione o comprimerli nel file ZIP locale, in base all'opzione di rilascio non gestito scelta.

Nella vista compatta dei dati generati, fai clic su un collegamento View per aprire il file di dati o il gruppo di file associato, nell'editor appropriato di Altium Designer (ad esempio, l'editor CAM per i file Gerber o i file ODB++ compressi/non compressi) oppure nell'applicazione esterna appropriata (ad esempio, Microsoft Excel per una distinta base). Nella vista dettagliata, fai doppio clic su una voce per visualizzare solo quel file.

Se, dopo aver esaminato i dati, ritieni necessario apportare modifiche, fai clic sul pulsante in basso a destra nella vista. Apparirà una finestra di conferma che ti avvisa che tutti i dati generati andranno persi. Fai clic su OK per annullare il rilascio; tornerai alla fase 1 del processo.

Se tutti i dati generati sono corretti, procedi con il rilascio facendo clic sul pulsante (anch'esso in basso a destra nella vista). Ciò che accade in seguito dipende dall'opzione di destinazione del rilascio che stai utilizzando:

• Unmanaged - Folder: i file generati verranno rilasciati nelle cartelle di destinazione e il processo passerà direttamente all'ultima fase per visualizzare il Report di esecuzione.

• Unmanaged - Zip: il processo passerà alla fase successiva: Pack Data.

Fase offline 5 – Compressione dei dati

Dopo la conferma del rilascio nella fase precedente, si passa automaticamente a questa fase, in cui i dati vengono compressi in un unico file ZIP locale. Il percorso e il nome del file ZIP sono specificati nella scheda Output Path della finestra di dialogo Project Release Options. Per impostazione predefinita, il valore è [OutputPath][ProjectName].zip (utilizzando il percorso definito nel campo Output Path della scheda Options della finestra di dialogo Project Options).

Fase offline 6 – Report di esecuzione

Questa è la fase finale del processo e fornisce un riepilogo del rilascio.

Il report finale del rilascio, così come viene visualizzato quando si utilizza la destinazione di rilascio Unmanaged - Folder. Passa il puntatore sull'immagine per vedere l'equivalente con la destinazione di rilascio impostata su Unmanaged - Zip.

Utilizza il collegamento di navigazione fornito per accedere rapidamente (in Esplora file di Windows) rispettivamente alla cartella di output o al file ZIP compresso.

Accedi rapidamente alla cartella di output dei dati rilasciati localmente, direttamente dalla fase Report di esecuzione dell'interfaccia. Passa il puntatore sull'immagine per vedere un esempio di accesso al file ZIP contenente i dati rilasciati localmente.