Compile on Linux/es

Vista general
En las distribuciones recientes de Linux, FreeCAD es generalmente fácil de construir, ya que todas las dependencias suelen ser proporcionadas por el administrador de paquetes. Básicamente implica 3 pasos:
 * 1) Obtener el código fuente de FreeCAD
 * 2) Obtener las dependencias o paquetes de los que depende FreeCAD
 * 3) Configurar con  y compilar con

A continuación, encontrará explicaciones detalladas de todo el proceso, algunos build scripts, y las particularidades que puede encontrar. Si encuentras algo incorrecto o desactualizado en el texto de abajo (las distribuciones de Linux cambian a menudo), o si usas una distribución que no está en la lista, discute el tema en el forum, y ayúdanos a corregirlo.





Git
La mejor manera de obtener el código es clonar el repositorio Git de sólo lectura. Para ello se necesita el programa que se puede instalar fácilmente en la mayoría de las distribuciones de Linux. También puede obtenerse en el sitio web oficial.

Git se puede instalar mediante el siguiente comando:

El siguiente comando colocará una copia de la última versión del código fuente de FreeCAD en un nuevo directorio llamado.

Para más información sobre el uso de Git y la contribución de código al proyecto, véase Gestión del código fuente.



Archivo Fuente
También puede descargar el código fuente como un archivo, un archivo o , y descomprimirlo en el directorio deseado.



Obtener las dependencias
Para compilar FreeCAD tienes que instalar las dependencias necesarias mencionadas en Bibliotecas de terceros; los paquetes que contienen estas dependencias están listados abajo para diferentes distribuciones de Linux. Tenga en cuenta que los nombres y la disponibilidad de las bibliotecas dependerán de su distribución particular; si su distribución es antigua, algunos paquetes pueden no estar disponibles o tener un nombre diferente. En este caso, busque en la sección Distribuciones antiguas y no convencionales más abajo.

Una vez que tengas todas las dependencias instaladas, procede a compilar FreeCAD.

Ten en cuenta que el código fuente de FreeCAD tiene un tamaño de unos 500 MB; puede ser tres veces mayor si clonas el repositorio Git con todo su historial de modificaciones. Obtener todas las dependencias puede requerir la descarga de 500 MB o más de nuevos archivos; cuando estos archivos se descomprimen pueden requerir 1500 MB o más de espacio. También ten en cuenta que el proceso de compilación puede generar hasta 1500 MB de archivos adicionales ya que el sistema copia y modifica todo el código fuente. Por lo tanto, asegúrese de tener suficiente espacio libre en su disco duro, al menos 4 GB, cuando intente la compilación.



Debian y Ubuntu
En los sistemas basados en Debian (Debian, Ubuntu, Mint, etc.) es bastante fácil conseguir instalar todas las dependencias necesarias. La mayoría de las bibliotecas están disponibles a través de o del gestor de paquetes Synaptic.

Si ya has instalado FreeCAD desde los repositorios oficiales, puedes instalar sus dependencias de construcción con esta única línea de código en un terminal:

Sin embargo, si la versión de FreeCAD en los repositorios es antigua, las dependencias pueden ser las incorrectas para compilar una versión reciente de FreeCAD. Por lo tanto, comprueba que tienes instalados los siguientes paquetes.

Estos paquetes son esenciales para que cualquier tipo de compilación tenga éxito:
 * , instala los compiladores C y C++, las librerías de desarrollo C y el programa.
 * , herramienta esencial para configurar el código fuente de FreeCAD. También puedes querer instalar y  para una opción gráfica.
 * , herramientas esenciales para producir bibliotecas compartidas.
 * , la utilidad estándar de informes de base normalmente ya está instalada en un sistema Debian, y le permite distinguir mediante programación entre una instalación Debian pura o una variante, como Ubuntu o Linux Mint. No elimine este paquete, ya que muchos otros paquetes del sistema pueden depender de él.

La compilación de FreeCAD utiliza el lenguaje Python, y también se utiliza en tiempo de ejecución como lenguaje de scripting. Si estás usando una distribución basada en Debian el intérprete de Python normalmente ya está instalado.
 * , la herramienta que crea interfaces entre el código C++ y Python.
 * , la herramienta que crea interfaces entre el código C++ y Python.

