How to install additional workbenches/it

Descrizione
Gli utenti esperti hanno esteso FreeCAD con vari ambienti di lavoro esterni personalizzati, che non sono integrati nel codice sorgente di FreeCAD, ma che sono facili da implementare in una distribuzione FreeCAD esistente. Qui sono descritti i metodi di installazione per i diversi sistemi operativi.

a partire dalla versione 0.17, FreeCAD include un Addon Manager nel menu, che permette di installare sia macro che ambienti di lavoro. Le istruzioni seguenti sono necessarie solo si desidera installare manualmente un ambiente. Ciò potrebbe essere necessario se per qualche motivo Addon Manager non funziona ma si ha accesso all'ambiente scaricato come pacchetto.



Installazione in Windows
Come installare ulteriori ambienti e componenti aggiuntivi su Windows

Obsoleto
l'uso di "addons-installer" non è più consigliato. Si consiglia di utilizzare Addon Manager in tutti i sistemi.

Usare addons-installer da Github.

Durante il Google Summer of Code 2016 lo studente Mandeep Singh ha iniziato a lavorare su una versione migliore

(disponibile qui) ma tale versione necessita di ulteriori lavori prima di poter essere completamente integrata in FreeCAD.

Installazione manuale
Dopo l'introduzione di Addon Manager questo metodo è possibile ma non necessario. Tuttavia, queste informazioni potrebbero essere ancora utili per alcuni.


 * Scaricare il workbench da github cliccando sul pulsante o  sulla pagina GitHub (in alto a destra) e scegliendo "Download ZIP"
 * Decomprimere l'archivio scaricato sul disco rigido locale
 * All'interno di FreeCAD, individuare il percorso delle macro scegliendo e vedere quale è il ”Percorso Macro”
 * Supponendo che il vostro login di Windows sia “User-Name” il percorso predefinito delle macro è “C:\User-Name\Appdata\Roaming\FreeCAD”
 * All'interno della directory delle macro creare (se non è ancora presente) una cartella chiamata “”
 * All'interno della cartella Mod creare una cartella con il nome dell'ambiente, ad esempio “Curves”
 * Ora spostare i file decompressi e le sottocartelle del Workbench nella cartella dell'ambiente appena creato
 * Dopo il riavvio di FreeCAD si dovrebbe avere una nuova voce nel menu a discesa selettore degli ambienti

Raccomandazioni aggiuntive per l'aggiornamento degli ambienti

In Windows, durante l'aggiornamento di un ambiente già installato, Windows mantiene il vecchio file .py come .pyc. Dato che questo può causare dei problemi, si consiglia di disinstallare l'ambiente, riavviare FreeCAD e installare la nuova versione.



Installazione in Linux
Come installare ulteriori ambienti e componenti aggiuntivi su Linux

Usando git
Aggiungere il community-ppa al ppa-manager.

Installare gli ambienti tramite il gestore dei pacchetti synaptic.

Ora negli ambienti di FreeCAD ci dovrebbe essere una nuova voce denominata "CurvesWB". Una volta installato, utilizzare git per l'aggiornamento alla versione più recente in questo modo:

Installazione manuale
Dopo l'introduzione di Addon Manager questo metodo è possibile ma non necessario. Tuttavia, queste informazioni potrebbero essere ancora utili per alcuni.


 * Scaricare il workbench da github cliccando sul pulsante o  sulla pagina GitHub (in alto a destra) e scegliendo "Download ZIP"
 * Decomprimere l'archivio scaricato sul disco rigido locale
 * All'interno di FreeCAD, individuare il percorso delle macro scegliendo e vedere quale è il ”Percorso Macro”
 * Per impostazione predefinita, la directory delle macro è la directory (nascosta) nella propria home-directory
 * All'interno della directory delle macro creare (se non è ancora presente) una cartella chiamata “”
 * All'interno della cartella Mod/ creare una cartella con il nome dell'ambiente, ad esempio “Curves”
 * Ora spostare i file decompressi e le sottocartelle del Workbench nella cartella dell'ambiente appena creato
 * Dopo il riavvio di FreeCAD si dovrebbe avere una nuova voce nel menu a discesa nel selettore degli ambienti

Installazione in Mac
Come installare ulteriori ambienti e componenti aggiuntivi su MacOS

Installazione manuale
Dopo l'introduzione di Addon Manager questo metodo è possibile ma non necessario. Tuttavia, queste informazioni potrebbero essere ancora utili per alcuni.

Per questo esempio, supponiamo di aver scelto Curves come ambieente esterno che da installare:
 * Scaricare il repository git come file ZIP
 * Assumendo che FreeCAD sia installato in, andare in con il browser, e selezionare FreeCAD.app
 * Cliccare con il tasto destro del mouse e selezionare "Show Package Contents", appare una nuova scheda denominata "Contents"
 * Fare un singolo clic sulla cartella "Contents" e selezionare la cartella "Mod"
 * Nella cartella "Mod" creare una nuova cartella con il nome "Curves"
 * Decomprimere il repository scaricato nella cartella "Contents/Mod/Curves"



Risoluzione dei problemi generali

 * In Windows non utilizzare i caratteri speciali (ad esempio dieresi tedesca) per il nome utente, altrimenti FreeCAD non riconosce i file e le cartelle nel percorso delle macro.
 * Se è già stato impostato un nome utente con caratteri speciali, creare un nuovo nome utente o puntare il percorso macro a una directory che non utilizzi caratteri speciali.
 * Andare in e assicurarsi che l'ambiente non sia impostato su invisibile.
 * Per i sistemi 32-bit e FreeCAD 0.16.6706, dopo un tentativo di installazione, gli ambienti aggiuntivi potrebbero non essere disponibili. In questo caso
 * tenere aperto il pannello Report mentre si avvia FreeCAD, e leggere l'errore,
 * vedere nel forum questa discussione: Assembly2 in Version: 0.16.5602 (Git)