Compilazione con Docker

From FreeCAD Documentation
Revision as of 09:36, 8 April 2023 by Simone.b (talk | contribs) (Created page with "Il modo migliore per ottenere il codice sorgente di FreeCAD è clonare il [https://github.com/FreeCAD/FreeCAD repository Git]. Per questo è necessario il programma {{incode|git}} che può essere facilmente installato nella maggior parte delle distribuzioni Linux e Mac OS, e può anche essere ottenuto dal [http://git-scm.com/ sito ufficiale].")

This documentation is not finished. Please help and contribute documentation.

GuiCommand model explains how commands should be documented. Browse Category:UnfinishedDocu to see more incomplete pages like this one. See Category:Command Reference for all commands.

See WikiPages to learn about editing the wiki pages, and go to Help FreeCAD to learn about other ways in which you can contribute.

Presentazione

Tra le opzioni per la compilazione e l'installazione di FreeCAD, c'è la possibilità di utilizzare Docker. Questo metodo è utile principalmente per gli sviluppatori di FreeCAD che utilizzano computer Linux o Mac OS.

Vantaggi

Tutte le dipendenze di FreeCAD sono già installate, compatibili tra loro e configurate in modo appropriato, consentendo di iniziare a sviluppare molto rapidamente.

  • Le dipendenze sono contenute all'interno del contenitore docker, impedendo ad eventuali pacchetti indesiderati di contaminare la tua workstation e prevenendo eventuali conflitti tra versioni.
  • Il codice sorgente e le directory di compilazione sono al di fuori del contenitore docker. Ciò ti consente di utilizzare i tuoi editor preferiti, i sistemi di controllo delle versioni, gli strumenti di sviluppo e così via, senza doverli configurare nel contenitore docker. Puoi semplicemente usarli normalmente, direttamente dalla tua postazione di lavoro. (Inoltre, significa che non è necessario ricostruire il contenitore docker ogni volta che si desidera creare FreeCAD.)
  • Per coloro che usano oscure distribuzioni *nix per le quali le istruzioni non sono disponibili per recuperare le dipendenze, tutto ciò che si deve installare sulla workstation è docker, che è comunemente disponibile in molte distribuzioni.
  • Fornisce un ambiente di sviluppo statico e immutabile. Personalmente lo trovo utile durante lo sviluppo per ridurre il numero di potenziali variabili che potrebbero causare un problema. Si è sicuri di non aver alterato qualcosa di esoterico nell'ambiente tra le build. Per gli sviluppatori che collaborano ed utilizzano lo stesso contenitore docker, si può essere certi di lavorare tutti sullo stesso ambiente, il che riduce gli errori di comunicazione causati dalle differenze nell'ambiente.

Repository Docker

Prerequisiti

  • 10GB di spazio libero
  • Docker

Installazione

Scarica i sorgenti

Il modo migliore per ottenere il codice sorgente di FreeCAD è clonare il repository Git. Per questo è necessario il programma git che può essere facilmente installato nella maggior parte delle distribuzioni Linux e Mac OS, e può anche essere ottenuto dal sito ufficiale.

This will place a copy of the latest version of the FreeCAD source code in a new directory called freecad_source.

git clone https://github.com/FreeCAD/FreeCAD.git ~/my_code/freecad_source

For more information on using Git, and contributing code to the project, see Source code management.

Source archive

Alternatively you can download the source as an archive, a .zip or .tar.gz file, and unpack it in the desired directory.

Creare la cartella di compilazione

Creare una directory per contenere il sorgente di FreeCAD compilato.

mkdir ~/my_code/freecad_build

Inviare l'immagine Docker

Inviare l'immagine Docker. (Immagine ufficiale in arrivo.)

docker pull registry.gitlab.com/daviddaish/freecad_docker_env:latest

Consentire l'accesso al tuo gestore di finestre

In order for FreeCAD to launch it's GUI from within the Docker container, you need to give Docker access permissions to your window manager. In most Linux distributions, this is the X window system. You can use the below command to allow blanket access to X, until you reboot or logoff your computer.

xhost +

If you're connected to any untrusted systems, such as via ssh, this will make you vulnerable to malicious code. Either close any ssh connections, or look into more secure xhost permissions, which is outside the scope of this tutorial.

Utenti Mac OS

For those using Mac OS, the X window system may not be installed. The XQuartz project is a long running open source project that will allow you to add it to your computer. You can find it here.

Lanciare l'immagine the docker

Assign environment variables so the Docker container will mount FreeCAD's source code, and build directory. In addition, you can mount an extra directory to contain any files you'd like to use for testing purposes. In the below snippet, we've left it as your home directory as a simple default.

fc_source=~/my_code/freecad_source
fc_build=~/my_code/freecad_build
other_files=~/

Launch the Docker image.

docker run -it --rm \
-v $fc_source:/mnt/source \
-v $fc_build:/mnt/build \
-v $other_files:/mnt/files \
-e "DISPLAY" -e "QT_X11_NO_MITSHM=1" -v /tmp/.X11-unix:/tmp/.X11-unix:ro \
registry.gitlab.com/daviddaish/freecad_docker_env:latest

Compilare FreeCAD

You can build FreeCAD using the installed build script, or using your preferred method.

/root/build_script.sh

Eseguire FreeCAD

Once FreeCAD has been built, it can be run as normal.

/mnt/build/bin/FreeCAD

You can find the attached directories in the /mnt directory.

Discussioni

Correlazioni