Por favor, comprueba que tienes instalado Python 3. Python 2 quedó obsoleto en 2019, por lo que los nuevos desarrollos en FreeCAD no se prueban con esta versión del lenguaje.

Es necesario instalar las bibliotecas Boost:



Es necesario instalar las bibliotecas de Coin:
 * , para Debian Jessie, Stretch, Ubuntu 16.04 a 18.10, o
 * , para Debian Buster, Ubuntu 19.04 y más recientes, así como para Ubuntu 18.04/18.10 con los PPAs freecad-stable/freecad-daily añadidos a sus fuentes de software.

Varias bibliotecas que se ocupan de las matemáticas, las superficies trianguladas, la ordenación, las mallas, la visión por ordenador, las proyecciones cartográficas, la visualización 3D, el sistema de ventanas X11, el análisis sintáctico de XML y la lectura de archivos Zip:


 * or
 * or
 * or
 * or
 * or
 * or
 * or
 * or



Python 2 y Qt4
Esto no se recomienda para las instalaciones más recientes, ya que tanto Python 2 como Qt4 están obsoletos. A partir de la versión 0.20, FreeCAD ya no los soporta.

Para compilar FreeCAD para Debian Jessie, Stretch, Ubuntu 16.04, usando Python 2 y Qt4, instala las siguientes dependencias.





Python 3 y Qt5
Para compilar FreeCAD para Debian Buster, Ubuntu 19.04 y posteriores, así como Ubuntu 18.04/18.10 con el freecad-stable/freecad-daily PPAs añadido a sus fuentes de software, instale las siguientes dependencias.


 * (if compiling 0.20 on a machine that still has Qt4)
 * (if compiling 0.20 on a machine that still has Qt4)
 * (if compiling 0.20 on a machine that still has Qt4)



Núcleo OpenCascade
El núcleo de OpenCascade es el núcleo de la biblioteca de gráficos para crear formas 3D. Existe una versión oficial OCCT, y una versión comunitaria OCE. La versión de la comunidad ya no se recomienda, ya que está obsoleta.

Para Debian Buster y Ubuntu 18.10 y posteriores, así como para Ubuntu 18.04 con el freecad-stable/freecad-daily PPAs añadido a sus fuentes de software, instale los paquetes oficiales.



Para Debian Jessie, Stretch, Ubuntu 16.04 y posteriores, instale los paquetes de la edición comunitaria.



Puede instalar las bibliotecas individualmente, o utilizando la expansión de asterisco. Cambie por  si desea instalar las bibliotecas comunitarias.



Paquetes opcionales
Opcionalmente, también puede instalar estos paquetes adicionales:
 * , para que Coin soporte formatos de archivo de imagen adicionales.
 * y (o  para los sistemas más antiguos), si quieres generar documentación del código fuente.
 * , para soporte de Dispositivos de entrada 3D, como el "Space Navigator" o el "Space Pilot" de 3Dconnexion.
 * , si pretende registrar los archivos instalados en el gestor de paquetes de su sistema, para poder desinstalarlo más tarde.



Comando único para Python 3 y Qt5
Requiere Pyside2 disponible en Debian buster y el freecad-stable/freecad-daily PPAs.

NOTA: En algunas versiones de Ubuntu y algunas versiones de Qt, obtendrá un error de que no se puede encontrar python3-pyside2uic - en esos sistemas puede omitirlo con seguridad. En Ubuntu 20.04 tendrá que añadir. Puede encontrar más información en esta discusión del foro.



Comando único para Python 2 y Qt4
Esto no se recomienda para las instalaciones más recientes, ya que tanto Python 2 como Qt4 están obsoletos.

Los usuarios de Ubuntu 16.04 por favor vean también la discusión de compilación en el foro: Compilación en Linux (Kubuntu): CMake no puede encontrar VTK.

Raspberry Pi
Siga los mismos pasos que en Debian y Ubuntu.

Hay problemas reportados cuando se intenta compilar en Raspbian con Python 3 y Qt5, pero la combinación Python 3 y Qt4 parece funcionar para versiones antiguas de FreeCAD.

Para las nuevas versiones de FreeCAD la compilación con Py3/Qt5 tiene éxito si el sistema operativo instalado es Ubuntu 20.04.

Debido a diferentes problemas con Qt, en esta versión no se encontrarán las herramientas normales de PySide.

En este caso, podemos instalar los paquetes desde PyQt y crear enlaces simbólicos a las herramientas necesarias.

Ahora la compilación puede continuar.

La opción de  no debe ser más de 3 porque la Raspberry Pi tiene memoria limitada. Tardará varias horas en compilar, por lo que es mejor hacerlo durante la noche.

Más información, FreeCAD y Raspberry Pi 4.

Fedora
There is a bug in cmake distributed by Fedora 34/35 which results in cmake failing to find the opencascade libraries. This can easily be fixed by making one minor change to the top level cmake file of opencascade installed on Fedora. Details here: https://bugzilla.redhat.com/show_bug.cgi?id=2083568.

Near the top of the file, change the following line to use. This fixes a bug introduced by the use of a symlink from to  of Fedora, which causes cmake to fail.

This file is usually installed in.

change this to:

This trivial change needs to be made inside the build directory once cmake has been run and failed. Re-running cmake will then correctly detect the OCCT libraries in the normal way.

Necesita los siguientes paquetes :


 * gcc-c++ (or possibly another C++ compiler?)
 * cmake
 * doxygen
 * swig
 * gettext
 * dos2unix
 * desktop-file-utils
 * libXmu-devel
 * freeimage-devel
 * mesa-libGLU-devel
 * opencascade-devel
 * openmpi-devel
 * python3
 * python3-devel
 * python3-pyside2
 * python3-pyside2-devel
 * pyside2-tools
 * boost-devel
 * tbb-devel
 * eigen3-devel
 * qt-devel
 * qt5-qtwebengine-devel
 * qt5-qtxmlpatterns
 * qt5-qtxmlpatterns-devel
 * qt5-qtsvg-devel
 * qt5-qttools-static
 * ode-devel
 * xerces-c
 * xerces-c-devel
 * opencv-devel
 * smesh-devel
 * Coin3
 * Coin3-devel

(Abril 2021, Coin4 y Coin4-devel están disponibles ) (si coin2 es el último disponible para su versión de Fedora, utilice los paquetes de http://www.zultron.com/rpm-repo/)


 * SoQt-devel
 * freetype
 * freetype-devel
 * vtk
 * vtk-devel
 * med
 * med-devel

Y opcionalmente:


 * libspnav-devel (para el soporte de dispositivos 3Dconnexion como el Space Navigator o el Space Pilot)
 * python3-pivy ( https://bugzilla.redhat.com/show_bug.cgi?id=458975 Pivy no es obligatorio pero es necesario para el módulo Borrador)

To install all dependencies at once (tested on fedora 36 and 37):

Gentoo
La forma más fácil de comprobar qué paquetes son necesarios para compilar FreeCAD es comprobarlo a través de portage:

emerge -pv freecad

Esto debería dar una buena lista de paquetes adicionales que necesitas instalar en tu sistema.

Si FreeCAD no está disponible en Portage, está disponible en waebbl overlay. El rastreador de problemas en el Github de la superposición waebbl puede ayudar a guiar a través de algunos problemas que puede encontrar. El overlay proporciona freecad-9999, que puedes elegir para compilar, o simplemente usar para obtener las dependencias.

layman -a waebbl

Tumbleweed
Los siguientes comandos instalarán los paquetes necesarios para construir FreeCAD con Qt5 y Python 3.

El siguiente comando instalará Qt Creator y el depurador de proyectos GNU.

Si falta algún paquete, puedes comprobar el archivo Tumbleweed "FreeCAD.spec" en el Open Build Service.

Además, compruebe si hay algún parche que deba aplicar (como 0001-find-openmpi2-include-files.patch).

Leap
Si hay una diferencia entre los paquetes disponibles en Tumbleweed y Leap, entonces puedes leer el archivo Leap "FreeCAD.spec" en el Open Build Service para determinar los paquetes necesarios.

Ver piano_jonas guía no oficial "Compilar en openSUSE".

Arch Linux
Necesitará las siguientes bibliotecas de los depósitos oficiales:


 * boost
 * curl
 * desktop-file-utils
 * glew
 * hicolor-icon-theme
 * jsoncpp
 * libspnav
 * opencascade
 * shiboken2
 * xerces-c
 * pyside2
 * python-matplotlib
 * python-netcdf4
 * python-packaging
 * qt5-svg
 * qt5-webengine
 * cmake
 * eigen
 * git
 * gcc-fortran
 * pyside2-tools
 * swig
 * qt5-tools
 * shared-mime-info
 * coin
 * python-pivy
 * med

<span id="Older_and_non-conventional_distributions">

Distribuciones antiguas y no convencionales
En otras distribuciones, tenemos muy pocos comentarios de los usuarios, por lo que podría ser más difícil encontrar los paquetes necesarios.

Intente primero localizar las bibliotecas necesarias mencionadas en bibliotecas de terceros en su gestor de paquetes. Tenga en cuenta que algunas de ellas pueden tener un nombre de paquete ligeramente diferente; busque, pero también , , , y similares. Si no es posible, intente compilar esas bibliotecas usted mismo.

FreeCAD requiere una versión del compilador GNU g++ igual o superior a la 3.0.0, ya que FreeCAD está escrito principalmente en C++. Durante la compilación se ejecutan algunos scripts de Python, por lo que el intérprete de Python tiene que funcionar correctamente. Para evitar cualquier problema con el enlazador también es una buena idea tener las rutas de las bibliotecas en la variable o en el archivo. Esto ya se hace en las distribuciones modernas de Linux, pero puede ser necesario configurarlo en las más antiguas.

Pivy
Pivy (envoltorios de Python para Coin3d) no es necesario para construir FreeCAD o para iniciarlo, pero es necesario como una dependencia en tiempo de ejecución por el Ambiente de Trabajo Borrador. Si no vas a utilizar este ambiente de trabajo, no necesitarás Pivy. Sin embargo, ten en cuenta que el Ambiente de Trabajo Borrador es utilizado internamente por otros ambientes de trabajo, como Arquitectura y BIM, por lo que Pivy necesita ser instalado para utilizar estos ambientes de trabajo también.

En noviembre de 2015 la versión obsoleta de Pivy incluida con el código fuente de FreeCAD ya no compilará en muchos sistemas. Esto no es un gran problema ya que normalmente deberías obtener Pivy desde el gestor de paquetes de tu distribución; si no puedes encontrar Pivy, puede que tengas que compilarlo tú mismo, ver Instrucciones de compilación de Pivy.

<span id="Debug_symbols">

Símbolos de depuración
Para solucionar los fallos en FreeCAD, es útil tener los símbolos de depuración de las bibliotecas de dependencia importantes como Qt. Para ello, intenta instalar los paquetes de dependencia que terminan con, , o similares, dependiendo de tu distribución de Linux.

Para Ubuntu, es posible que tenga que habilitar repositorios especiales para poder ver e instalar estos paquetes de depuración con el gestor de paquetes. Consulte Debug Symbol Packages para obtener más información.

<span id="Compile_FreeCAD">

Compila FreeCAD
FreeCAD utiliza CMake como su principal sistema de compilación, ya que está disponible en los principales sistemas operativos. La compilación con CMake es normalmente muy simple y ocurre en dos pasos.


 * 1) CMake comprueba que todos los programas y bibliotecas necesarios están presentes en tu sistema, y genera un  que se configura para el segundo paso. FreeCAD tiene varias opciones de configuración entre las que elegir, pero viene con unos valores por defecto razonables. Algunas alternativas se detallan a continuación.
 * 2) La compilación propiamente dicha, que se realiza con el programa, que genera los ejecutables de FreeCAD.

Dado que FreeCAD es una aplicación de gran tamaño, la compilación de todo el código fuente puede tardar entre 10 minutos y una hora, dependiendo de tu CPU y del número de núcleos de la CPU utilizados para la compilación.

Puedes construir el código dentro o fuera del directorio de origen. La construcción fuera de la fuente es generalmente la mejor opción.

<span id="Out-of-source_build">

Creación fuera-fuente
Construir en una carpeta separada es más conveniente que construir en el mismo directorio donde se encuentra el código fuente, ya que cada vez que se actualiza el código fuente CMake puede determinar inteligentemente qué archivos han cambiado, y recompilar sólo lo que se necesita. Esto es muy útil cuando se prueban diferentes ramas de Git, ya que no se confunde el sistema de construcción.

Para construir fuera-fuente, simplemente crea un directorio de construcción,, distinto de tu carpeta de fuentes de FreeCAD, ; entonces desde este directorio de construcción apunta a la carpeta de fuentes correcta. Puedes usar o  en lugar de  en las instrucciones de abajo también. Una vez que termine de configurar el entorno, utilice  para iniciar la compilación real.

Nota: si está compilando la rama de lanzamiento 0.19, debe especificar explícitamente que está compilando con Qt5 y Python 3 -- sustituya el comando cMake anterior por:

La opción de  controla cuántos trabajos (archivos) se compilan en paralelo. El programa imprime el número de núcleos de la CPU en su sistema; usándolo junto con la opción  puede elegir procesar tantos archivos como núcleos tenga, para acelerar la compilación general del programa. En el ejemplo anterior, utilizará todos los núcleos de tu sistema excepto dos; esto mantendrá a tu ordenador respondiendo para otros usos mientras la compilación se realiza en segundo plano. El ejecutable de FreeCAD aparecerá finalmente en el directorio. Ver también Compilación (aceleración) para mejorar la velocidad de compilación.

Resolving cmake issues
If you have done an out-of-source build before and get stuck on a dependency that is not recognized or can't seem to be resolved, try the following:


 * Delete the contents of the build directory before running cmake again. FreeCAD is a rapidly moving target, you may be tripping over cached cmake information that points at an older version than the new repository head can use. Clearing the cache may allow cmake to recover and recognize the version you actually need.


 * If cmake complains about missing a specific file, use a tool such as "apt-file search", or its equivalent in other package systems, to discover what package that file belongs to and install it. Bear in mind that you are likely to need the -dev version of the package that carries header or config files files required for FreeCAD to use the package.

Compiling against GNU libc 2.34 and later
GNU libc 2.34 introduces a change to the library that can cause builds on some Linux systems to fail with an error like:

To resolve this, a symbolic link must be manually created from the (now empty) system-installed libdl.so.* to the location your compiler says it is looking for the file. For example (if the actual installed copy of libdl.so on your system is /usr/lib/x86_64-linux-gnu/libdl.so.2):

Adapt the command for the structure of your system by searching for libdl.so* and linking it to the appropriate location.

<span id="In-source_building">

Creación interna fuentes
Las composiciones en fuente están bien si quieres compilar una versión de FreeCAD rápidamente, y no tienes intención de actualizar el código fuente a menudo. En este caso, puedes eliminar el programa compilado y el código fuente simplemente borrando una sola carpeta.

Cambie al directorio fuente, y apunte al directorio actual (denotado por un solo punto):

El ejecutable de FreeCAD residirá entonces en el directorio.

<span id="How_to_repair_your_source_code_directory">

Cómo reparar su directorio de código fuente
Si accidentalmente realizaste una compilación dentro del directorio de código fuente, o agregaste archivos extraños, y quisieras restaurar el contenido a sólo el código fuente original, puedes realizar los siguientes pasos.

La primera línea borra el archivo. Esto asegura que los siguientes comandos de limpieza y reinicio afectarán a todo el directorio y no ignorarán los elementos que coincidan con las expresiones en. La segunda línea borra todos los archivos y directorios que no son rastreados por el repositorio git; luego el último comando restablecerá cualquier cambio en los archivos rastreados, incluyendo el primer comando que borró el archivo.

Si no borra el directorio de fuentes, las siguientes ejecuciones de pueden no capturar las nuevas opciones del sistema si el código cambia.

Configuración
Pasando diferentes opciones a, puedes cambiar cómo se compila FreeCAD. La sintaxis es la siguiente.

Donde es el directorio que contiene el código fuente. El puede omitirse en la mayoría de los casos. El espacio después de la opción también puede omitirse.

Por ejemplo, para evitar construir el Ambiente de trabajo MEF:

Todas las variables posibles están listadas en el archivo, ubicado en el directorio. En este archivo, busque la palabra para llegar a las variables que se pueden establecer, y ver sus valores por defecto.


 * 1) =================   All the options for the build process    =================
 * 1) =================   All the options for the build process    =================

option(BUILD_FORCE_DIRECTORY "The build directory must be different to the source directory." OFF) option(BUILD_GUI "Build FreeCAD Gui. Otherwise you have only the command line and the Python import module." ON) option(FREECAD_USE_EXTERNAL_ZIPIOS "Use system installed zipios++ instead of the bundled." OFF) option(FREECAD_USE_EXTERNAL_SMESH "Use system installed smesh instead of the bundled." OFF) ...

Alternativamente, utilice el comando para listar la configuración actual, y por tanto todas las variables que pueden ser modificadas. También puede instalar y utilizar para lanzar una interfaz gráfica que muestra todas las variables que pueden ser modificadas. En las siguientes secciones enumeramos algunas de las opciones más relevantes que puede querer utilizar.

<span id="For_a_Debug_build">

Para una creación de depuración
Crea una compilación para solucionar fallos en FreeCAD. Ten en cuenta que con esta compilación el Croquizador se vuelve muy lento con croquis complejos.

<span id="For_a_Release_build">

Para una creación de versión
Crea una compilación para probar el código que no se bloquea. Una compilación se ejecutará mucho más rápido que una compilación.

<span id="Building_against_Python_3_and_Qt5">

Creación contra Python 3 y Qt5
Por defecto, FreeCAD 0.19 y anteriores construyen para Python 2 y Qt4. Dado que estos dos paquetes son obsoletos, es mejor construir para Python 3 y Qt5. El soporte para Python 2 y Qt4 se ha eliminado en FreeCAD 0.20 y no es necesario activar explícitamente Qt5 y Python 3 si se compilan las últimas versiones de desarrollo.

Por 0.20_dev:

Tenga en cuenta que al cambiar entre las compilaciones 0.19 y 0.20, puede ser necesario borrar CMakeCache.txt antes de ejecutar cmake.

<span id="Building_for_a_specific_Python_version">

Creación para una versión específica de Python
Si el ejecutable por defecto en tu sistema es un enlace simbólico a Python 2,  intentará configurar FreeCAD para esta versión. Puedes elegir otra versión de Python dando la ruta a un ejecutable específico:

Si eso no funciona, es posible que tenga que definir variables adicionales que apunten a las bibliotecas de Python deseadas y a los directorios de inclusión:

Es posible tener varias versiones independientes de Python en el mismo sistema, por lo que las ubicaciones y números de versión de sus archivos de Python dependerán de su distribución particular de Linux. Utilice para mostrar la versión de Python que está utilizando actualmente; sólo son necesarios los dos primeros números; por ejemplo, si el resultado es, necesita especificar los directorios que se refieren a la versión 3.6. Si no conoce los directorios correctos, intente buscarlos con el comando.

Puede utilizar en un terminal para determinar el directorio, o  para los sistemas Debian.

Some components of FreeCAD, such as PySide, try to autodetect the most recent Python version installed on your system, which might fail if it is different from what you entered above. Adding the following cMake option might solve the issue:

<span id="Building_with_Qt_Creator_against_Python_3_and_Qt5">

Creación con Qt Creator contra Python 3 y Qt5
1. Inicie Qt Creator.

2. Haga clic en.

3. Navega hasta el directorio donde está el código fuente,, y elige el archivo más alto.

4. Al seleccionar el archivo, se ejecutará automáticamente en él, pero puede fallar si las opciones apropiadas no están correctamente configuradas.

5. Vaya a. Establezca el directorio de compilación adecuado,.

6. Establezca las variables apropiadas en el diálogo Clave-Valor, de tipos y.

7. Si las variables no cargan el proyecto correctamente, puede que tenga que ir a. A continuación, pulse, y añada la configuración adecuada como se ha descrito anteriormente. Puede que tenga que añadir más variables sobre las rutas de Python, si no se encuentra el Python del sistema.

7.1. Pulse y luego.

7.2. Asegúrese de que el resto de las opciones están correctamente configuradas, por ejemplo, debe ser una versión presente instalada en el sistema, como.

Pulse y luego  para cerrar la configuración.

El programa debería ejecutarse automáticamente de nuevo, y debería rellenar todo el diálogo Clave-Valor con todas las variables configurables.

8. Vaya a y elija  para compilar la versión gráfica de FreeCAD, o  para compilar sólo la versión de línea de comandos.

9. Finalmente, vaya al menú. Si se trata de una nueva compilación, debería tardar varios minutos, incluso horas, dependiendo del número de procesadores que tengas disponibles.

<span id="Qt_designer_plugin">

Qt designer complemento
Si quieres desarrollar código Qt para FreeCAD, necesitarás el plugin Qt Designer que proporciona todos los widgets personalizados de FreeCAD.

Entra en un directorio auxiliar del código fuente, ejecuta con el archivo de proyecto indicado para crear un ; luego ejecuta  para compilar el plugin.

Si estás compilando para Qt5, asegúrate de que el binario es el correspondiente a esta versión, para que el  resultante contenga la información necesaria para Qt5.

donde es el directorio que almacena las bibliotecas binarias de Qt, por ejemplo,.

La biblioteca creada es, que debe copiarse en.

<span id="External_or_internal_Pivy">

Pivy externo o interno
Anteriormente, una versión de Pivy estaba incluida en el código fuente de FreeCAD (interno). Si querías usar la copia de Pivy de tu sistema (externo), necesitabas usar <código>-DFREECAD_USE_EXTERNAL_PIVY=1</código>.

El uso de Pivy externo se convirtió en el valor por defecto durante el desarrollo de FreeCAD 0.16, por lo que ya no es necesario configurar esta opción manualmente.

<span id="Doxygen_documentation">

Documentación de Doxygen
Si tienes Doxygen instalado puedes construir la documentación del código fuente. Consulte documentación de origen para obtener instrucciones.

<span id="Additional_documentation">

Documentación adicional
El código fuente de FreeCAD es muy extenso, y con CMake es posible configurar muchas opciones. Aprender a usar CMake completamente puede ser útil para elegir las opciones adecuadas para tus necesidades particulares.
 * CMake Documentación de referencia de Kitware.
 * Cómo construir un proyecto basado en CMake (blog) por Preshing sobre programación.
 * Aprende el lenguaje de scripting de CMake en 15 minutos (blog) por Preshing sobre programación.

<span id="Making_a_debian_package">

Hacer un paquete debian
Si planea construir un paquete Debian a partir de las fuentes, necesita instalar primero ciertos paquetes:

Vaya al directorio de FreeCAD y llame a

Una vez construido el paquete, puede utilizar para comprobar si el paquete contiene errores

*.deb package with checkinstall
The Debian script allows to create a *.deb package that can be installed and removed with the standard  commands. It may need to be installed first (on Ubuntu use ). It's interactive and asks for the required information providing helpful defaults. During the process the package is installed and a *.deb file and a backup archive are created.

It's a good idea to define a name and a short description for the package. The name must be entered to uninstall it again and the desription will be listed by. The default name "build" is not very informative.

Example:

The result is a *.deb file in the freecad-build folder. will install the build by default. This is how you can install or uninstall it:

grep freecad freecad-test1_20220814-1_amd64.deb sudo dpkg -i freecad-test1_20220814-1_amd64.deb  # install dkpg -l

<span id="Updating_the_source_code">

Actualización del código fuente
El sistema CMake permite actualizar de forma inteligente el código fuente, y sólo recompilar lo que ha cambiado, haciendo que las compilaciones posteriores sean más rápidas.

Muévete a la ubicación donde el código fuente de FreeCAD fue descargado por primera vez, y saca el nuevo código:

A continuación, muévete al directorio de compilación donde el código fue compilado inicialmente, y ejecuta especificando el directorio actual (denotado por un punto); luego activa la re-compilación con.

Uninstalling the source code
In case the compiled source code was installed with (for Debian) the files were copied to the  folder into several subfolders. For uninstallation the file can be used. It has been created into the build folder during compilation and contains all installed files. As long as this file exists, the installation can be uninstalled.

Solución de problemas
<span id="For_64_bit_systems">

Para sistemas de 64 bits
Cuando se compone FreeCAD para 64 bits hay un problema conocido con el paquete OpenCASCADE (OCCT) de 64 bits. Para que FreeCAD funcione correctamente puede ser necesario ejecutar el script y establecer  adicionales:

Para los sistemas basados en Debian, esta opción no es necesaria cuando se utilizan los paquetes precompilados de OpenCASCADE porque éstos establecen el adecuado internamente.

<span id="Automatic_build_scripts">

Scripts de creación automática
Aquí está todo lo que necesitas para una construcción completa de FreeCAD. Es un enfoque de un solo script y funciona en una distribución de Linux recién instalada. Los comandos pedirán la contraseña de root para la instalación de paquetes y nuevos repositorios online. Estos scripts deberían funcionar en versiones de 32 y 64 bits. Están escritos para diferentes versiones, pero también es probable que funcionen en una versión posterior con o sin cambios importantes.

Si tienes un script de este tipo para tu distribución preferida, por favor discútelo en el foro de FreeCAD para que podamos incorporarlo.

Ubuntu
Estos scripts proporcionan una forma fiable de instalar el conjunto correcto de dependencias necesarias para construir y ejecutar FreeCAD en Ubuntu. Hacen uso de los archivos de paquetes personales de Ubuntu (PPA), y deberían funcionar en cualquier versión de Ubuntu a la que se dirija el PPA. El freecad-daily PPA se dirige a versiones recientes de Ubuntu, mientras que el freecad-stable PPA se dirige a las versiones oficialmente soportadas de Ubuntu.

Este script instala la instantánea diaria compilada de FreeCAD y sus dependencias. Añade el repositorio diario, obtiene las dependencias para construir esta versión, e instala los paquetes necesarios. Después procede a sacar el código fuente en un directorio particular, crea un directorio de compilación y cambia en él, configura el entorno de compilación con, y finalmente construye el programa completo con. Guarda el script en un archivo, hazlo ejecutable y ejecútalo, pero no utilices ; se pedirán privilegios de superusuario sólo para los comandos seleccionados. Pulsa "CTRL-ENTER" para cambiar de canal, "ALT-SHIFT-D" para subir, "ALT-SHIFT-B" para hacer un resumen, o pulsa "ALT" para hacer otros comandos.

Si lo deseas, puedes desinstalar la versión precompilada de FreeCAD dejando las dependencias en su lugar, sin embargo, dejar este paquete instalado permitirá al gestor de paquetes mantener sus dependencias actualizadas también; esto es sobre todo útil si tienes la intención de seguir el desarrollo de FreeCAD, y actualizar y compilar constantemente las fuentes desde el repositorio Git.

El script anterior asume que quieres compilar la última versión de FreeCAD, por lo que estás usando el repositorio "diario" para obtener las dependencias. Sin embargo, puedes obtener las dependencias de la versión "estable" de tu versión actual de Ubuntu. Si este es el caso, reemplace la parte superior del script anterior con las siguientes instrucciones. Para Ubuntu 12.04, omita del comando.

Una vez que instales el paquete desde el repositorio, sustituirá al ejecutable de FreeCAD que está disponible en el repositorio de Universe Ubuntu. El ejecutable se llamará simplemente, y no.

openSUSE
No se necesitan repositorios externos para compilar FreeCAD. Sin embargo, hay una incompatibilidad con python3-devel que debe ser eliminada. FreeCAD puede ser compilado desde GIT

Como estás usando git, la próxima vez que desees compilar no tienes que clonar todo, simplemente tira de git y compila una vez más

Fedora 27/28/29
Enviado por el usuario [PrzemoF] en el foro.

{ echo "~/$MAIN_DIR already exist. Quitting.."; exit; } cd $MAIN_DIR git clone https://github.com/FreeCAD/FreeCAD.git mkdir $BUILD_DIR

<span id="Arch_using_AUR">

Arch usando AUR
Repositorio de usuarios Arch (AUR) es una colección de recetas hechas por el usuario para construir paquetes que no están oficialmente soportados por los mantenedores de la distribución / comunidad. Por lo general, son seguros. Puedes ver quién mantiene el paquete y durante cuánto tiempo lo ha hecho. Se recomienda comprobar los archivos de construcción. También hay software que no es de código abierto disponible en esta área, incluso si es mantenido por la compañía oficial propietaria.

Requisito previo : git

Pasos :
 * 1) Abrir un terminal. Opcionalmente, crear un directorio, por ejemplo, . Opcionalmente, cambiar de directorio, por ejemplo,.
 * 2) Clonar el repositorio AUR :
 * 3) Entrar en la carpeta del repositorio AUR :
 * 4) Compilar usando Arch makepkg : . La bandera -s o --syncdeps también instalará las dependencias necesarias.
 * 5) Instalar el paquete creado : o hacer doble clic en el pkgname-pkgver.pkg.tar.xz dentro de su navegador de archivos.

Para actualizar FreeCAD a la última compilación simplemente repite el paso 3.Actualiza el repo de AUR cuando haya algún cambio de ruptura en la receta o nuevas características usando dentro de la carpeta.